papilot 0.1.0 → 0.2.0

package/vendor/latex-review/dist/web/index.html

@@ -9,8 +9,8 @@
       rel="icon"
       href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Crect width='16' height='16' rx='3' fill='%232b6e5c'/%3E%3Cpath d='M4 8.5l2.5 2.5L12 5' stroke='white' stroke-width='2' fill='none'/%3E%3C/svg%3E"
     />
-    <script type="module" crossorigin src="/assets/index-HxBK-dls.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-DyzYnIGk.css">
+    <script type="module" crossorigin src="/assets/index-DqkrTw0t.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-Db7pq4Cj.css">
   </head>
   <body>
     <div id="root"></div>

package/vendor/latex-review/src/client.ts

@@ -1,7 +1,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import { spawn } from "node:child_process";
-import { ROOT, codeVersion } from "./runtime.ts";
+import { ROOT, codeVersion, environmentVersion } from "./runtime.ts";
 import { Repo } from "./core/git.ts";
 import { readJson, sleep, withLock } from "./core/files.ts";
 export interface Connection {
@@ -14,6 +14,7 @@ export interface Connection {
 export interface ServerInfo {
   root: string;
   version: string;
+  environment?: string;
   pid: number;
   busy: boolean;
   csrf: string;
@@ -153,7 +154,8 @@ export async function connect(
   root: string,
   start = true,
 ): Promise<Client | null> {
-  root = path.resolve(root);
+  // Match the canonical repository path reported by the server (e.g. macOS /var).
+  root = fs.realpathSync(root);
   const home = serverHome(root);
   return withLock(path.join(home, "start.lock"), async () => {
     const last = readJson<{ port: number } | null>(
@@ -167,7 +169,12 @@ export async function connect(
     if (!info && last)
       info = { url: `http://127.0.0.1:${last.port}`, port: last.port, pid: 0 };
     let answer = await probe(root, info);
-    if (answer && (!start || answer.version === codeVersion()))
+    if (
+      answer &&
+      (!start ||
+        (answer.version === codeVersion() &&
+          answer.environment === environmentVersion()))
+    )
       return new Client(info!.url, answer.csrf);
     if (!start) return null;
     if (answer && info) {

package/vendor/latex-review/src/core/build.ts

@@ -59,21 +59,63 @@ export function affectedTargets(
   return [...selected].sort();
 }
 export function errors(text: string) {
-  const lines = text.split("\n"),
+  const lines = text.split(/\r?\n/),
     result: string[] = [];
+  const startsError = (line: string) =>
+    /^(\S[^\n]*):(\d+): (.+)$/.test(line) || line.startsWith("! ");
   for (const [i, line] of lines.entries())
-    if (/^(\S[^:\n]*):(\d+): (.+)$/.test(line) || line.startsWith("! ")) {
+    if (startsError(line)) {
+      let message = line,
+        last = line;
+      // TeX hard-wraps even in the middle of words ("P\nackage"). Keep
+      // continuations, but stop before help text, source context or a new error.
+      let end = i + 1;
+      for (; end < lines.length && end < i + 20; end++) {
+        const next = lines[end];
+        if (
+          !next.trim() ||
+          startsError(next) ||
+          /^(?:See |Type |l\.\d+ |\s*\.\.\.|\s*<)/.test(next)
+        )
+          break;
+        message += (last.length >= 78 ? "" : " ") + next;
+        last = next;
+      }
       const context = lines
-        .slice(i + 1, i + 8)
+        .slice(end, end + 12)
         .find((l) => /^l\.\d+ /.test(l))
         ?.trim();
       result.push(
-        line.replace(/^! |^\.\//, "") + (context ? `  [${context}]` : ""),
+        message
+          .replace(/^! |^\.\//, "")
+          .replace(/\s+/g, " ")
+          .trim() + (context ? `  [${context}]` : ""),
       );
       if (result.length === 8) break;
     }
   return result;
 }
+export function compilerDiagnostics(log: string, transcript: string) {
+  const details = errors(log);
+  // Errors from shell-escape helpers go to latexmk's stderr, not the TeX log.
+  for (const traceback of transcript
+    .split("Traceback (most recent call last):")
+    .slice(1)) {
+    const exception = traceback
+      .split(/\r?\n/)
+      .find((line) => /^[\w.]+(?:Error|Exception): /.test(line));
+    if (!exception) continue;
+    const minted = traceback
+      .slice(0, traceback.indexOf(exception))
+      .includes("latexminted");
+    details.push((minted ? "latexminted: " : "") + exception);
+    if (minted && exception.includes("unexpected keyword argument 'color'"))
+      details.push(
+        "latexminted is incompatible with this Python version. Update latexminted or select a compatible Python on PATH, then restart the service and retry.",
+      );
+  }
+  return [...new Set(details)];
+}
 export function warnings(text: string) {
   const patterns: [RegExp, string][] = [
     [/LaTeX Warning: Reference `([^']+)' on page/g, "Undefined reference: "],
@@ -247,11 +289,15 @@ export class Builder {
         log = path.join(out, job + ".log"),
         logText = fs.existsSync(log) ? fs.readFileSync(log, "utf8") : "";
       if (failure || !fs.existsSync(pdf)) {
-        const details = errors(logText),
+        const transcriptText = fs.readFileSync(transcript, "utf8"),
+          details = compilerDiagnostics(logText, transcriptText),
           kept = path.join(p.state, "logs", key + ".log");
         fs.mkdirSync(path.dirname(kept), { recursive: true });
-        fs.copyFileSync(fs.existsSync(log) ? log : transcript, kept);
-        const tail = fs.readFileSync(transcript, "utf8").split("\n").slice(-25);
+        fs.writeFileSync(
+          kept,
+          transcriptText + (logText ? "\n\n--- TeX log ---\n" + logText : ""),
+        );
+        const tail = transcriptText.split("\n").slice(-25);
         fs.rmSync(folder, { recursive: true, force: true });
         throw new BuildError(
           failure?.message.includes("ENOENT")

package/vendor/latex-review/src/core/outline.ts

@@ -4,12 +4,13 @@ import type { Heading, Ranges, SectionRef, Span } from "../types.ts";
 const LEVELS: Record<string, number> = {
   part: 0,
   chapter: 1,
+  addchap: 1,
   section: 2,
   subsection: 3,
   subsubsection: 4,
 };
 const COMMAND =
-  /^\s*\\(part|chapter|section|subsection|subsubsection|input|include|subfile|appendix|mainmatter|frontmatter|backmatter)\b(\*)?/;
+  /^\s*\\(part|chapter|addchap|section|subsection|subsubsection|input|include|subfile|appendix|mainmatter|frontmatter|backmatter)\b(\*)?/;
 export const stripComments = (text: string) =>
   text.replace(/(?<!\\)%[^\n]*/g, "");
 export function sourceLines(text: string) {
@@ -190,7 +191,9 @@ export function buildOutline(
           ":" +
           createHash("sha256").update(`${file}:${i}`).digest("hex").slice(0, 8);
       used.add(id);
-      const isNumbered = !match[2] && (numbered || level === 0);
+      // KOMA-Script's addchap never advances the chapter counter.
+      const isNumbered =
+        command !== "addchap" && !match[2] && (numbered || level === 0);
       if (isNumbered) {
         counters[level]++;
         if (level) counters.fill(0, level + 1);
@@ -198,7 +201,7 @@ export function buildOutline(
       const node: Draft = {
         id,
         title: plainTitle(value),
-        kind: command,
+        kind: command === "addchap" ? "chapter" : command,
         level,
         file,
         line: i + 1,

package/vendor/latex-review/src/core/publish.ts

@@ -1,7 +1,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import { randomBytes } from "node:crypto";
-import { ROOT } from "../runtime.ts";
+import { ROOT, codeVersion } from "../runtime.ts";
 import { Builder, BuildError } from "./build.ts";
 import { diffUnits, scopeViolations } from "./changes.ts";
 import { isFigure } from "./config.ts";
@@ -218,7 +218,8 @@ export class Publisher {
     if (
       latest &&
       latest.before === before &&
-      app.repo.treeId(latest.after) === app.repo.treeId(after)
+      app.repo.treeId(latest.after) === app.repo.treeId(after) &&
+      latest.summary.renderer === codeVersion()
     )
       return {
         outcome: "unchanged",
@@ -242,9 +243,9 @@ export class Publisher {
     } catch (error) {
       if (error instanceof BuildError)
         throw new PublishError(
-          "The accepted text does not compile, so there is nothing to compare against.",
+          "The comparison baseline could not be compiled.",
           error.details,
-          "Fix the accepted document or undo the change that broke it, then publish again.",
+          "Check the compiler diagnostics, fix the document or build environment, then publish again.",
           error.log,
         );
       throw error;
@@ -254,9 +255,9 @@ export class Publisher {
     } catch (error) {
       if (error instanceof BuildError)
         throw new PublishError(
-          "Your edits do not compile.",
+          "The revised document could not be compiled.",
           error.details,
-          "Fix the LaTeX errors in the worktree, then publish again.",
+          "Check the compiler diagnostics, fix the document or build environment, then publish again.",
           error.log,
         );
       throw error;
@@ -270,6 +271,7 @@ export class Publisher {
       output = final + ".pending-" + randomBytes(4).toString("hex");
     fs.mkdirSync(output, { recursive: true });
     const summary = {
+      renderer: codeVersion(),
       warnings,
       targets,
       builds: [seed, old, next].filter((b) => b !== null).map((b) => b.key),

package/vendor/latex-review/src/runtime.ts

@@ -5,6 +5,20 @@ import { createHash } from "node:crypto";
 import { listFiles } from "./core/files.ts";
 export const ROOT = path.dirname(path.dirname(fileURLToPath(import.meta.url)));
 export const WEB = path.join(ROOT, "dist/web");
+export function environmentVersion(env: NodeJS.ProcessEnv = process.env) {
+  const keys = [
+    "PATH",
+    "PYTHONHOME",
+    "PYTHONPATH",
+    "BIBINPUTS",
+    "BSTINPUTS",
+    ...Object.keys(env).filter((key) => key.startsWith("TEX")),
+  ].sort();
+  return createHash("sha256")
+    .update(JSON.stringify(keys.map((key) => [key, env[key] ?? null])))
+    .digest("hex")
+    .slice(0, 16);
+}
 let version: string | undefined;
 export function codeVersion() {
   if (!version) {

package/vendor/latex-review/src/server.ts

@@ -4,7 +4,7 @@ import { randomBytes, timingSafeEqual } from "node:crypto";
 import Fastify from "fastify";
 import staticFiles from "@fastify/static";
 import compress from "@fastify/compress";
-import { WEB, codeVersion } from "./runtime.ts";
+import { WEB, codeVersion, environmentVersion } from "./runtime.ts";
 import { Repo } from "./core/git.ts";
 import { CONFIG_NAME, loadProject, type Project } from "./core/config.ts";
 import { Store } from "./core/store.ts";
@@ -118,6 +118,7 @@ export function createServer(app: App) {
     server.get("/api/info", () => ({
       root: app.root,
       version: codeVersion(),
+      environment: environmentVersion(),
       pid: process.pid,
       busy: app.publisher.busy(),
       build_workers: app.project.build_workers,

package/vendor/latex-review/src/types.ts

@@ -69,7 +69,12 @@ export interface Round {
   before: string;
   after: string;
   units: Unit[];
-  summary: { warnings: string[]; targets: string[]; builds: string[] };
+  summary: {
+    warnings: string[];
+    targets: string[];
+    builds: string[];
+    renderer?: string;
+  };
   created: number;
 }
 export type ActionKind = "accept" | "reject" | "comment";
@@ -246,6 +251,16 @@ export interface PageState {
   /** Optional host-provided reason that file decisions or comments are unavailable. */
   decisionLock?: string | null;
   commentLock?: string | null;
+  /**
+   * Host activity, undelivered feedback (all updates, and the comments among them),
+   * and how many manuscript files this task's accepted changes touched.
+   */
+  workspace?: {
+    status: string;
+    unsent: number;
+    comments?: number;
+    accepted?: number;
+  };
   state: TaskState | null;
   latest: number | null;
   round: number | null;

package/vendor/latex-review/src/web/ChangeMap.tsx

@@ -1,12 +1,14 @@
 import { useEffect, useRef, useState, type RefObject } from "react";
 import type { Decision } from "../types.ts";
-import { stopState, type Stop } from "./model.ts";
+import { STATE, pendingUnits, stopState, type Stop } from "./model.ts";
+import { t } from "./i18n.ts";
 
 type Region = { top: number; height: number };
 
 export function ChangeMap({
   scrollRoot,
   stops,
+  showReviewed = true,
   locations,
   decisions,
   current,
@@ -15,6 +17,7 @@ export function ChangeMap({
 }: {
   scrollRoot: RefObject<HTMLElement | null>;
   stops: Stop[];
+  showReviewed?: boolean;
   locations: string[];
   decisions: Record<string, Decision>;
   current: number;
@@ -25,6 +28,10 @@ export function ChangeMap({
     drag = useRef<{ pointer: number; offset: number } | null>(null),
     [regions, setRegions] = useState<Region[]>([]),
     [viewport, setViewport] = useState<Region>({ top: 0, height: 0 });
+  const visible = stops
+    .map((stop, index) => ({ stop, index }))
+    .filter(({ stop }) => showReviewed || pendingUnits(stop, decisions).length)
+    .map(({ index }) => index);
 
   useEffect(() => {
     const root = scrollRoot.current,
@@ -125,7 +132,7 @@ export function ChangeMap({
     <nav
       ref={rail}
       className="change-map"
-      aria-label="Change map"
+      aria-label={t("Change map")}
       onPointerDown={(event) => {
         if (
           event.button !== 0 ||
@@ -165,10 +172,11 @@ export function ChangeMap({
         aria-hidden="true"
       />
       {stops.map((stop, index) => {
+        if (!visible.includes(index)) return null;
         const region = regions[index];
         if (!region) return null;
         const state = stopState(stop.units, decisions),
-          label = `Change ${index + 1} · ${state} · ${locations[index]}`;
+          label = `${t("Change {n}", { n: index + 1 })} · ${t(STATE[state] ?? state).toLowerCase()} · ${locations[index]}`;
         return (
           <button
             key={stop.key}
@@ -178,22 +186,26 @@ export function ChangeMap({
             data-state={state}
             aria-label={label}
             aria-current={index === current ? "location" : undefined}
-            tabIndex={index === Math.max(0, current) ? 0 : -1}
+            tabIndex={
+              index === (visible.includes(current) ? current : visible[0])
+                ? 0
+                : -1
+            }
             disabled={disabled}
             style={{ top: region.top, height: region.height }}
             onClick={() => onSelect(index)}
             onKeyDown={(event) => {
               const target =
                 event.key === "ArrowDown"
-                  ? index + 1
+                  ? (visible[visible.indexOf(index) + 1] ?? index)
                   : event.key === "ArrowUp"
-                    ? index - 1
+                    ? (visible[visible.indexOf(index) - 1] ?? index)
                     : event.key === "Home"
-                      ? 0
+                      ? visible[0]
                       : event.key === "End"
-                        ? stops.length - 1
+                        ? visible.at(-1)
                         : null;
-              if (target === null) return;
+              if (target == null) return;
               event.preventDefault();
               event.stopPropagation();
               rail.current

package/vendor/latex-review/src/web/PdfStrip.tsx

@@ -1,5 +1,6 @@
 import { memo, useMemo, type CSSProperties } from "react";
 import type { Strip, TextGlyph } from "../types.ts";
+import { t } from "./i18n.ts";
 let context: CanvasRenderingContext2D | null | undefined;
 const widths = new Map<string, number>();
 function width(text: string) {
@@ -67,7 +68,10 @@ export const PdfStrip = memo(function PdfStrip({
         <div
           className="pdf-text"
           role="region"
-          aria-label={`${label}, PDF page ${image.label}`}
+          aria-label={t("{label}, PDF page {page}", {
+            label,
+            page: image.label,
+          })}
         >
           {text}
         </div>

package/vendor/latex-review/src/web/i18n.ts

@@ -0,0 +1,48 @@
+import { zhCN } from "./zh-CN.ts";
+
+// The viewer reads in English unless the page asks for another language with
+// ?lang=zh-CN (Papilot passes its interface language). The English text is the
+// message key, so a string without a translation still reads correctly.
+export type Language = "en" | "zh-CN";
+const messages: Record<Language, Record<string, string>> = {
+  en: {},
+  "zh-CN": zhCN,
+};
+export function pageLanguage(search = location.search): Language {
+  return new URLSearchParams(search).get("lang")?.toLowerCase().startsWith("zh")
+    ? "zh-CN"
+    : "en";
+}
+const current: Language =
+  typeof location === "undefined" ? "en" : pageLanguage();
+if (typeof document !== "undefined") document.documentElement.lang = current;
+
+export const language = () => current;
+// Dates and numbers follow the interface language.
+export const locale = () => (current === "zh-CN" ? "zh-CN" : "en-US");
+
+// Links inside the viewer keep the page's language.
+export function withLanguage(href: string) {
+  return current === "en"
+    ? href
+    : `${href}${href.includes("?") ? "&" : "?"}lang=${current}`;
+}
+
+// t("Round {round}", { round }) fills {placeholders} after translating.
+export function t(text: string, values?: Record<string, string | number>) {
+  const template = messages[current][text] ?? text;
+  return values
+    ? template.replace(/\{(\w+)\}/g, (match, name: string) =>
+        name in values ? String(values[name]) : match,
+      )
+    : template;
+}
+// English picks between one and other by count; {n} is the count.
+export function tn(
+  count: number,
+  one: string,
+  other: string,
+  values?: Record<string, string | number>,
+) {
+  return t(count === 1 ? one : other, { n: count, ...values });
+}

package/vendor/latex-review/src/web/model.ts

@@ -38,6 +38,14 @@ export function nextPending(
   }
   return -1;
 }
+// Names for a change's state; the viewer translates them where it shows them.
+export const STATE: Record<string, string> = {
+  pending: "Pending",
+  accepted: "Accepted",
+  rejected: "Rejected",
+  commented: "Commented",
+  mixed: "Mixed",
+};
 export function stopState(
   units: string[],
   decisions: Record<string, Decision>,
@@ -122,14 +130,24 @@ export function wordDiff(before: string, after: string) {
   }
   return result;
 }
-export function describeLocation(units: (Unit & Partial<VisualUnit>)[]) {
+type Say = (text: string, values?: Record<string, string | number>) => string;
+const english: Say = (text, values = {}) =>
+  text.replace(/\{(\w+)\}/g, (match, name: string) =>
+    name in values ? String(values[name]) : match,
+  );
+// The viewer passes its translator for display; copied references and the
+// default stay in English.
+export function describeLocation(
+  units: (Unit & Partial<VisualUnit>)[],
+  say: Say = english,
+) {
   const files = new Map<string, string[]>();
   for (const unit of units) {
     const where =
       unit.status === "added"
-        ? "new file"
+        ? say("new file")
         : unit.status === "deleted"
-          ? "deleted"
+          ? say("deleted")
           : unit.new_start === unit.new_end
             ? String(unit.new_start)
             : `${unit.new_start}–${unit.new_end}`;
@@ -139,7 +157,8 @@ export function describeLocation(units: (Unit & Partial<VisualUnit>)[]) {
   return (
     [...files]
       .map(([file, places]) => `${file}:${places.join(", ")}`)
-      .join("; ") + (pages.length ? ` · p. ${pages.join(", ")}` : "")
+      .join("; ") +
+    (pages.length ? ` · ${say("p. {pages}", { pages: pages.join(", ") })}` : "")
   );
 }
 export function copyReference(

package/vendor/latex-review/src/web/overview.tsx

@@ -1,5 +1,6 @@
 import { useEffect, useState } from "react";
 import type { Summary } from "../types.ts";
+import { t, tn, withLanguage } from "./i18n.ts";
 export const STATUS: Record<string, string> = {
   editing: "Editing",
   reviewing: "In review",
@@ -45,34 +46,36 @@ export function Overview() {
   return (
     <>
       <header className="bar">
-        <a className="brand" href="/">
+        <a className="brand" href={withLanguage("/")}>
           LaTeX Review
         </a>
-        <span className="status">{tasks.length} open reviews</span>
+        <span className="status">
+          {tn(tasks.length, "{n} open review", "{n} open reviews")}
+        </span>
       </header>
       <main id="paper" className="index">
         <div className="document">
           <div className="overview-heading">
-            <h1>All reviews</h1>
+            <h1>{t("All reviews")}</h1>
           </div>
           <div className="task-tools">
             <input
               type="search"
-              aria-label="Search reviews"
-              placeholder="Search by title or task name"
+              aria-label={t("Search reviews")}
+              placeholder={t("Search by title or task name")}
               value={search}
               onChange={(e) => setSearch(e.target.value)}
             />
             <select
-              aria-label="Filter reviews"
+              aria-label={t("Filter reviews")}
               value={filter}
               onChange={(e) => setFilter(e.target.value)}
             >
-              <option value="all">All tasks</option>
-              <option value="reviewing">Awaiting your review</option>
-              <option value="building">Publishing</option>
-              <option value="revise">Awaiting revision</option>
-              <option value="done">All decided</option>
+              <option value="all">{t("All tasks")}</option>
+              <option value="reviewing">{t("Awaiting your review")}</option>
+              <option value="building">{t("Publishing")}</option>
+              <option value="revise">{t("Awaiting revision")}</option>
+              <option value="done">{t("All decided")}</option>
             </select>
           </div>
           {error && <p role="alert">{error}</p>}
@@ -87,20 +90,20 @@ export function Overview() {
                 <li key={task.task}>
                   <a
                     className="task-card"
-                    href={`/?task=${encodeURIComponent(task.task)}`}
+                    href={withLanguage(`/?task=${encodeURIComponent(task.task)}`)}
                   >
                     <div className="task-heading">
                       <h2>{task.title}</h2>
                       <span className="status" data-state={task.state}>
-                        {STATUS[task.state]}
+                        {t(STATUS[task.state])}
                       </span>
                     </div>
                     <div className="task-meta">
                       <span className="task-name">{task.task}</span>
                       <span>
                         {task.round
-                          ? `Round ${task.round}`
-                          : "Not published yet"}
+                          ? t("Round {round}", { round: task.round })
+                          : t("Not published yet")}
                       </span>
                     </div>
                     {total > 0 && (
@@ -109,7 +112,7 @@ export function Overview() {
                           <i style={{ width: `${(100 * decided) / total}%` }} />
                         </span>
                         <span>
-                          {decided} of {total} decided
+                          {t("{decided} of {total} decided", { decided, total })}
                         </span>
                       </div>
                     )}
@@ -119,12 +122,12 @@ export function Overview() {
                           .filter(([, n]) => n)
                           .map(([kind, n]) => (
                             <span key={kind} data-kind={kind}>
-                              {n} {kind}
+                              {t(`{n} ${kind}`, { n })}
                             </span>
                           ))}
                       </div>
                       <span className="task-open">
-                        {task.counts.pending ? "Review →" : "Open →"}
+                        {task.counts.pending ? t("Review →") : t("Open →")}
                       </span>
                     </div>
                   </a>
@@ -135,8 +138,10 @@ export function Overview() {
           {!visible.length && (
             <p className="empty">
               {tasks.length
-                ? "No reviews match this filter."
-                : "No open reviews yet. Start a task from your document repository."}
+                ? t("No reviews match this filter.")
+                : t(
+                    "No open reviews yet. Start a task from your document repository.",
+                  )}
             </p>
           )}
         </div>