docrev 0.11.2 → 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 (205) hide show
  1. package/CHANGELOG.md +27 -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/annotations.d.ts.map +1 -1
  6. package/dist/lib/annotations.js +28 -0
  7. package/dist/lib/annotations.js.map +1 -1
  8. package/dist/lib/build.d.ts +43 -0
  9. package/dist/lib/build.d.ts.map +1 -1
  10. package/dist/lib/build.js +175 -5
  11. package/dist/lib/build.js.map +1 -1
  12. package/dist/lib/commands/build.d.ts.map +1 -1
  13. package/dist/lib/commands/build.js +39 -125
  14. package/dist/lib/commands/build.js.map +1 -1
  15. package/dist/lib/commands/comments.d.ts.map +1 -1
  16. package/dist/lib/commands/comments.js +61 -31
  17. package/dist/lib/commands/comments.js.map +1 -1
  18. package/dist/lib/commands/context.d.ts +12 -0
  19. package/dist/lib/commands/context.d.ts.map +1 -1
  20. package/dist/lib/commands/context.js +34 -0
  21. package/dist/lib/commands/context.js.map +1 -1
  22. package/dist/lib/commands/core.d.ts.map +1 -1
  23. package/dist/lib/commands/core.js +25 -8
  24. package/dist/lib/commands/core.js.map +1 -1
  25. package/dist/lib/commands/merge-resolve.js +1 -1
  26. package/dist/lib/commands/merge-resolve.js.map +1 -1
  27. package/dist/lib/commands/quality.js +2 -2
  28. package/dist/lib/commands/quality.js.map +1 -1
  29. package/dist/lib/commands/response.js +1 -1
  30. package/dist/lib/commands/response.js.map +1 -1
  31. package/dist/lib/commands/sections.js +1 -1
  32. package/dist/lib/commands/sections.js.map +1 -1
  33. package/dist/lib/commands/text-ops.js +1 -1
  34. package/dist/lib/commands/text-ops.js.map +1 -1
  35. package/dist/lib/commands/utilities.d.ts.map +1 -1
  36. package/dist/lib/commands/utilities.js +5 -2
  37. package/dist/lib/commands/utilities.js.map +1 -1
  38. package/dist/lib/commands/word-tools.js +2 -2
  39. package/dist/lib/commands/word-tools.js.map +1 -1
  40. package/dist/lib/crossref.d.ts.map +1 -1
  41. package/dist/lib/crossref.js +12 -41
  42. package/dist/lib/crossref.js.map +1 -1
  43. package/dist/lib/csl.d.ts.map +1 -1
  44. package/dist/lib/csl.js +14 -22
  45. package/dist/lib/csl.js.map +1 -1
  46. package/dist/lib/diff-engine.js +1 -1
  47. package/dist/lib/diff-engine.js.map +1 -1
  48. package/dist/lib/equations.d.ts.map +1 -1
  49. package/dist/lib/equations.js +12 -3
  50. package/dist/lib/equations.js.map +1 -1
  51. package/dist/lib/errors.d.ts.map +1 -1
  52. package/dist/lib/errors.js +1 -30
  53. package/dist/lib/errors.js.map +1 -1
  54. package/dist/lib/image-registry.d.ts.map +1 -1
  55. package/dist/lib/image-registry.js +4 -0
  56. package/dist/lib/image-registry.js.map +1 -1
  57. package/dist/lib/import.d.ts +15 -1
  58. package/dist/lib/import.d.ts.map +1 -1
  59. package/dist/lib/import.js +24 -1
  60. package/dist/lib/import.js.map +1 -1
  61. package/dist/lib/input.d.ts +56 -0
  62. package/dist/lib/input.d.ts.map +1 -0
  63. package/dist/lib/input.js +129 -0
  64. package/dist/lib/input.js.map +1 -0
  65. package/dist/lib/merge.d.ts.map +1 -1
  66. package/dist/lib/merge.js +9 -1
  67. package/dist/lib/merge.js.map +1 -1
  68. package/dist/lib/ooxml.d.ts +22 -0
  69. package/dist/lib/ooxml.d.ts.map +1 -1
  70. package/dist/lib/ooxml.js +130 -0
  71. package/dist/lib/ooxml.js.map +1 -1
  72. package/dist/lib/orcid.d.ts.map +1 -1
  73. package/dist/lib/orcid.js +16 -7
  74. package/dist/lib/orcid.js.map +1 -1
  75. package/dist/lib/plugins.d.ts.map +1 -1
  76. package/dist/lib/plugins.js +8 -4
  77. package/dist/lib/plugins.js.map +1 -1
  78. package/dist/lib/protect-restore.d.ts.map +1 -1
  79. package/dist/lib/protect-restore.js +7 -5
  80. package/dist/lib/protect-restore.js.map +1 -1
  81. package/dist/lib/response.d.ts +1 -1
  82. package/dist/lib/response.d.ts.map +1 -1
  83. package/dist/lib/response.js +5 -2
  84. package/dist/lib/response.js.map +1 -1
  85. package/dist/lib/restore-references.d.ts.map +1 -1
  86. package/dist/lib/restore-references.js +25 -3
  87. package/dist/lib/restore-references.js.map +1 -1
  88. package/dist/lib/schema.d.ts.map +1 -1
  89. package/dist/lib/schema.js +1 -19
  90. package/dist/lib/schema.js.map +1 -1
  91. package/dist/lib/slides.js +1 -1
  92. package/dist/lib/slides.js.map +1 -1
  93. package/dist/lib/spelling.js +1 -1
  94. package/dist/lib/spelling.js.map +1 -1
  95. package/dist/lib/tui.js +0 -1
  96. package/dist/lib/tui.js.map +1 -1
  97. package/dist/lib/utils.d.ts +14 -0
  98. package/dist/lib/utils.d.ts.map +1 -1
  99. package/dist/lib/utils.js +41 -0
  100. package/dist/lib/utils.js.map +1 -1
  101. package/dist/lib/word-extraction.d.ts +5 -5
  102. package/dist/lib/word-extraction.d.ts.map +1 -1
  103. package/dist/lib/word-extraction.js +25 -106
  104. package/dist/lib/word-extraction.js.map +1 -1
  105. package/dist/lib/word.d.ts +14 -38
  106. package/dist/lib/word.d.ts.map +1 -1
  107. package/dist/lib/word.js +24 -179
  108. package/dist/lib/word.js.map +1 -1
  109. package/dist/lib/wordcomments.d.ts.map +1 -1
  110. package/dist/lib/wordcomments.js +9 -7
  111. package/dist/lib/wordcomments.js.map +1 -1
  112. package/package.json +17 -6
  113. package/.gitattributes +0 -1
  114. package/PLAN-tables-and-postprocess.md +0 -850
  115. package/bin/rev.ts +0 -145
  116. package/docs-src/build.py +0 -113
  117. package/docs-src/extra.css +0 -208
  118. package/docs-src/md-to-html.lua +0 -6
  119. package/docs-src/template.html +0 -116
  120. package/eslint.config.js +0 -27
  121. package/lib/anchor-match.ts +0 -307
  122. package/lib/annotations.ts +0 -664
  123. package/lib/build.ts +0 -2047
  124. package/lib/citations.ts +0 -160
  125. package/lib/commands/build.ts +0 -885
  126. package/lib/commands/citations.ts +0 -515
  127. package/lib/commands/comments.ts +0 -1050
  128. package/lib/commands/context.ts +0 -176
  129. package/lib/commands/core.ts +0 -309
  130. package/lib/commands/doi.ts +0 -451
  131. package/lib/commands/file-ops.ts +0 -372
  132. package/lib/commands/history.ts +0 -320
  133. package/lib/commands/index.ts +0 -87
  134. package/lib/commands/init.ts +0 -259
  135. package/lib/commands/merge-resolve.ts +0 -378
  136. package/lib/commands/preview.ts +0 -178
  137. package/lib/commands/project-info.ts +0 -244
  138. package/lib/commands/quality.ts +0 -517
  139. package/lib/commands/response.ts +0 -454
  140. package/lib/commands/section-boundaries.ts +0 -82
  141. package/lib/commands/sections.ts +0 -451
  142. package/lib/commands/sync.ts +0 -689
  143. package/lib/commands/text-ops.ts +0 -449
  144. package/lib/commands/utilities.ts +0 -448
  145. package/lib/commands/verify-anchors.ts +0 -272
  146. package/lib/commands/word-tools.ts +0 -340
  147. package/lib/comment-realign.ts +0 -99
  148. package/lib/config.ts +0 -84
  149. package/lib/crossref.ts +0 -781
  150. package/lib/csl.ts +0 -191
  151. package/lib/dependencies.ts +0 -132
  152. package/lib/diff-engine.ts +0 -465
  153. package/lib/doi-cache.ts +0 -115
  154. package/lib/doi.ts +0 -879
  155. package/lib/equations.ts +0 -506
  156. package/lib/errors.ts +0 -350
  157. package/lib/format.ts +0 -541
  158. package/lib/git.ts +0 -326
  159. package/lib/grammar.ts +0 -303
  160. package/lib/image-registry.ts +0 -180
  161. package/lib/import.ts +0 -906
  162. package/lib/journals.ts +0 -543
  163. package/lib/macro-filter.lua +0 -201
  164. package/lib/macros.ts +0 -273
  165. package/lib/merge.ts +0 -633
  166. package/lib/ooxml.ts +0 -768
  167. package/lib/orcid.ts +0 -144
  168. package/lib/pdf-comments.ts +0 -263
  169. package/lib/pdf-import.ts +0 -524
  170. package/lib/plugins.ts +0 -362
  171. package/lib/postprocess.ts +0 -188
  172. package/lib/pptx-color-filter.lua +0 -37
  173. package/lib/pptx-template.ts +0 -469
  174. package/lib/pptx-themes/academic.pptx +0 -0
  175. package/lib/pptx-themes/corporate.pptx +0 -0
  176. package/lib/pptx-themes/dark.pptx +0 -0
  177. package/lib/pptx-themes/default.pptx +0 -0
  178. package/lib/pptx-themes/minimal.pptx +0 -0
  179. package/lib/pptx-themes/plant.pptx +0 -0
  180. package/lib/pptx-themes.ts +0 -483
  181. package/lib/protect-restore.ts +0 -520
  182. package/lib/rate-limiter.ts +0 -127
  183. package/lib/response.ts +0 -197
  184. package/lib/restore-references.ts +0 -240
  185. package/lib/review.ts +0 -327
  186. package/lib/schema.ts +0 -494
  187. package/lib/scientific-words.ts +0 -73
  188. package/lib/sections.ts +0 -428
  189. package/lib/slides.ts +0 -756
  190. package/lib/spelling.ts +0 -334
  191. package/lib/templates.ts +0 -526
  192. package/lib/themes.ts +0 -742
  193. package/lib/trackchanges.ts +0 -166
  194. package/lib/tui.ts +0 -450
  195. package/lib/types.ts +0 -546
  196. package/lib/undo.ts +0 -250
  197. package/lib/utils.ts +0 -69
  198. package/lib/variables.ts +0 -179
  199. package/lib/word-extraction.ts +0 -525
  200. package/lib/word.ts +0 -526
  201. package/lib/wordcomments.ts +0 -789
  202. package/mkdocs.yml +0 -64
  203. package/scripts/postbuild.js +0 -47
  204. package/tsconfig.json +0 -26
  205. 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
- }