docrev 0.11.3 → 0.12.0

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 (193) hide show
  1. package/CHANGELOG.md +22 -0
  2. package/LICENSE +21 -0
  3. package/dist/bin/rev.js +29 -21
  4. package/dist/bin/rev.js.map +1 -1
  5. package/dist/lib/build.d.ts +43 -0
  6. package/dist/lib/build.d.ts.map +1 -1
  7. package/dist/lib/build.js +175 -5
  8. package/dist/lib/build.js.map +1 -1
  9. package/dist/lib/commands/build.d.ts.map +1 -1
  10. package/dist/lib/commands/build.js +39 -125
  11. package/dist/lib/commands/build.js.map +1 -1
  12. package/dist/lib/commands/comments.js +3 -3
  13. package/dist/lib/commands/comments.js.map +1 -1
  14. package/dist/lib/commands/context.d.ts +12 -1
  15. package/dist/lib/commands/context.d.ts.map +1 -1
  16. package/dist/lib/commands/context.js +34 -1
  17. package/dist/lib/commands/context.js.map +1 -1
  18. package/dist/lib/commands/merge-resolve.js +1 -1
  19. package/dist/lib/commands/merge-resolve.js.map +1 -1
  20. package/dist/lib/commands/quality.js +2 -2
  21. package/dist/lib/commands/quality.js.map +1 -1
  22. package/dist/lib/commands/sections.js +1 -1
  23. package/dist/lib/commands/sections.js.map +1 -1
  24. package/dist/lib/commands/text-ops.js +1 -1
  25. package/dist/lib/commands/text-ops.js.map +1 -1
  26. package/dist/lib/commands/utilities.d.ts.map +1 -1
  27. package/dist/lib/commands/utilities.js +5 -2
  28. package/dist/lib/commands/utilities.js.map +1 -1
  29. package/dist/lib/commands/word-tools.js +2 -2
  30. package/dist/lib/commands/word-tools.js.map +1 -1
  31. package/dist/lib/crossref.d.ts.map +1 -1
  32. package/dist/lib/crossref.js +12 -41
  33. package/dist/lib/crossref.js.map +1 -1
  34. package/dist/lib/csl.d.ts.map +1 -1
  35. package/dist/lib/csl.js +14 -22
  36. package/dist/lib/csl.js.map +1 -1
  37. package/dist/lib/diff-engine.js +1 -1
  38. package/dist/lib/diff-engine.js.map +1 -1
  39. package/dist/lib/equations.d.ts.map +1 -1
  40. package/dist/lib/equations.js +12 -3
  41. package/dist/lib/equations.js.map +1 -1
  42. package/dist/lib/errors.d.ts.map +1 -1
  43. package/dist/lib/errors.js +1 -30
  44. package/dist/lib/errors.js.map +1 -1
  45. package/dist/lib/image-registry.d.ts.map +1 -1
  46. package/dist/lib/image-registry.js +4 -0
  47. package/dist/lib/image-registry.js.map +1 -1
  48. package/dist/lib/import.d.ts +1 -1
  49. package/dist/lib/import.d.ts.map +1 -1
  50. package/dist/lib/import.js +1 -1
  51. package/dist/lib/import.js.map +1 -1
  52. package/dist/lib/input.d.ts +0 -11
  53. package/dist/lib/input.d.ts.map +1 -1
  54. package/dist/lib/input.js +0 -35
  55. package/dist/lib/input.js.map +1 -1
  56. package/dist/lib/merge.d.ts.map +1 -1
  57. package/dist/lib/merge.js +9 -1
  58. package/dist/lib/merge.js.map +1 -1
  59. package/dist/lib/ooxml.d.ts +22 -0
  60. package/dist/lib/ooxml.d.ts.map +1 -1
  61. package/dist/lib/ooxml.js +130 -0
  62. package/dist/lib/ooxml.js.map +1 -1
  63. package/dist/lib/orcid.d.ts.map +1 -1
  64. package/dist/lib/orcid.js +16 -7
  65. package/dist/lib/orcid.js.map +1 -1
  66. package/dist/lib/plugins.d.ts.map +1 -1
  67. package/dist/lib/plugins.js +8 -4
  68. package/dist/lib/plugins.js.map +1 -1
  69. package/dist/lib/protect-restore.d.ts.map +1 -1
  70. package/dist/lib/protect-restore.js +7 -5
  71. package/dist/lib/protect-restore.js.map +1 -1
  72. package/dist/lib/restore-references.d.ts.map +1 -1
  73. package/dist/lib/restore-references.js +25 -3
  74. package/dist/lib/restore-references.js.map +1 -1
  75. package/dist/lib/schema.d.ts.map +1 -1
  76. package/dist/lib/schema.js +1 -19
  77. package/dist/lib/schema.js.map +1 -1
  78. package/dist/lib/slides.js +1 -1
  79. package/dist/lib/slides.js.map +1 -1
  80. package/dist/lib/spelling.js +1 -1
  81. package/dist/lib/spelling.js.map +1 -1
  82. package/dist/lib/tui.js +0 -1
  83. package/dist/lib/tui.js.map +1 -1
  84. package/dist/lib/utils.d.ts +14 -0
  85. package/dist/lib/utils.d.ts.map +1 -1
  86. package/dist/lib/utils.js +41 -0
  87. package/dist/lib/utils.js.map +1 -1
  88. package/dist/lib/word-extraction.d.ts +5 -5
  89. package/dist/lib/word-extraction.d.ts.map +1 -1
  90. package/dist/lib/word-extraction.js +25 -106
  91. package/dist/lib/word-extraction.js.map +1 -1
  92. package/dist/lib/word.d.ts +14 -38
  93. package/dist/lib/word.d.ts.map +1 -1
  94. package/dist/lib/word.js +24 -179
  95. package/dist/lib/word.js.map +1 -1
  96. package/dist/lib/wordcomments.d.ts.map +1 -1
  97. package/dist/lib/wordcomments.js +9 -7
  98. package/dist/lib/wordcomments.js.map +1 -1
  99. package/package.json +17 -6
  100. package/.gitattributes +0 -1
  101. package/PLAN-tables-and-postprocess.md +0 -850
  102. package/bin/rev.ts +0 -145
  103. package/docs-src/build.py +0 -113
  104. package/docs-src/extra.css +0 -208
  105. package/docs-src/md-to-html.lua +0 -6
  106. package/docs-src/template.html +0 -116
  107. package/eslint.config.js +0 -27
  108. package/lib/anchor-match.ts +0 -307
  109. package/lib/annotations.ts +0 -695
  110. package/lib/build.ts +0 -2047
  111. package/lib/citations.ts +0 -160
  112. package/lib/commands/build.ts +0 -885
  113. package/lib/commands/citations.ts +0 -515
  114. package/lib/commands/comments.ts +0 -1077
  115. package/lib/commands/context.ts +0 -185
  116. package/lib/commands/core.ts +0 -328
  117. package/lib/commands/doi.ts +0 -451
  118. package/lib/commands/file-ops.ts +0 -372
  119. package/lib/commands/history.ts +0 -320
  120. package/lib/commands/index.ts +0 -87
  121. package/lib/commands/init.ts +0 -259
  122. package/lib/commands/merge-resolve.ts +0 -378
  123. package/lib/commands/preview.ts +0 -178
  124. package/lib/commands/project-info.ts +0 -244
  125. package/lib/commands/quality.ts +0 -517
  126. package/lib/commands/response.ts +0 -454
  127. package/lib/commands/section-boundaries.ts +0 -82
  128. package/lib/commands/sections.ts +0 -451
  129. package/lib/commands/sync.ts +0 -689
  130. package/lib/commands/text-ops.ts +0 -449
  131. package/lib/commands/utilities.ts +0 -448
  132. package/lib/commands/verify-anchors.ts +0 -272
  133. package/lib/commands/word-tools.ts +0 -340
  134. package/lib/comment-realign.ts +0 -99
  135. package/lib/config.ts +0 -84
  136. package/lib/crossref.ts +0 -781
  137. package/lib/csl.ts +0 -191
  138. package/lib/dependencies.ts +0 -132
  139. package/lib/diff-engine.ts +0 -465
  140. package/lib/doi-cache.ts +0 -115
  141. package/lib/doi.ts +0 -879
  142. package/lib/equations.ts +0 -506
  143. package/lib/errors.ts +0 -350
  144. package/lib/format.ts +0 -541
  145. package/lib/git.ts +0 -326
  146. package/lib/grammar.ts +0 -303
  147. package/lib/image-registry.ts +0 -180
  148. package/lib/import.ts +0 -932
  149. package/lib/input.ts +0 -174
  150. package/lib/journals.ts +0 -543
  151. package/lib/macro-filter.lua +0 -201
  152. package/lib/macros.ts +0 -273
  153. package/lib/merge.ts +0 -633
  154. package/lib/ooxml.ts +0 -768
  155. package/lib/orcid.ts +0 -144
  156. package/lib/pdf-comments.ts +0 -263
  157. package/lib/pdf-import.ts +0 -524
  158. package/lib/plugins.ts +0 -362
  159. package/lib/postprocess.ts +0 -188
  160. package/lib/pptx-color-filter.lua +0 -37
  161. package/lib/pptx-template.ts +0 -469
  162. package/lib/pptx-themes/academic.pptx +0 -0
  163. package/lib/pptx-themes/corporate.pptx +0 -0
  164. package/lib/pptx-themes/dark.pptx +0 -0
  165. package/lib/pptx-themes/default.pptx +0 -0
  166. package/lib/pptx-themes/minimal.pptx +0 -0
  167. package/lib/pptx-themes/plant.pptx +0 -0
  168. package/lib/pptx-themes.ts +0 -483
  169. package/lib/protect-restore.ts +0 -520
  170. package/lib/rate-limiter.ts +0 -127
  171. package/lib/response.ts +0 -200
  172. package/lib/restore-references.ts +0 -240
  173. package/lib/review.ts +0 -327
  174. package/lib/schema.ts +0 -494
  175. package/lib/scientific-words.ts +0 -73
  176. package/lib/sections.ts +0 -428
  177. package/lib/slides.ts +0 -756
  178. package/lib/spelling.ts +0 -334
  179. package/lib/templates.ts +0 -526
  180. package/lib/themes.ts +0 -742
  181. package/lib/trackchanges.ts +0 -166
  182. package/lib/tui.ts +0 -450
  183. package/lib/types.ts +0 -546
  184. package/lib/undo.ts +0 -250
  185. package/lib/utils.ts +0 -69
  186. package/lib/variables.ts +0 -179
  187. package/lib/word-extraction.ts +0 -525
  188. package/lib/word.ts +0 -526
  189. package/lib/wordcomments.ts +0 -789
  190. package/mkdocs.yml +0 -64
  191. package/scripts/postbuild.js +0 -47
  192. package/tsconfig.json +0 -26
  193. package/types/index.d.ts +0 -531
package/lib/templates.ts DELETED
@@ -1,526 +0,0 @@
1
- /**
2
- * Built-in templates for project scaffolding
3
- *
4
- * Used by `rev new` command to create new paper projects
5
- */
6
-
7
- interface TemplateDefinition {
8
- name: string;
9
- description: string;
10
- files: Record<string, string>;
11
- directories: string[];
12
- }
13
-
14
- export const TEMPLATES: Record<string, TemplateDefinition> = {
15
- /**
16
- * Standard academic paper structure
17
- */
18
- paper: {
19
- name: 'Academic Paper',
20
- description: 'Standard paper with introduction, methods, results, discussion',
21
- files: {
22
- 'rev.yaml': `# Paper configuration
23
- title: "Your Paper Title"
24
- authors:
25
- - name: First Author
26
- affiliation: Institution
27
- email: author@example.com
28
-
29
- # Section files in order
30
- sections:
31
- - introduction.md
32
- - methods.md
33
- - results.md
34
- - discussion.md
35
-
36
- # Bibliography (optional)
37
- bibliography: references.bib
38
- csl: null # uses default CSL
39
-
40
- # Cross-reference settings
41
- crossref:
42
- figureTitle: Figure
43
- tableTitle: Table
44
- figPrefix: [Fig., Figs.]
45
- tblPrefix: [Table, Tables]
46
- linkReferences: true
47
-
48
- # PDF output settings
49
- pdf:
50
- documentclass: article
51
- fontsize: 12pt
52
- geometry: margin=1in
53
- linestretch: 1.5
54
- numbersections: false
55
-
56
- # Word output settings
57
- docx:
58
- reference: null # path to reference.docx template
59
- keepComments: true
60
- `,
61
- 'introduction.md': `# Introduction
62
-
63
- Your introduction goes here. Use dynamic figure references like @fig:example.
64
-
65
- `,
66
- 'methods.md': `# Methods
67
-
68
- ## Study Design
69
-
70
- Describe your methodology here.
71
-
72
- ## Data Analysis
73
-
74
- Reference tables with @tbl:summary.
75
-
76
- `,
77
- 'results.md': `# Results
78
-
79
- Present your findings. See @fig:results for the main analysis.
80
-
81
- ![Example figure caption](figures/placeholder.png){#fig:results}
82
-
83
- `,
84
- 'discussion.md': `# Discussion
85
-
86
- Interpret your results here.
87
-
88
- ## Conclusions
89
-
90
- Summarize key findings.
91
-
92
- `,
93
- 'references.bib': `@article{example2024,
94
- author = {Author, A. and Coauthor, B.},
95
- title = {An Example Paper Title},
96
- journal = {Journal Name},
97
- year = {2024},
98
- volume = {1},
99
- pages = {1--10}
100
- }
101
- `,
102
- '.gitignore': `# Build outputs
103
- *.pdf
104
- *.docx
105
- *.tex
106
- paper.md
107
- .paper-*.md
108
-
109
- # System
110
- .DS_Store
111
- `,
112
- },
113
- directories: ['figures'],
114
- },
115
-
116
- /**
117
- * Minimal single-section document
118
- */
119
- minimal: {
120
- name: 'Minimal',
121
- description: 'Single document with basic config',
122
- files: {
123
- 'rev.yaml': `title: "Document Title"
124
- authors: []
125
- sections:
126
- - content.md
127
- `,
128
- 'content.md': `# Your Document
129
-
130
- Write your content here.
131
-
132
- `,
133
- },
134
- directories: [],
135
- },
136
-
137
- /**
138
- * Thesis chapter structure
139
- */
140
- thesis: {
141
- name: 'Thesis Chapter',
142
- description: 'Thesis-style with abstract, sections, appendix',
143
- files: {
144
- 'rev.yaml': `title: "Chapter Title"
145
- authors:
146
- - name: Your Name
147
- affiliation: University
148
-
149
- sections:
150
- - abstract.md
151
- - introduction.md
152
- - literature.md
153
- - methods.md
154
- - results.md
155
- - discussion.md
156
- - conclusion.md
157
- - appendix.md
158
-
159
- bibliography: references.bib
160
-
161
- pdf:
162
- documentclass: report
163
- fontsize: 11pt
164
- geometry: "margin=1in"
165
- linestretch: 2
166
- numbersections: true
167
- `,
168
- 'abstract.md': `# Abstract
169
-
170
- Brief summary of the chapter (150-300 words).
171
-
172
- `,
173
- 'introduction.md': `# Introduction
174
-
175
- Background and research questions.
176
-
177
- `,
178
- 'literature.md': `# Literature Review
179
-
180
- Review of relevant prior work.
181
-
182
- `,
183
- 'methods.md': `# Materials and Methods
184
-
185
- Detailed methodology.
186
-
187
- `,
188
- 'results.md': `# Results
189
-
190
- Findings and analysis.
191
-
192
- `,
193
- 'discussion.md': `# Discussion
194
-
195
- Interpretation of results.
196
-
197
- `,
198
- 'conclusion.md': `# Conclusion
199
-
200
- Summary and implications.
201
-
202
- `,
203
- 'appendix.md': `# Appendix
204
-
205
- ## Supplementary Materials
206
-
207
- Additional details here.
208
-
209
- `,
210
- 'references.bib': ``,
211
- '.gitignore': `*.pdf
212
- *.docx
213
- *.tex
214
- paper.md
215
- .paper-*.md
216
- .DS_Store
217
- `,
218
- },
219
- directories: ['figures', 'tables'],
220
- },
221
-
222
- /**
223
- * LaTeX-focused project with direct .tex output
224
- */
225
- latex: {
226
- name: 'LaTeX Project',
227
- description: 'LaTeX-native with journal template support',
228
- files: {
229
- 'rev.yaml': `# LaTeX Paper Configuration
230
- title: "Paper Title"
231
- authors:
232
- - name: First Author
233
- affiliation: University
234
- email: author@example.edu
235
- orcid: 0000-0000-0000-0000
236
-
237
- sections:
238
- - introduction.md
239
- - methods.md
240
- - results.md
241
- - discussion.md
242
-
243
- bibliography: references.bib
244
- csl: null
245
-
246
- # LaTeX-specific settings
247
- pdf:
248
- documentclass: article
249
- classoption: [11pt, a4paper]
250
- fontsize: 11pt
251
- geometry: "margin=2.5cm"
252
- linestretch: 1.5
253
- numbersections: true
254
- header-includes: |
255
- \\usepackage{amsmath}
256
- \\usepackage{graphicx}
257
- \\usepackage{booktabs}
258
- \\usepackage{hyperref}
259
- \\usepackage{natbib}
260
-
261
- # TEX output settings
262
- tex:
263
- standalone: true
264
- keep-tex: true
265
- `,
266
- 'introduction.md': `# Introduction
267
-
268
- Background and motivation.
269
-
270
- ## Objectives
271
-
272
- State your research questions.
273
-
274
- `,
275
- 'methods.md': `# Materials and Methods
276
-
277
- ## Study Area
278
-
279
- Describe the study area or data sources.
280
-
281
- ## Statistical Analysis
282
-
283
- All analyses were performed in R [@R2024].
284
-
285
- `,
286
- 'results.md': `# Results
287
-
288
- Main findings presented here.
289
-
290
- ![Caption for figure](figures/fig1.pdf){#fig:main width=100%}
291
-
292
- See @fig:main for the main results.
293
-
294
- | Variable | Value | SE |
295
- |----------|-------|------|
296
- | A | 1.23 | 0.05 |
297
- | B | 4.56 | 0.12 |
298
-
299
- : Summary statistics {#tbl:summary}
300
-
301
- `,
302
- 'discussion.md': `# Discussion
303
-
304
- Interpretation of findings.
305
-
306
- ## Limitations
307
-
308
- Study limitations.
309
-
310
- ## Conclusions
311
-
312
- Key takeaways.
313
-
314
- `,
315
- 'references.bib': `@Manual{R2024,
316
- title = {R: A Language and Environment for Statistical Computing},
317
- author = {{R Core Team}},
318
- organization = {R Foundation for Statistical Computing},
319
- address = {Vienna, Austria},
320
- year = {2024},
321
- url = {https://www.R-project.org/}
322
- }
323
- `,
324
- '.gitignore': `# Build outputs
325
- *.pdf
326
- *.docx
327
- paper.md
328
- .paper-*.md
329
-
330
- # Keep .tex for version control
331
- # *.tex
332
-
333
- # LaTeX auxiliary files
334
- *.aux
335
- *.bbl
336
- *.blg
337
- *.log
338
- *.out
339
- *.toc
340
- *.fdb_latexmk
341
- *.fls
342
- *.synctex.gz
343
-
344
- # System
345
- .DS_Store
346
- `,
347
- },
348
- directories: ['figures', 'tables'],
349
- },
350
-
351
- /**
352
- * Review article structure
353
- */
354
- review: {
355
- name: 'Review Article',
356
- description: 'Literature review or synthesis paper',
357
- files: {
358
- 'rev.yaml': `title: "Review Title"
359
- authors:
360
- - name: Author Name
361
- affiliation: Institution
362
-
363
- sections:
364
- - introduction.md
365
- - section1.md
366
- - section2.md
367
- - section3.md
368
- - synthesis.md
369
- - conclusion.md
370
-
371
- bibliography: references.bib
372
-
373
- crossref:
374
- figureTitle: Figure
375
- tableTitle: Table
376
- figPrefix: [Fig., Figs.]
377
- tblPrefix: [Table, Tables]
378
- `,
379
- 'introduction.md': `# Introduction
380
-
381
- Scope and objectives of the review.
382
-
383
- `,
384
- 'section1.md': `# Theme One
385
-
386
- First major theme or topic.
387
-
388
- `,
389
- 'section2.md': `# Theme Two
390
-
391
- Second major theme.
392
-
393
- `,
394
- 'section3.md': `# Theme Three
395
-
396
- Third major theme.
397
-
398
- `,
399
- 'synthesis.md': `# Synthesis
400
-
401
- Integration of themes and emerging patterns.
402
-
403
- `,
404
- 'conclusion.md': `# Conclusion and Future Directions
405
-
406
- Key takeaways and research gaps.
407
-
408
- `,
409
- 'references.bib': ``,
410
- '.gitignore': `*.pdf
411
- *.docx
412
- *.tex
413
- paper.md
414
- .paper-*.md
415
- .DS_Store
416
- `,
417
- },
418
- directories: ['figures'],
419
- },
420
- };
421
-
422
- /**
423
- * Get template by name
424
- */
425
- export function getTemplate(name: string): TemplateDefinition | null {
426
- return TEMPLATES[name.toLowerCase()] || null;
427
- }
428
-
429
- /**
430
- * List available templates
431
- */
432
- export function listTemplates(): Array<{ id: string; name: string; description: string }> {
433
- return Object.entries(TEMPLATES).map(([id, template]) => ({
434
- id,
435
- name: template.name,
436
- description: template.description,
437
- }));
438
- }
439
-
440
- /**
441
- * Convert string to title case for headers
442
- */
443
- function titleCase(str: string): string {
444
- return str
445
- .split(/[-_\s]+/)
446
- .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
447
- .join(' ');
448
- }
449
-
450
- /**
451
- * Generate a custom template with specified sections
452
- */
453
- export function generateCustomTemplate(
454
- sections: string[],
455
- baseTemplate?: TemplateDefinition
456
- ): TemplateDefinition {
457
- const base = baseTemplate || TEMPLATES.paper;
458
- const files: Record<string, string> = {};
459
-
460
- // Generate rev.yaml with custom sections
461
- const sectionsList = sections.map((s) => ` - ${s}.md`).join('\n');
462
- files['rev.yaml'] = `# Paper configuration
463
- title: "Your Paper Title"
464
- authors:
465
- - name: First Author
466
- affiliation: Institution
467
- email: author@example.com
468
-
469
- # Section files in order
470
- sections:
471
- ${sectionsList}
472
-
473
- # Bibliography (optional)
474
- bibliography: references.bib
475
- csl: null # uses default CSL
476
-
477
- # Cross-reference settings
478
- crossref:
479
- figureTitle: Figure
480
- tableTitle: Table
481
- figPrefix: [Fig., Figs.]
482
- tblPrefix: [Table, Tables]
483
- linkReferences: true
484
-
485
- # PDF output settings
486
- pdf:
487
- documentclass: article
488
- fontsize: 12pt
489
- geometry: margin=1in
490
- linestretch: 1.5
491
- numbersections: false
492
-
493
- # Word output settings
494
- docx:
495
- reference: null # path to reference.docx template
496
- keepComments: true
497
- `;
498
-
499
- // Generate section files
500
- for (const section of sections) {
501
- const header = titleCase(section);
502
- files[`${section}.md`] = `# ${header}
503
-
504
- `;
505
- }
506
-
507
- // Add common files
508
- files['references.bib'] = base.files['references.bib'] || '';
509
- files['.gitignore'] = base.files['.gitignore'] || `# Build outputs
510
- *.pdf
511
- *.docx
512
- *.tex
513
- paper.md
514
- .paper-*.md
515
-
516
- # System
517
- .DS_Store
518
- `;
519
-
520
- return {
521
- name: 'Custom',
522
- description: 'Custom sections',
523
- files,
524
- directories: base.directories || ['figures'],
525
- };
526
- }