texlite 0.18.0 → 0.19.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (228) hide show
  1. package/DESIGN.md +442 -26
  2. package/NPM_TESTING.md +23 -0
  3. package/OPERATIONS.md +227 -6
  4. package/README.md +8 -2
  5. package/README.zh-CN.md +6 -2
  6. package/THIRD_PARTY_NOTICES.md +73 -0
  7. package/dist/client/assets/AdminUsers-CuYfWnEk.js +1 -0
  8. package/dist/client/assets/AdminUsers-CuYfWnEk.js.br +0 -0
  9. package/dist/client/assets/AdminUsers-CuYfWnEk.js.gz +0 -0
  10. package/dist/client/assets/AgentIcon-ClP5dPRL.js +1 -0
  11. package/dist/client/assets/AgentIcon-ClP5dPRL.js.br +0 -0
  12. package/dist/client/assets/AgentIcon-ClP5dPRL.js.gz +0 -0
  13. package/dist/client/assets/AgentIcon-DxrC-zx_.css +1 -0
  14. package/dist/client/assets/AgentIcon-DxrC-zx_.css.br +0 -0
  15. package/dist/client/assets/AgentIcon-DxrC-zx_.css.gz +0 -0
  16. package/dist/client/assets/AgentManagement-jY_BF6Qy.js +1 -0
  17. package/dist/client/assets/AgentManagement-jY_BF6Qy.js.br +0 -0
  18. package/dist/client/assets/AgentManagement-jY_BF6Qy.js.gz +0 -0
  19. package/dist/client/assets/AgentTerminal-JKP2SVkZ.js +2 -0
  20. package/dist/client/assets/AgentTerminal-JKP2SVkZ.js.br +0 -0
  21. package/dist/client/assets/AgentTerminal-JKP2SVkZ.js.gz +0 -0
  22. package/dist/client/assets/AgentTerminalSurface-B5LH8GIb.css +1 -0
  23. package/dist/client/assets/AgentTerminalSurface-B5LH8GIb.css.br +0 -0
  24. package/dist/client/assets/AgentTerminalSurface-B5LH8GIb.css.gz +0 -0
  25. package/dist/client/assets/AgentTerminalSurface-CaYNNZ9A.js +16 -0
  26. package/dist/client/assets/AgentTerminalSurface-CaYNNZ9A.js.br +0 -0
  27. package/dist/client/assets/AgentTerminalSurface-CaYNNZ9A.js.gz +0 -0
  28. package/dist/client/assets/AvatarSettingsDialog-C2TACfvP.js +1 -0
  29. package/dist/client/assets/AvatarSettingsDialog-C2TACfvP.js.br +0 -0
  30. package/dist/client/assets/AvatarSettingsDialog-C2TACfvP.js.gz +0 -0
  31. package/dist/client/assets/CitationLibraryDialog-BdU9nbgG.js +1 -0
  32. package/dist/client/assets/CitationLibraryDialog-BdU9nbgG.js.br +0 -0
  33. package/dist/client/assets/CitationLibraryDialog-BdU9nbgG.js.gz +0 -0
  34. package/dist/client/assets/Dashboard-B7mMz5Gj.js +5 -0
  35. package/dist/client/assets/Dashboard-B7mMz5Gj.js.br +0 -0
  36. package/dist/client/assets/Dashboard-B7mMz5Gj.js.gz +0 -0
  37. package/dist/client/assets/GitDialog-C2H-jKVO.js +3 -0
  38. package/dist/client/assets/GitDialog-C2H-jKVO.js.br +0 -0
  39. package/dist/client/assets/GitDialog-C2H-jKVO.js.gz +0 -0
  40. package/dist/client/assets/GitHubAccountDialog-DdKiE3pw.js +1 -0
  41. package/dist/client/assets/GitHubAccountDialog-DdKiE3pw.js.br +0 -0
  42. package/dist/client/assets/GitHubAccountDialog-DdKiE3pw.js.gz +0 -0
  43. package/dist/client/assets/{GitHubIcon-DNR0CleM.js → GitHubIcon-Cjli8pd_.js} +1 -1
  44. package/dist/client/assets/HistoryDialog-CoxJ3EsK.js +8 -0
  45. package/dist/client/assets/HistoryDialog-CoxJ3EsK.js.br +0 -0
  46. package/dist/client/assets/HistoryDialog-CoxJ3EsK.js.gz +0 -0
  47. package/dist/client/assets/{LatexEditor-BzAk3WQM.js → LatexEditor-BhAKioho.js} +26 -26
  48. package/dist/client/assets/LatexEditor-BhAKioho.js.br +0 -0
  49. package/dist/client/assets/LatexEditor-BhAKioho.js.gz +0 -0
  50. package/dist/client/assets/PdfPreview-CC8KEz1Y.js +1 -0
  51. package/dist/client/assets/PdfPreview-CC8KEz1Y.js.br +0 -0
  52. package/dist/client/assets/PdfPreview-CC8KEz1Y.js.gz +0 -0
  53. package/dist/client/assets/ProjectIconPickerDialog-vi_HwlCS.js +1 -0
  54. package/dist/client/assets/ProjectIconPickerDialog-vi_HwlCS.js.br +0 -0
  55. package/dist/client/assets/ProjectIconPickerDialog-vi_HwlCS.js.gz +0 -0
  56. package/dist/client/assets/ProjectSettings-Bl1t-Gnh.js +4 -0
  57. package/dist/client/assets/ProjectSettings-Bl1t-Gnh.js.br +0 -0
  58. package/dist/client/assets/ProjectSettings-Bl1t-Gnh.js.gz +0 -0
  59. package/dist/client/assets/ProjectWorkspace-1UOdyfBq.js +30 -0
  60. package/dist/client/assets/ProjectWorkspace-1UOdyfBq.js.br +0 -0
  61. package/dist/client/assets/ProjectWorkspace-1UOdyfBq.js.gz +0 -0
  62. package/dist/client/assets/{QuickOpenDialog-CyqeckBM.js → QuickOpenDialog-BAzyrB-4.js} +1 -1
  63. package/dist/client/assets/QuickOpenDialog-BAzyrB-4.js.br +0 -0
  64. package/dist/client/assets/QuickOpenDialog-BAzyrB-4.js.gz +0 -0
  65. package/dist/client/assets/SaveButton-DkyoEu6j.js +1 -0
  66. package/dist/client/assets/SelectionHistoryDialog-DzlVKtxs.js +3 -0
  67. package/dist/client/assets/SelectionHistoryDialog-DzlVKtxs.js.br +0 -0
  68. package/dist/client/assets/SelectionHistoryDialog-DzlVKtxs.js.gz +0 -0
  69. package/dist/client/assets/SuccessNotice-ubBtzzi_.js +1 -0
  70. package/dist/client/assets/SystemMetricsDialog-C6RVZdJZ.js +1 -0
  71. package/dist/client/assets/SystemMetricsDialog-C6RVZdJZ.js.br +0 -0
  72. package/dist/client/assets/SystemMetricsDialog-C6RVZdJZ.js.gz +0 -0
  73. package/dist/client/assets/TagColorSelect-xbc2H5ou.js +1 -0
  74. package/dist/client/assets/TagManagementDialog-8pZUVaEI.js +1 -0
  75. package/dist/client/assets/TagManagementDialog-8pZUVaEI.js.br +0 -0
  76. package/dist/client/assets/TagManagementDialog-8pZUVaEI.js.gz +0 -0
  77. package/dist/client/assets/{WordCountDialog-Bp8kYngA.js → WordCountDialog-BODhL9iz.js} +1 -1
  78. package/dist/client/assets/WordCountDialog-BODhL9iz.js.br +0 -0
  79. package/dist/client/assets/WordCountDialog-BODhL9iz.js.gz +0 -0
  80. package/dist/client/assets/arrow-down-B6T7Z6IO.js +1 -0
  81. package/dist/client/assets/check-BRlv1lrZ.js +1 -0
  82. package/dist/client/assets/chevron-up-krb7w67X.js +1 -0
  83. package/dist/client/assets/{chktex-BcGmZVUy.js → chktex-Bz-LKycq.js} +1 -1
  84. package/dist/client/assets/{clock-3-x2vcGFSH.js → clock-3-Fb1_e3ec.js} +1 -1
  85. package/dist/client/assets/{dist-D5mbpudl.js → dist-CMYWzCHL.js} +1 -1
  86. package/dist/client/assets/dist-CMYWzCHL.js.br +0 -0
  87. package/dist/client/assets/dist-CMYWzCHL.js.gz +0 -0
  88. package/dist/client/assets/{eye-CvzXPIMu.js → eye-B6AX_5uX.js} +1 -1
  89. package/dist/client/assets/{hard-drive-BeGQ5o79.js → hard-drive-CBmnJ2xS.js} +1 -1
  90. package/dist/client/assets/i18n-DF6keNBA.js +13 -0
  91. package/dist/client/assets/i18n-DF6keNBA.js.br +0 -0
  92. package/dist/client/assets/i18n-DF6keNBA.js.gz +0 -0
  93. package/dist/client/assets/index-DCwfhKK9.js +42 -0
  94. package/dist/client/assets/index-DCwfhKK9.js.br +0 -0
  95. package/dist/client/assets/index-DCwfhKK9.js.gz +0 -0
  96. package/dist/client/assets/index-SVNFLCYh.css +1 -0
  97. package/dist/client/assets/index-SVNFLCYh.css.br +0 -0
  98. package/dist/client/assets/index-SVNFLCYh.css.gz +0 -0
  99. package/dist/client/assets/info-DNSAs0_-.js +1 -0
  100. package/dist/client/assets/{minimize-2-yYMmsVER.js → minimize-2-C8oL6PTV.js} +1 -1
  101. package/dist/client/assets/{minus-CNHOVLWS.js → minus-TCBOakyi.js} +1 -1
  102. package/dist/client/assets/plus-Dfkyfvvy.js +1 -0
  103. package/dist/client/assets/{refresh-cw-B7vZa5K2.js → refresh-cw-DuLtxWBX.js} +1 -1
  104. package/dist/client/assets/relativeTime-BR0CVAvz.js +1 -0
  105. package/dist/client/assets/relativeTime-BR0CVAvz.js.br +0 -0
  106. package/dist/client/assets/relativeTime-BR0CVAvz.js.gz +0 -0
  107. package/dist/client/assets/{search-Czv3qsBy.js → search-n-2tBATf.js} +1 -1
  108. package/dist/client/assets/{spellCheck-DDCaK8Yx.js → spellCheck-xzICTGx1.js} +1 -1
  109. package/dist/client/assets/spellCheck-xzICTGx1.js.br +0 -0
  110. package/dist/client/assets/spellCheck-xzICTGx1.js.gz +0 -0
  111. package/dist/client/assets/tags-Dy96boLq.js +1 -0
  112. package/dist/client/assets/terminal-C0xh8jVR.js +1 -0
  113. package/dist/client/assets/{type-NT195OCy.js → type-BjXWxrjH.js} +1 -1
  114. package/dist/client/assets/{user-plus-BRuwNzcg.js → user-plus-3oJZJXHW.js} +1 -1
  115. package/dist/client/index.html +13 -7
  116. package/dist/server/agents/adapters/claude.js +180 -0
  117. package/dist/server/agents/adapters/codex.js +47 -0
  118. package/dist/server/agents/adapters/common.js +86 -0
  119. package/dist/server/agents/adapters/opencode.js +196 -0
  120. package/dist/server/agents/adapters/types.js +1 -0
  121. package/dist/server/agents/execution.js +147 -0
  122. package/dist/server/agents/launcher.js +57 -0
  123. package/dist/server/agents/processIdentity.js +63 -0
  124. package/dist/server/agents/registry.js +72 -0
  125. package/dist/server/agents/sessions.js +574 -0
  126. package/dist/server/agents/terminal.js +84 -0
  127. package/dist/server/agents/workspaces.js +341 -0
  128. package/dist/server/app.js +32 -1
  129. package/dist/server/cli.js +19 -47
  130. package/dist/server/collaboration.js +64 -36
  131. package/dist/server/compileArtifacts.js +11 -44
  132. package/dist/server/compiler.js +16 -38
  133. package/dist/server/config.js +8 -2
  134. package/dist/server/db.js +33 -0
  135. package/dist/server/editHistory.js +59 -65
  136. package/dist/server/history.js +28 -13
  137. package/dist/server/i18n.js +26 -8
  138. package/dist/server/latexRoot.js +4 -2
  139. package/dist/server/locales/zh-Hant.js +145 -0
  140. package/dist/server/lucideIcons.js +14 -17
  141. package/dist/server/projectMutations.js +21 -0
  142. package/dist/server/routes/agents.js +135 -0
  143. package/dist/server/routes/compile.js +23 -43
  144. package/dist/server/routes/projectHistory.js +13 -6
  145. package/dist/server/routes/projectShared.js +6 -1
  146. package/dist/server/routes/projects.js +15 -23
  147. package/dist/shared/agentMessages.js +51 -0
  148. package/dist/shared/agentProtocol.js +41 -0
  149. package/dist/shared/historyFiles.js +1 -1
  150. package/dist/shared/historyTracking.js +2 -0
  151. package/dist/shared/locales.js +21 -0
  152. package/dist/shared/sourceCommentAnchors.js +52 -4
  153. package/package.json +7 -3
  154. package/templates/agents/AGENTS.md +135 -0
  155. package/texlite.config.example.json +3 -2
  156. package/dist/client/assets/AdminUsers-rPpYTAU6.js +0 -1
  157. package/dist/client/assets/AdminUsers-rPpYTAU6.js.br +0 -0
  158. package/dist/client/assets/AdminUsers-rPpYTAU6.js.gz +0 -0
  159. package/dist/client/assets/AvatarSettingsDialog-CIPKapVe.js +0 -1
  160. package/dist/client/assets/AvatarSettingsDialog-CIPKapVe.js.br +0 -0
  161. package/dist/client/assets/AvatarSettingsDialog-CIPKapVe.js.gz +0 -0
  162. package/dist/client/assets/CitationLibraryDialog-BhZX8BV2.js +0 -1
  163. package/dist/client/assets/CitationLibraryDialog-BhZX8BV2.js.br +0 -0
  164. package/dist/client/assets/CitationLibraryDialog-BhZX8BV2.js.gz +0 -0
  165. package/dist/client/assets/Dashboard-DppEhsjL.js +0 -5
  166. package/dist/client/assets/Dashboard-DppEhsjL.js.br +0 -0
  167. package/dist/client/assets/Dashboard-DppEhsjL.js.gz +0 -0
  168. package/dist/client/assets/GitDialog-BOu46hxA.js +0 -3
  169. package/dist/client/assets/GitDialog-BOu46hxA.js.br +0 -0
  170. package/dist/client/assets/GitDialog-BOu46hxA.js.gz +0 -0
  171. package/dist/client/assets/GitHubAccountDialog-hosK9cLW.js +0 -1
  172. package/dist/client/assets/GitHubAccountDialog-hosK9cLW.js.br +0 -0
  173. package/dist/client/assets/GitHubAccountDialog-hosK9cLW.js.gz +0 -0
  174. package/dist/client/assets/HistoryDialog-BdkuEl8r.js +0 -8
  175. package/dist/client/assets/HistoryDialog-BdkuEl8r.js.br +0 -0
  176. package/dist/client/assets/HistoryDialog-BdkuEl8r.js.gz +0 -0
  177. package/dist/client/assets/LatexEditor-BzAk3WQM.js.br +0 -0
  178. package/dist/client/assets/LatexEditor-BzAk3WQM.js.gz +0 -0
  179. package/dist/client/assets/PdfPreview-DkjI1eCo.js +0 -1
  180. package/dist/client/assets/PdfPreview-DkjI1eCo.js.br +0 -0
  181. package/dist/client/assets/PdfPreview-DkjI1eCo.js.gz +0 -0
  182. package/dist/client/assets/ProjectIconPickerDialog-D8Uo4H10.js +0 -1
  183. package/dist/client/assets/ProjectIconPickerDialog-D8Uo4H10.js.br +0 -0
  184. package/dist/client/assets/ProjectIconPickerDialog-D8Uo4H10.js.gz +0 -0
  185. package/dist/client/assets/ProjectSettings-Jdr94nOc.js +0 -1
  186. package/dist/client/assets/ProjectSettings-Jdr94nOc.js.br +0 -0
  187. package/dist/client/assets/ProjectSettings-Jdr94nOc.js.gz +0 -0
  188. package/dist/client/assets/ProjectWorkspace-D9v3Jj8T.js +0 -30
  189. package/dist/client/assets/ProjectWorkspace-D9v3Jj8T.js.br +0 -0
  190. package/dist/client/assets/ProjectWorkspace-D9v3Jj8T.js.gz +0 -0
  191. package/dist/client/assets/QuickOpenDialog-CyqeckBM.js.br +0 -0
  192. package/dist/client/assets/QuickOpenDialog-CyqeckBM.js.gz +0 -0
  193. package/dist/client/assets/SelectionHistoryDialog-Dlutex-A.js +0 -3
  194. package/dist/client/assets/SelectionHistoryDialog-Dlutex-A.js.br +0 -0
  195. package/dist/client/assets/SelectionHistoryDialog-Dlutex-A.js.gz +0 -0
  196. package/dist/client/assets/SystemMetricsDialog-CCWxXw6g.js +0 -1
  197. package/dist/client/assets/SystemMetricsDialog-CCWxXw6g.js.br +0 -0
  198. package/dist/client/assets/SystemMetricsDialog-CCWxXw6g.js.gz +0 -0
  199. package/dist/client/assets/TagColorSelect-D3T-rw4K.js +0 -1
  200. package/dist/client/assets/TagManagementDialog-CxjrSX-o.js +0 -1
  201. package/dist/client/assets/TagManagementDialog-CxjrSX-o.js.br +0 -0
  202. package/dist/client/assets/TagManagementDialog-CxjrSX-o.js.gz +0 -0
  203. package/dist/client/assets/WordCountDialog-Bp8kYngA.js.br +0 -0
  204. package/dist/client/assets/WordCountDialog-Bp8kYngA.js.gz +0 -0
  205. package/dist/client/assets/binary-B57nBiwS.js +0 -1
  206. package/dist/client/assets/check-DFoA73zZ.js +0 -1
  207. package/dist/client/assets/chevron-up-C8DyKLxi.js +0 -1
  208. package/dist/client/assets/dist-D5mbpudl.js.br +0 -0
  209. package/dist/client/assets/dist-D5mbpudl.js.gz +0 -0
  210. package/dist/client/assets/i18n-CRWKZA6W.js +0 -9
  211. package/dist/client/assets/i18n-CRWKZA6W.js.br +0 -0
  212. package/dist/client/assets/i18n-CRWKZA6W.js.gz +0 -0
  213. package/dist/client/assets/index-D0eqhDpZ.js +0 -42
  214. package/dist/client/assets/index-D0eqhDpZ.js.br +0 -0
  215. package/dist/client/assets/index-D0eqhDpZ.js.gz +0 -0
  216. package/dist/client/assets/index-DnhiIb1V.css +0 -1
  217. package/dist/client/assets/index-DnhiIb1V.css.br +0 -0
  218. package/dist/client/assets/index-DnhiIb1V.css.gz +0 -0
  219. package/dist/client/assets/plus-BDquy76g.js +0 -1
  220. package/dist/client/assets/relativeTime-DuOytR_J.js +0 -1
  221. package/dist/client/assets/relativeTime-DuOytR_J.js.br +0 -0
  222. package/dist/client/assets/relativeTime-DuOytR_J.js.gz +0 -0
  223. package/dist/client/assets/sigma-CI6gmAkl.js +0 -1
  224. package/dist/client/assets/spellCheck-DDCaK8Yx.js.br +0 -0
  225. package/dist/client/assets/spellCheck-DDCaK8Yx.js.gz +0 -0
  226. package/dist/client/assets/tags-CLK7WRSs.js +0 -1
  227. package/preview-1.png +0 -0
  228. package/preview-2.png +0 -0
@@ -1,11 +1,19 @@
1
1
  import { createHash, randomUUID } from "node:crypto";
2
+ import { CONFIG_DEFAULTS } from "./config.js";
2
3
  import { safeRelativePath } from "./files.js";
3
- const MAX_SEGMENTS_PER_PROJECT = 5_000;
4
- const MAX_SEGMENTS_TO_SCAN = MAX_SEGMENTS_PER_PROJECT;
4
+ /** Store reversible replacements; only selection-history presentation is shortened. */
5
+ export function createEditHistorySpan(beforeStart, afterStart, deleted, inserted) {
6
+ return {
7
+ beforeStart, beforeEnd: beforeStart + deleted.length,
8
+ afterStart, afterEnd: afterStart + inserted.length,
9
+ deletedLength: deleted.length, insertedLength: inserted.length,
10
+ deletedPreview: deleted, insertedPreview: inserted, truncated: false
11
+ };
12
+ }
5
13
  const DEFAULT_RESULT_LIMIT = 60;
6
14
  const EDIT_SESSION_GAP_MS = 2 * 60 * 1_000;
7
15
  const MAX_PASSAGE_PREVIEW_CHARS = 6_000;
8
- export const DEFAULT_EDIT_HISTORY_MAX_STORAGE_BYTES = 32 * 1024 * 1024;
16
+ export const DEFAULT_EDIT_HISTORY_MAX_STORAGE_BYTES = CONFIG_DEFAULTS.editHistoryMaxStorageMB * 1024 * 1024;
9
17
  /**
10
18
  * Stores author-isolated collaboration edits independently from retained
11
19
  * project snapshots. A segment is a short, contiguous run from one user and
@@ -13,20 +21,23 @@ export const DEFAULT_EDIT_HISTORY_MAX_STORAGE_BYTES = 32 * 1024 * 1024;
13
21
  */
14
22
  export class ProjectEditHistoryService {
15
23
  db;
24
+ maxSegments;
16
25
  maxStorageBytes;
17
- constructor(db, maxStorageBytes = DEFAULT_EDIT_HISTORY_MAX_STORAGE_BYTES) {
26
+ constructor(db, maxStorageBytes = DEFAULT_EDIT_HISTORY_MAX_STORAGE_BYTES, maxSegments = CONFIG_DEFAULTS.editHistoryMaxSegments) {
18
27
  this.db = db;
28
+ this.maxSegments = maxSegments;
19
29
  this.maxStorageBytes = normalizeStorageLimit(maxStorageBytes);
20
30
  }
21
31
  record(projectId, inputs) {
22
- const normalized = inputs
23
- .map(normalizeSegment)
24
- .filter((segment) => segment !== null);
25
- if (!normalized.length)
32
+ // These records are produced by our Yjs rooms, not supplied by an API.
33
+ // Reject a broken batch before writing anything so the caller can report
34
+ // the history failure instead of silently accepting a partial edit chain.
35
+ const validated = inputs.map(validateSegment);
36
+ if (!validated.length)
26
37
  return;
27
38
  const segments = [];
28
39
  const skipped = [];
29
- for (const segment of normalized) {
40
+ for (const segment of validated) {
30
41
  const stepsJson = JSON.stringify(segment.steps);
31
42
  const stepsBytes = Buffer.byteLength(stepsJson, "utf8");
32
43
  // A single oversized burst would make the quota ineffective. Dropping it
@@ -76,7 +87,7 @@ export class ProjectEditHistoryService {
76
87
  let firstDiscard = rows.length;
77
88
  for (let index = 0; index < rows.length; index += 1) {
78
89
  const size = Math.max(0, Number(rows[index].steps_bytes) || 0);
79
- if (retainedCount >= MAX_SEGMENTS_PER_PROJECT || retainedBytes + size > this.maxStorageBytes) {
90
+ if (retainedCount >= this.maxSegments || retainedBytes + size > this.maxStorageBytes) {
80
91
  firstDiscard = index;
81
92
  break;
82
93
  }
@@ -107,11 +118,14 @@ export class ProjectEditHistoryService {
107
118
  const filePath = safeRelativePath(filePathInput);
108
119
  const start = clamp(Math.min(startInput, endInput), 0, currentSource.length);
109
120
  const end = clamp(Math.max(startInput, endInput), start, currentSource.length);
121
+ // Stream retained rows instead of loading every replacement payload into
122
+ // an array. Stop as soon as the requested display windows are complete;
123
+ // retention count and query memory usage must not be coupled.
110
124
  const rows = this.db.prepare(`SELECT segment.*, user.username AS author_username, user.display_name AS author_name, user.avatar_style AS author_avatar_style
111
125
  FROM project_edit_segments segment LEFT JOIN users user ON user.id = segment.author_id
112
126
  WHERE segment.project_id = ? AND segment.file_path = ?
113
- ORDER BY segment.updated_at DESC, segment.rowid DESC LIMIT ?`)
114
- .all(projectId, filePath, MAX_SEGMENTS_TO_SCAN);
127
+ ORDER BY segment.updated_at DESC, segment.rowid DESC`)
128
+ .iterate(projectId, filePath);
115
129
  const entries = [];
116
130
  let passage = {
117
131
  range: { start, end },
@@ -249,7 +263,7 @@ function authorKey(row) {
249
263
  /**
250
264
  * Reconstruct just the selected passage while walking a Yjs step backwards.
251
265
  * We avoid rebuilding the full source tree and abandon the exact passage only
252
- * when a deliberately truncated stored preview makes reconstruction unsafe.
266
+ * when a legacy truncated replacement makes reconstruction unsafe.
253
267
  */
254
268
  function undoPassage(current, beforeRange, spans) {
255
269
  if (!spans.length)
@@ -285,71 +299,50 @@ function previewPassage(value) {
285
299
  export function hashText(content) {
286
300
  return createHash("sha256").update(content).digest("hex");
287
301
  }
288
- function normalizeSegment(input) {
289
- if (!input.authorId || !input.steps.length)
290
- return null;
291
- let filePath;
292
- try {
293
- filePath = safeRelativePath(input.filePath);
294
- }
295
- catch {
296
- return null;
302
+ function validateSegment(input) {
303
+ if (!input.authorId || !input.steps.length || (input.kind !== "edit" && input.kind !== "format")) {
304
+ throw new Error(`Invalid edit history segment for ${input.filePath}`);
297
305
  }
298
- const steps = input.steps.map(normalizeStep).filter((step) => step !== null);
299
- if (!steps.length)
300
- return null;
301
- const first = steps[0];
302
- const last = steps.at(-1);
303
- if (input.beforeHash !== first.beforeHash || input.afterHash !== last.afterHash)
304
- return null;
305
- for (let index = 1; index < steps.length; index += 1) {
306
- if (steps[index - 1].afterHash !== steps[index].beforeHash)
307
- return null;
306
+ const filePath = safeRelativePath(input.filePath);
307
+ validateTimestamp(input.createdAt);
308
+ validateTimestamp(input.updatedAt);
309
+ input.steps.forEach(validateStep);
310
+ const first = input.steps[0];
311
+ const last = input.steps.at(-1);
312
+ if (input.beforeHash !== first.beforeHash || input.afterHash !== last.afterHash
313
+ || input.steps.some((step, index) => index > 0 && input.steps[index - 1].afterHash !== step.beforeHash)) {
314
+ throw new Error(`Broken edit history chain for ${filePath}`);
308
315
  }
309
- return {
310
- filePath,
311
- authorId: input.authorId,
312
- kind: input.kind === "format" ? "format" : "edit",
313
- beforeHash: input.beforeHash,
314
- afterHash: input.afterHash,
315
- createdAt: safeTimestamp(input.createdAt),
316
- updatedAt: safeTimestamp(input.updatedAt),
317
- steps
318
- };
316
+ return { ...input, filePath };
319
317
  }
320
- function normalizeStep(step) {
321
- if (!isHash(step.beforeHash) || !isHash(step.afterHash))
322
- return null;
323
- const spans = step.spans.map(normalizeSpan).filter((span) => span !== null);
324
- return spans.length ? { beforeHash: step.beforeHash, afterHash: step.afterHash, createdAt: safeTimestamp(step.createdAt), spans } : null;
318
+ function validateStep(step) {
319
+ if (!isHash(step.beforeHash) || !isHash(step.afterHash) || !Array.isArray(step.spans) || !step.spans.length) {
320
+ throw new Error("Invalid edit history step");
321
+ }
322
+ validateTimestamp(step.createdAt);
323
+ step.spans.forEach(validateSpan);
325
324
  }
326
- function normalizeSpan(span) {
325
+ function validateSpan(span) {
327
326
  const numeric = [span.beforeStart, span.beforeEnd, span.afterStart, span.afterEnd, span.deletedLength, span.insertedLength];
328
- if (numeric.some((value) => !Number.isInteger(value) || value < 0)
327
+ if (numeric.some((value) => !Number.isSafeInteger(value) || value < 0)
329
328
  || span.beforeEnd < span.beforeStart || span.afterEnd < span.afterStart
330
329
  || span.deletedLength !== span.beforeEnd - span.beforeStart
331
- || span.insertedLength !== span.afterEnd - span.afterStart)
332
- return null;
333
- return {
334
- beforeStart: span.beforeStart,
335
- beforeEnd: span.beforeEnd,
336
- afterStart: span.afterStart,
337
- afterEnd: span.afterEnd,
338
- deletedLength: span.deletedLength,
339
- insertedLength: span.insertedLength,
340
- deletedPreview: typeof span.deletedPreview === "string" ? span.deletedPreview.slice(0, 4_096) : "",
341
- insertedPreview: typeof span.insertedPreview === "string" ? span.insertedPreview.slice(0, 4_096) : "",
342
- truncated: Boolean(span.truncated)
343
- };
330
+ || span.insertedLength !== span.afterEnd - span.afterStart
331
+ || typeof span.deletedPreview !== "string" || typeof span.insertedPreview !== "string"
332
+ || typeof span.truncated !== "boolean")
333
+ throw new Error("Invalid edit history span");
344
334
  }
345
335
  function parseSteps(input) {
346
336
  try {
347
337
  const parsed = JSON.parse(input);
348
338
  if (!Array.isArray(parsed))
349
339
  return [];
350
- return parsed.map(normalizeStep).filter((step) => step !== null);
340
+ parsed.forEach(validateStep);
341
+ return parsed;
351
342
  }
352
343
  catch {
344
+ // Legacy/damaged rows end the selection-history chain. Never keep only
345
+ // their valid-looking steps and guess across the missing replacements.
353
346
  return [];
354
347
  }
355
348
  }
@@ -395,8 +388,9 @@ function rangesIntersect(leftStart, leftEnd, rightStart, rightEnd) {
395
388
  return rightStart >= leftStart && rightStart <= leftEnd;
396
389
  return leftStart < rightEnd && rightStart < leftEnd;
397
390
  }
398
- function safeTimestamp(value) {
399
- return Number.isNaN(Date.parse(value)) ? new Date().toISOString() : value;
391
+ function validateTimestamp(value) {
392
+ if (typeof value !== "string" || Number.isNaN(Date.parse(value)))
393
+ throw new Error("Invalid edit history timestamp");
400
394
  }
401
395
  function isHash(value) {
402
396
  return typeof value === "string" && /^[a-f0-9]{64}$/i.test(value);
@@ -4,8 +4,6 @@ import { createHash, randomUUID } from "node:crypto";
4
4
  import { assertNoSourceSymlinks, listProjectFiles, outputRoot, projectRoot, resolveSourcePath, safeRelativePath, sourceRoot } from "./files.js";
5
5
  import { httpError } from "./http.js";
6
6
  import { MAX_TEXT_PREVIEW_BYTES } from "./limits.js";
7
- import { isUtf8 } from "node:buffer";
8
- import { isHistoryTextFile } from "../shared/historyFiles.js";
9
7
  import { defaultHistoryTracking, historyTextCandidate, historyTrackingOverride } from "../shared/historyTracking.js";
10
8
  const AUTOSAVE_COALESCE_MS = 2 * 60_000;
11
9
  // Logical stored payload; SQLite pages, indexes and WAL are shared database overhead.
@@ -286,12 +284,30 @@ export class ProjectHistoryService {
286
284
  .run(label, versionId, projectId);
287
285
  return result.changes ? this.version(versionId, projectId) : null;
288
286
  }
287
+ /** Share the recording classifier with the UI without rereading modern objects. */
288
+ isTextFile(projectId, filePath, file) {
289
+ if (!historyTextCandidate(filePath))
290
+ return false;
291
+ if (file?.textContent !== undefined)
292
+ return file.textContent;
293
+ // Do not read oversized legacy objects just to build the file list. The
294
+ // comparison endpoint reports size/missing-object errors when selected.
295
+ if (!file || file.size > MAX_TEXT_PREVIEW_BYTES)
296
+ return undefined;
297
+ try {
298
+ return defaultHistoryTracking(filePath, fs.readFileSync(this.objectPath(projectId, file.digest)));
299
+ }
300
+ catch {
301
+ // Keep snapshot metadata browsable even if an old object is unavailable.
302
+ return undefined;
303
+ }
304
+ }
289
305
  readTextFile(projectId, versionId, filePathInput) {
290
306
  const filePath = safeRelativePath(filePathInput);
291
- if (!isHistoryTextFile(filePath))
307
+ if (!historyTextCandidate(filePath))
292
308
  return null;
293
309
  const entry = this.manifest(projectId, versionId)?.files[filePath];
294
- if (!entry || entry.size > MAX_TEXT_PREVIEW_BYTES)
310
+ if (!entry || entry.textContent === false || entry.size > MAX_TEXT_PREVIEW_BYTES)
295
311
  return null;
296
312
  return this.readStoredObject(projectId, entry.digest, filePath);
297
313
  }
@@ -425,7 +441,8 @@ export class ProjectHistoryService {
425
441
  if (override === false || (override === null && !historyTextCandidate(filePath)))
426
442
  return null;
427
443
  const content = fs.readFileSync(resolveSourcePath(this.config, projectId, filePath));
428
- if (override === null && !defaultHistoryTracking(filePath, content))
444
+ const textContent = defaultHistoryTracking(filePath, content);
445
+ if (override === null && !textContent)
429
446
  return null;
430
447
  const digest = createHash("sha256").update(content).digest("hex");
431
448
  const target = this.objectPath(projectId, digest);
@@ -442,7 +459,7 @@ export class ProjectHistoryService {
442
459
  throw error;
443
460
  }
444
461
  }
445
- return { digest, size: content.length };
462
+ return { digest, size: content.length, textContent };
446
463
  }
447
464
  objectPath(projectId, digest) {
448
465
  if (!/^[a-f0-9]{64}$/.test(digest))
@@ -457,7 +474,7 @@ export class ProjectHistoryService {
457
474
  readStoredObject(projectId, digest, filePath) {
458
475
  try {
459
476
  const bytes = fs.readFileSync(this.objectPath(projectId, digest));
460
- return !bytes.includes(0) && isUtf8(bytes) ? bytes.toString("utf8") : null;
477
+ return defaultHistoryTracking(filePath, bytes) ? bytes.toString("utf8") : null;
461
478
  }
462
479
  catch (error) {
463
480
  this.rethrowHistoryObjectError(error, filePath);
@@ -689,13 +706,11 @@ function parseManifest(value) {
689
706
  return { ...parsed, settings: { ...parsed.settings, chktexEnabled: parsed.settings.chktexEnabled === true } };
690
707
  }
691
708
  function parseStringArray(value) {
692
- try {
693
- const parsed = JSON.parse(value);
694
- return Array.isArray(parsed) ? parsed.filter((item) => typeof item === "string") : [];
695
- }
696
- catch {
697
- return [];
709
+ const parsed = JSON.parse(value);
710
+ if (!Array.isArray(parsed) || parsed.some((item) => typeof item !== "string")) {
711
+ throw new Error("Invalid snapshot changed paths");
698
712
  }
713
+ return parsed;
699
714
  }
700
715
  /**
701
716
  * Keep cursors opaque so the public API is free to change its physical
@@ -1,4 +1,13 @@
1
+ /**
2
+ * Server-side messages intentionally use the same stable error codes as the
3
+ * browser API. Keeping the catalog independent from route code makes API
4
+ * responses useful to direct clients as well as to the React application.
5
+ */
6
+ import { supportedLocale } from "../shared/locales.js";
7
+ import { zhHantMessages } from "./locales/zh-Hant.js";
8
+ import { agentMessages } from "../shared/agentMessages.js";
1
9
  const enMessages = {
10
+ ...agentMessages.en,
2
11
  AVATAR_STYLE_INVALID: "Choose a supported avatar style.",
3
12
  AVATAR_NOT_FOUND: "No custom avatar is configured for this user.",
4
13
  AVATAR_PREVIEW_FORBIDDEN: "You can only preview avatars for your own account.",
@@ -19,6 +28,7 @@ const enMessages = {
19
28
  CHK_TEX_SOURCE_TOO_LARGE: "The source to check is too large.",
20
29
  CHK_TEX_SUPERSEDED: "A newer ChkTeX check replaced this request.",
21
30
  CHK_TEX_UNAVAILABLE: "ChkTeX is not installed or cannot run on this server. Install the TeX Live chktex package and try again.",
31
+ CLIENT_UPDATE_REQUIRED: "This page is out of date. Save your changes and reload it to continue writing checks.",
22
32
  COMMENT_DELETE_FORBIDDEN: "You can only delete your own comments.",
23
33
  COMMENT_EDIT_FORBIDDEN: "You can only edit your own comments.",
24
34
  COMMENT_FILE_NOT_FOUND: "The file for this comment does not exist.",
@@ -140,6 +150,7 @@ const enMessages = {
140
150
  GIT_OPERATION_FAILED: "The Git operation could not be completed."
141
151
  };
142
152
  const zhMessages = {
153
+ ...agentMessages.zh,
143
154
  AVATAR_STYLE_INVALID: "请选择支持的头像风格。",
144
155
  AVATAR_NOT_FOUND: "该用户尚未设置自定义头像。",
145
156
  AVATAR_PREVIEW_FORBIDDEN: "只能预览自己账号的头像。",
@@ -160,6 +171,7 @@ const zhMessages = {
160
171
  CHK_TEX_SOURCE_TOO_LARGE: "待检查源码过大。",
161
172
  CHK_TEX_SUPERSEDED: "更新的 ChkTeX 检查已替代此请求。",
162
173
  CHK_TEX_UNAVAILABLE: "服务器未安装 ChkTeX,或 ChkTeX 当前无法运行。请在服务器安装 TeX Live 的 chktex 包后重试。",
174
+ CLIENT_UPDATE_REQUIRED: "当前页面版本过旧。请先保存修改,再刷新页面以继续写作检查。",
163
175
  COMMENT_DELETE_FORBIDDEN: "只能删除自己的批注。",
164
176
  COMMENT_EDIT_FORBIDDEN: "只能编辑自己的批注。",
165
177
  COMMENT_FILE_NOT_FOUND: "批注对应的文件不存在。",
@@ -282,19 +294,25 @@ const zhMessages = {
282
294
  };
283
295
  const messages = {
284
296
  en: enMessages,
285
- zh: zhMessages
297
+ zh: zhMessages,
298
+ "zh-Hant": zhHantMessages
286
299
  };
287
300
  function headerValue(value) {
288
301
  return Array.isArray(value) ? value[0] ?? "" : value ?? "";
289
302
  }
290
303
  /** Use the explicit app language first, then a standard Accept-Language header. */
291
304
  export function serverLocale(headers) {
292
- const requested = headerValue(headers?.["x-texlite-language"])
293
- || headerValue(headers?.["accept-language"]);
294
- if (/\bzh(?:[-_]|\b)/i.test(requested))
295
- return "zh";
296
- if (/\ben(?:[-_]|\b)/i.test(requested))
297
- return "en";
305
+ const explicit = supportedLocale(headerValue(headers?.["x-texlite-language"]));
306
+ if (explicit)
307
+ return explicit;
308
+ const requested = headerValue(headers?.["accept-language"]).split(",").map((range) => {
309
+ const [language, ...params] = range.trim().split(";");
310
+ const weight = params.find((param) => /^\s*q\s*=/i.test(param));
311
+ return { locale: supportedLocale(language), quality: weight ? Number(weight.split("=")[1]) : 1 };
312
+ }).filter((range) => range.locale && Number.isFinite(range.quality) && range.quality > 0 && range.quality <= 1)
313
+ .sort((left, right) => right.quality - left.quality);
314
+ if (requested[0]?.locale)
315
+ return requested[0].locale;
298
316
  // API clients without a language header follow the same fallback as the web
299
317
  // application: English. Browser clients always send Accept-Language.
300
318
  return "en";
@@ -313,6 +331,6 @@ function isServerErrorCode(code) {
313
331
  export function serverErrorMessage(locale, code, params = {}) {
314
332
  const template = isServerErrorCode(code)
315
333
  ? messages[locale][code]
316
- : (locale === "zh" ? "请求无法完成。" : "The request could not be completed.");
334
+ : ({ en: "The request could not be completed.", zh: "请求无法完成。", "zh-Hant": "無法完成請求。" })[locale];
317
335
  return template.replace(/{{\s*([\w.-]+)\s*}}/g, (_match, key) => stringValue(params[key]));
318
336
  }
@@ -70,8 +70,10 @@ export function isMainDocumentCandidateSync(config, projectId, filePath) {
70
70
  return true;
71
71
  }
72
72
  }
73
- catch {
74
- return false;
73
+ catch (error) {
74
+ if (error.code === "ENOENT")
75
+ return false;
76
+ throw error;
75
77
  }
76
78
  const texFiles = texFilePaths(listProjectFiles(config, projectId));
77
79
  return texFiles.length === 1 && texFiles[0] === filePath;
@@ -0,0 +1,145 @@
1
+ import { agentMessages } from "../../shared/agentMessages.js";
2
+ /** Traditional Chinese API messages, using the same stable error codes. */
3
+ export const zhHantMessages = {
4
+ ...agentMessages["zh-Hant"],
5
+ AVATAR_STYLE_INVALID: "請選擇支援的頭像風格。",
6
+ AVATAR_NOT_FOUND: "該使用者尚未設定自訂頭像。",
7
+ AVATAR_PREVIEW_FORBIDDEN: "只能預覽自己帳號的頭像。",
8
+ API_NOT_FOUND: "API 端點不存在。",
9
+ ADMIN_REQUIRED: "需要管理員權限。",
10
+ ARTIFACT_PREVIEW_UNSUPPORTED: "該產出不能作為文字預覽,請下載後檢視。",
11
+ AUTH_INVALID: "使用者名稱或密碼錯誤。",
12
+ AUTH_RATE_LIMITED: "登入嘗試過於頻繁,請在 15 分鐘後再試一次。",
13
+ AUTH_REQUIRED: "請先登入。",
14
+ CITATION_CONFLICT: "這筆文獻已在其他位置修改,請重新整理文獻庫後再試一次。",
15
+ CITATION_KEY_EXISTS: "已存在相同引用鍵值的文獻項目。",
16
+ CITATION_LIBRARY_PRIVATE: "文獻庫僅對其擁有者可見。",
17
+ CITATION_NOT_FOUND: "文獻項目不存在。",
18
+ CITATION_TAG_NOT_FOUND: "引用標籤不存在。",
19
+ CITATION_TAG_NAME_EXISTS: "已存在同名的引用標籤。",
20
+ CITATION_TOO_LARGE: "BibTeX 項目過大。",
21
+ CHK_TEX_SOURCE_INVALID: "待檢查原始碼格式不正確。",
22
+ CHK_TEX_SOURCE_TOO_LARGE: "待檢查原始碼過大。",
23
+ CHK_TEX_SUPERSEDED: "更新的 ChkTeX 檢查已替代此請求。",
24
+ CHK_TEX_UNAVAILABLE: "伺服器尚未安裝 ChkTeX,或目前無法執行。請安裝 TeX Live 的 chktex 套件後再試一次。",
25
+ CLIENT_UPDATE_REQUIRED: "目前頁面版本過舊。請先儲存修改,再重新整理頁面,以繼續寫作檢查。",
26
+ COMMENT_DELETE_FORBIDDEN: "只能刪除自己的批註。",
27
+ COMMENT_EDIT_FORBIDDEN: "只能編輯自己的批註。",
28
+ COMMENT_FILE_NOT_FOUND: "批註對應的檔案不存在。",
29
+ COMMENT_NOT_FOUND: "批註不存在。",
30
+ COMMENT_RANGE_INVALID: "批註的原始碼範圍無效。",
31
+ COMMENT_SOURCE_CHANGED: "準備批註時原始碼已發生變化。請重新選取文字後再試。",
32
+ COMMENT_UPDATE_EMPTY: "沒有可儲存的批註修改。",
33
+ COMPILE_ARTIFACT_NOT_FOUND: "編譯產出不存在。",
34
+ COMPILE_ARTIFACTS_NOT_FOUND: "尚無可用的編譯產出。",
35
+ COMPILE_CLEAN_BUSY: "目前主文件正在編譯,請完成後再執行故障排除。",
36
+ COMPILE_FORBIDDEN: "你沒有編譯此專案的權限。",
37
+ COMPILE_SNAPSHOT_BUSY: "專案原始碼仍在儲存,請稍後重新編譯。",
38
+ CURRENT_PASSWORD_INVALID: "目前密碼錯誤。",
39
+ DICTIONARY_EDIT_FORBIDDEN: "你沒有維護本專案字典的權限。",
40
+ DIRECTORY_NOT_FOUND: "目標資料夾不存在。",
41
+ FILE_CONTENT_INVALID: "檔案內容格式不正確。",
42
+ FILE_EXISTS: "同名檔案已經存在。",
43
+ FILE_NOT_FOUND: "檔案不存在。",
44
+ FILE_TOO_LARGE: "檔案過大,無法開啟或上傳。",
45
+ FORMAT_FAILED: "無法格式化原始碼。",
46
+ GIT_ACCOUNT_INVALID: "GitHub 未傳回有效的帳號資訊。",
47
+ GIT_BRANCH_INVALID: "本機 Git 分支名稱無效。",
48
+ GIT_COMMAND_FAILED: "Git 命令執行失敗,請檢視伺服器記錄以了解詳情。",
49
+ GIT_COMMIT_MESSAGE_INVALID: "請輸入不超過 300 個字元的提交說明。",
50
+ GIT_DETACHED_HEAD: "目前處於 detached HEAD,請先返回預設分支。",
51
+ GIT_REPOSITORY_NAME_INVALID: "請輸入 GitHub 儲存庫名稱。",
52
+ GIT_REPOSITORY_NOT_INITIALIZED: "該專案尚未初始化 Git。",
53
+ GIT_REPOSITORY_RESPONSE_INVALID: "GitHub 未傳回有效的儲存庫資訊。",
54
+ GIT_REVISION_INVALID: "請選擇要切換(checkout)的 Git 版本。",
55
+ GIT_TOKEN_INVALID: "請輸入 GitHub token。",
56
+ GIT_TOKEN_NOT_CONFIGURED: "請先設定 GitHub token。",
57
+ GIT_TOKEN_REJECTED: "GitHub 拒絕了此 token:它可能無效、已過期或權限不足。",
58
+ GIT_UNAVAILABLE: "伺服器未安裝 Git。",
59
+ HARPER_UNAVAILABLE: "Harper 拼字及文法檢查暫時無法使用。",
60
+ HISTORY_FILE_NOT_FOUND: "歷史檔案不存在。",
61
+ HISTORY_OBJECT_MISSING: "此快照儲存的檔案已遺失,無法再檢視或還原。",
62
+ HISTORY_FILE_PREVIEW_UNSUPPORTED: "該歷史檔案不能作為文字比較。",
63
+ HISTORY_TARGET_CONFLICT: "無法將歷史版本還原到所請求的路徑。",
64
+ HISTORY_VERSION_NOT_FOUND: "歷史版本不存在。",
65
+ HISTORY_VERSION_CHANGED: "檢視期間該專案快照已發生變化。請重新整理後再還原。",
66
+ SELECTION_HISTORY_SOURCE_CHANGED: "開啟選取範圍歷史時原始碼已發生變化。請等待同步完成,重新選取文字後再開啟歷史。",
67
+ INVALID_PATH: "檔案路徑無效。",
68
+ LAST_ADMIN: "系統必須保留至少一名可用管理員。",
69
+ LATEXMKRC_DISABLED: "管理員已停用專案級 latexmkrc。",
70
+ LATEXMKRC_INVALID: "所選 latexmkrc 檔案無效。",
71
+ LATEXMKRC_NOT_FOUND: "所選 latexmkrc 檔案不存在。",
72
+ MAIN_DOCUMENT_CHANGED: "編譯排隊期間主文件已變化,請重新編譯。",
73
+ MAIN_DOCUMENT_INVALID: "所選檔案不是有效的 LaTeX 主文件。",
74
+ MAIN_FILE_DELETE_FORBIDDEN: "不能刪除主文件。",
75
+ MAIN_FILE_INVALID: "主文件必須是已存在的 .tex 檔案。",
76
+ MAIN_FILE_NOT_FOUND: "所選主文件不存在。",
77
+ MEMBERS_MANAGE_FORBIDDEN: "只有專案擁有者可以管理成員。",
78
+ MENTION_NOT_FOUND: "@ 提醒不存在。",
79
+ MOVE_INTO_SELF: "不能把資料夾移動到自身內部。",
80
+ OWNER_MEMBER_FORBIDDEN: "專案擁有者不能作為成員新增。",
81
+ PASSWORD_TOO_SHORT: "密碼至少需要 {{minLength}} 個字元。",
82
+ PATH_EXISTS: "目標路徑已被檔案或資料夾佔用。",
83
+ PATH_NOT_FOUND: "檔案或資料夾不存在。",
84
+ PDF_NOT_FOUND: "尚未產生 PDF。",
85
+ PROJECT_BUSY: "專案正在執行原始檔操作,請稍後再試一次。",
86
+ PROJECT_CREATE_FORBIDDEN: "管理員尚未授予你建立專案的權限。",
87
+ PROJECT_DELETE_FORBIDDEN: "只有專案擁有者可以刪除專案。",
88
+ PROJECT_EDIT_FORBIDDEN: "你沒有此專案的編輯權限。",
89
+ PROJECT_ICON_INVALID: "請輸入已安裝的有效 Lucide 圖示短名稱。",
90
+ PROJECT_NOT_FOUND: "專案不存在或你已無法存取。",
91
+ PROJECT_OWNER_ONLY: "只有專案擁有者可以執行此操作。",
92
+ PROJECT_SETTINGS_CONFLICT: "專案設定已在其他工作階段中更改。請重新整理專案頁面後再儲存。",
93
+ PROJECT_TRANSFER_FORBIDDEN: "只有目前專案擁有者可以轉讓專案。",
94
+ PROJECT_TRANSFER_SELF: "你已經是該專案的擁有者。",
95
+ PROJECT_TRANSFER_TARGET_INVALID: "請選擇新的專案擁有者。",
96
+ REPLY_DELETE_FORBIDDEN: "只能刪除自己的回覆。",
97
+ REPLY_EDIT_FORBIDDEN: "只能編輯自己的回覆。",
98
+ REPLY_NOT_FOUND: "回覆不存在。",
99
+ REQUEST_INVALID: "請求格式無效。",
100
+ RESERVED_PATH: "此路徑由 TexLite 保留。",
101
+ SELF_DELETE_FORBIDDEN: "不能刪除目前登入的管理員。",
102
+ SELF_RESTRICT_FORBIDDEN: "不能停用目前登入的管理員或降低其角色權限。",
103
+ SERVER_ERROR: "伺服器內部錯誤",
104
+ SOURCE_FILE_NOT_FOUND: "原始檔不存在。",
105
+ SOURCE_FLUSH_FAILED: "部分原始碼未能儲存至磁碟,專案操作已取消。",
106
+ SPELLCHECK_SOURCE_INVALID: "待檢查原始碼格式不正確。",
107
+ SPELLCHECK_SOURCE_TOO_LARGE: "待檢查原始碼過大。",
108
+ SPELLCHECK_SUPERSEDED: "更新的寫作檢查已替代此請求。",
109
+ SYNCTEX_EXTERNAL_PATH: "SyncTeX 傳回了專案外部的原始碼路徑。",
110
+ SYNCTEX_NOT_AVAILABLE: "尚無可用的 SyncTeX 資料,請重新編譯。",
111
+ SYMLINK_FORBIDDEN: "專案原始碼中不允許使用符號連結。",
112
+ SYNC_PDF_INVALID: "PDF 位置無效。",
113
+ SYNC_SOURCE_INVALID: "原始碼位置無效。",
114
+ TAG_NAME_EXISTS: "你已經有同名標籤。",
115
+ TAG_NOT_FOUND: "所選標籤不存在。",
116
+ UPLOAD_EMPTY: "沒有選擇要上傳的檔案。",
117
+ USERNAME_INVALID: "使用者名稱只能包含字母、數字、點、橫線或底線。",
118
+ USER_NOT_FOUND: "使用者不存在或已被停用。",
119
+ WORD_COUNT_FAILED: "TeXcount 無法統計這段原始碼。",
120
+ WORD_COUNT_SOURCE_INVALID: "請選擇 LaTeX 原始碼後再統計。",
121
+ WORD_COUNT_SOURCE_TOO_LARGE: "所選原始碼過大,無法統計。",
122
+ WORD_COUNT_UNAVAILABLE: "伺服器尚未安裝 TeX Live 的 texcount 套件,請安裝後再試一次。",
123
+ ZIP_DUPLICATE_ENTRY: "ZIP 壓縮檔包含重複檔名:{{path}}。",
124
+ ZIP_ENTRY_READ_FAILED: "無法讀取 ZIP 壓縮檔中的檔案。",
125
+ ZIP_ENTRY_TOO_LARGE: "ZIP 壓縮檔中存在超過限制的檔案。",
126
+ ZIP_INVALID: "無法匯入 ZIP 壓縮檔。",
127
+ ZIP_INVALID_PATH: "ZIP 壓縮檔包含無效路徑。",
128
+ ZIP_MAIN_DOCUMENT_NOT_FOUND: "壓縮檔中沒有找到 LaTeX 主文件(.tex)。",
129
+ ZIP_ONLY: "請選擇 ZIP 壓縮檔。",
130
+ ZIP_READ_FAILED: "無法讀取 ZIP 壓縮檔。",
131
+ ZIP_SYMLINK_FORBIDDEN: "ZIP 壓縮檔不允許包含符號連結。",
132
+ ZIP_TOO_MANY_ENTRIES: "ZIP 壓縮檔中的檔案數量超過限制。",
133
+ ZIP_TOTAL_TOO_LARGE: "ZIP 壓縮檔解壓縮後的總大小超過限制。",
134
+ SYNCTEX_FAILED: "SyncTeX 無法定位該位置,請重新編譯專案。",
135
+ GIT_INVALID: "Git 請求格式無效。",
136
+ GIT_REVISION_NOT_FOUND: "所請求的 Git 版本不存在。",
137
+ GIT_CONFLICT: "目前儲存庫狀態下無法完成 Git 操作。",
138
+ GIT_NO_CHANGES: "目前沒有可以提交的修改。",
139
+ GIT_NO_COMMIT: "該專案沒有可用於此操作的提交。",
140
+ GIT_OUTPUT_TOO_LARGE: "Git 輸出過大,無法安全顯示。",
141
+ GIT_REMOTE_ALREADY_CONFIGURED: "該專案已經設定遠端儲存庫。",
142
+ GIT_REMOTE_NOT_CONFIGURED: "請先建立 GitHub 儲存庫。",
143
+ GIT_TIMEOUT: "Git 操作逾時。",
144
+ GIT_OPERATION_FAILED: "無法完成 Git 操作。",
145
+ };
@@ -16,8 +16,10 @@ function staticIconExists(name) {
16
16
  try {
17
17
  return fs.statSync(staticIconPath(name)).isFile();
18
18
  }
19
- catch {
20
- return false;
19
+ catch (error) {
20
+ if (error.code === "ENOENT")
21
+ return false;
22
+ throw error;
21
23
  }
22
24
  }
23
25
  /** Resolve an official Lucide slug only when a generated static SVG exists. */
@@ -26,15 +28,11 @@ export function resolveLucideIconName(value) {
26
28
  if (!name)
27
29
  return null;
28
30
  if (!selectableIconNames) {
29
- try {
30
- const manifest = JSON.parse(fs.readFileSync(path.join(staticIconDirectory, "manifest.json"), "utf8"));
31
- if (!Array.isArray(manifest.selectableIconNames))
32
- return null;
33
- selectableIconNames = new Set(manifest.selectableIconNames);
34
- }
35
- catch {
36
- return null;
31
+ const manifest = JSON.parse(fs.readFileSync(path.join(staticIconDirectory, "manifest.json"), "utf8"));
32
+ if (!Array.isArray(manifest.selectableIconNames) || manifest.selectableIconNames.some((name) => typeof name !== "string")) {
33
+ throw new Error("Invalid generated Lucide icon manifest");
37
34
  }
35
+ selectableIconNames = new Set(manifest.selectableIconNames);
38
36
  }
39
37
  return selectableIconNames.has(name) && staticIconExists(name) ? name : null;
40
38
  }
@@ -46,17 +44,16 @@ export async function lucideIconSvg(value) {
46
44
  const cached = svgCache.get(name);
47
45
  if (cached !== undefined)
48
46
  return cached;
49
- if (!staticIconExists(name)) {
50
- svgCache.set(name, null);
51
- return null;
52
- }
53
47
  try {
54
48
  const svg = await fs.promises.readFile(staticIconPath(name), "utf8");
55
49
  svgCache.set(name, svg);
56
50
  return svg;
57
51
  }
58
- catch {
59
- svgCache.set(name, null);
60
- return null;
52
+ catch (error) {
53
+ if (error.code === "ENOENT") {
54
+ svgCache.set(name, null);
55
+ return null;
56
+ }
57
+ throw error;
61
58
  }
62
59
  }
@@ -8,6 +8,16 @@ import { SourceFlushError } from "./http.js";
8
8
  */
9
9
  export class ProjectMutationCoordinator {
10
10
  collaboration;
11
+ externalWriters = new Map();
12
+ exclusivePending = new Map();
13
+ /** Source-tree replacement ends external writers before reserving the short queue. */
14
+ registerExternalWriter(projectId, stop) {
15
+ if (this.exclusivePending.has(projectId) || this.externalWriters.has(projectId))
16
+ return null;
17
+ this.externalWriters.set(projectId, stop);
18
+ return () => { if (this.externalWriters.get(projectId) === stop)
19
+ this.externalWriters.delete(projectId); };
20
+ }
11
21
  queues = new Map();
12
22
  /**
13
23
  * Compilation is deliberately not represented by the ordinary project
@@ -29,8 +39,14 @@ export class ProjectMutationCoordinator {
29
39
  return this.requireSuccessfulFlush(this.collaboration.flushProject(projectId));
30
40
  }
31
41
  async runExclusive(projectId, reason, operation, options = {}) {
42
+ this.exclusivePending.set(projectId, (this.exclusivePending.get(projectId) ?? 0) + 1);
32
43
  const exclusion = this.beginCompileExclusion(projectId);
33
44
  try {
45
+ const stopWriter = this.externalWriters.get(projectId);
46
+ if (stopWriter) {
47
+ options.preflight?.();
48
+ await stopWriter();
49
+ }
34
50
  // Do not reserve the ordinary queue until active compilations have
35
51
  // drained. Otherwise a compile waiting for a short snapshot lock could
36
52
  // deadlock behind this exclusive operation.
@@ -61,6 +77,11 @@ export class ProjectMutationCoordinator {
61
77
  }
62
78
  finally {
63
79
  exclusion.release();
80
+ const pending = this.exclusivePending.get(projectId) - 1;
81
+ if (pending)
82
+ this.exclusivePending.set(projectId, pending);
83
+ else
84
+ this.exclusivePending.delete(projectId);
64
85
  }
65
86
  }
66
87
  /**