docrev 0.2.1 → 0.5.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.
@@ -0,0 +1,4 @@
1
+ # Custom dictionary for docrev
2
+ # Add one word per line
3
+ # Lines starting with # are comments
4
+
package/CHANGELOG.md ADDED
@@ -0,0 +1,76 @@
1
+ # Changelog
2
+
3
+ All notable changes to docrev will be documented in this file.
4
+
5
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
+ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
+
8
+ ## [0.3.2] - 2024-12-29
9
+
10
+ ### Added
11
+ - Full TypeScript type definitions (`types/index.d.ts`)
12
+ - GitHub Actions CI workflow (Node 18/20/22)
13
+ - ESM subpath exports for all library modules
14
+ - CLI integration tests (26 tests)
15
+ - Comprehensive test coverage: 419 tests across 18 modules
16
+
17
+ ### Fixed
18
+ - DOI skip detection: `% no-doi` comments now correctly apply only to the next entry
19
+
20
+ ### Changed
21
+ - Added `engines` field requiring Node.js >=18.0.0
22
+ - Updated README with badges (npm, CI, Node.js, License)
23
+
24
+ ## [0.3.1] - 2024-12-28
25
+
26
+ ### Fixed
27
+ - Equation extraction test assertions
28
+ - Minor bug fixes
29
+
30
+ ## [0.3.0] - 2024-12-27
31
+
32
+ ### Added
33
+ - DOI validation via Crossref and DataCite APIs (`rev doi check`)
34
+ - DOI lookup for missing entries (`rev doi lookup`)
35
+ - DOI fetch and add commands (`rev doi fetch`, `rev doi add`)
36
+ - Citation validation against bibliography (`rev citations`)
37
+ - LaTeX equation extraction (`rev equations list`)
38
+ - Word equation import OMML → LaTeX (`rev equations from-word`)
39
+ - Response letter generation (`rev response`)
40
+ - Journal validation profiles (`rev validate --journal`)
41
+ - Advanced figure/table reference patterns (Figs. 1-3, Fig. 1a-c)
42
+
43
+ ### Changed
44
+ - Improved cross-reference pattern detection
45
+ - Enhanced Word import with better section splitting
46
+
47
+ ## [0.2.1] - 2024-12-26
48
+
49
+ ### Added
50
+ - Table of contents option (`rev build --toc`)
51
+ - CSV export for comments (`rev comments --export`)
52
+ - Anonymize command for blind review (`rev anonymize`)
53
+ - Formatting utilities (tables, boxes, spinners)
54
+
55
+ ## [0.2.0] - 2024-12-25
56
+
57
+ ### Added
58
+ - Integrated build system (`rev build pdf/docx/tex`)
59
+ - Comment reply functionality (`rev reply`)
60
+ - Word document bootstrap (`rev import` creates project from .docx)
61
+ - Section-aware import (`rev sections`)
62
+ - Cross-reference migration (`rev migrate`)
63
+
64
+ ### Changed
65
+ - Renamed project to docrev
66
+ - Published to npm
67
+
68
+ ## [0.1.0] - 2024-12-24
69
+
70
+ ### Added
71
+ - Initial release
72
+ - CriticMarkup annotation parsing
73
+ - Word ↔ Markdown round-trips
74
+ - Interactive review TUI (`rev review`)
75
+ - Comment management (`rev comments`, `rev resolve`)
76
+ - Project templates (`rev new`)
package/README.md CHANGED
@@ -1,6 +1,9 @@
1
1
  # docrev
2
2
 
3
3
  [![npm](https://img.shields.io/npm/v/docrev)](https://www.npmjs.com/package/docrev)
4
+ [![CI](https://github.com/gcol33/docrev/actions/workflows/ci.yml/badge.svg)](https://github.com/gcol33/docrev/actions/workflows/ci.yml)
5
+ [![Node.js](https://img.shields.io/node/v/docrev)](https://nodejs.org/)
6
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
4
7
 
5
8
  CLI tool for Word ↔ Markdown round-trips. Handle reviewer feedback on academic papers: import track changes, review interactively, manage comments, validate DOIs, and build to PDF/DOCX/LaTeX.
6
9
 
@@ -35,6 +38,18 @@ rev --version
35
38
  rev install # Check for missing dependencies
36
39
  ```
37
40
 
41
+ ### Shell Completions (Optional)
42
+
43
+ Enable tab completion for `rev` commands:
44
+
45
+ ```bash
46
+ # Bash - add to ~/.bashrc
47
+ eval "$(rev completions bash)"
48
+
49
+ # Zsh - add to ~/.zshrc
50
+ eval "$(rev completions zsh)"
51
+ ```
52
+
38
53
  ## Features
39
54
 
40
55
  - **Integrated build system** - Combine sections → paper.md → PDF, DOCX, or LaTeX
@@ -118,6 +133,7 @@ rev build docx
118
133
  |---------|-------------|
119
134
  | `rev build [formats...]` | Build PDF/DOCX/TEX from sections |
120
135
  | `rev build --toc` | Build with table of contents |
136
+ | `rev build --show-changes` | Export DOCX with visible track changes |
121
137
  | `rev new <name>` | Create new project from template |
122
138
  | `rev new --list` | List available templates |
123
139
  | `rev install` | Check/install dependencies (pandoc-crossref) |
@@ -176,6 +192,16 @@ rev build docx
176
192
  | `rev equations from-word <docx>` | Extract equations from Word to LaTeX |
177
193
  | `rev response [files]` | Generate response letter from comments |
178
194
  | `rev anonymize <file>` | Prepare document for blind review |
195
+ | `rev validate --journal <name>` | Check manuscript against journal requirements |
196
+ | `rev validate --list` | List available journal profiles |
197
+
198
+ ### Multi-Reviewer & Git
199
+
200
+ | Command | Description |
201
+ |---------|-------------|
202
+ | `rev merge <md> <docx...>` | Merge feedback from multiple Word documents |
203
+ | `rev diff [ref]` | Compare sections against git history |
204
+ | `rev history [file]` | Show revision history for sections |
179
205
 
180
206
  ### Configuration
181
207
 
@@ -185,6 +211,48 @@ rev build docx
185
211
  | `rev split <file>` | Split annotated paper.md back to section files |
186
212
  | `rev help [topic]` | Show help (topics: workflow, syntax, commands) |
187
213
 
214
+ ### Convenience Commands
215
+
216
+ | Command | Description |
217
+ |---------|-------------|
218
+ | `rev word-count` | Show word counts per section |
219
+ | `rev word-count -j <journal>` | Warn if over journal word limit |
220
+ | `rev stats` | Project dashboard (words, figures, citations) |
221
+ | `rev search <query>` | Search across all section files |
222
+ | `rev backup` | Create timestamped backup zip |
223
+ | `rev export` | Export project as distributable zip |
224
+ | `rev preview <format>` | Build and open document |
225
+ | `rev watch [format]` | Auto-rebuild on file changes |
226
+ | `rev lint` | Check for broken refs, missing citations |
227
+
228
+ ### Grammar & Style
229
+
230
+ | Command | Description |
231
+ |---------|-------------|
232
+ | `rev grammar` | Check grammar/style issues |
233
+ | `rev grammar --rules` | List available grammar rules |
234
+ | `rev grammar --learn <word>` | Add word to custom dictionary |
235
+ | `rev grammar --list` | Show custom dictionary |
236
+
237
+ ### Spelling
238
+
239
+ | Command | Description |
240
+ |---------|-------------|
241
+ | `rev spelling` | Check spelling in all sections |
242
+ | `rev spelling --british` | Use British English dictionary |
243
+ | `rev spelling --learn <word>` | Add word to global dictionary |
244
+ | `rev spelling --learn-project <word>` | Add word to project dictionary |
245
+ | `rev spelling --list` | Show global dictionary |
246
+ | `rev spelling --list-all` | Show global + project dictionaries |
247
+
248
+ ### Direct DOCX Editing
249
+
250
+ | Command | Description |
251
+ |---------|-------------|
252
+ | `rev annotate <docx>` | Add comments to Word document |
253
+ | `rev apply <md> <docx>` | Apply annotations as track changes |
254
+ | `rev comment <docx>` | Interactive comment mode |
255
+
188
256
  ## Project Structure
189
257
 
190
258
  A typical rev project:
@@ -249,6 +317,27 @@ docx:
249
317
  {>>Author: comment<<} # Comments
250
318
  ```
251
319
 
320
+ ## Template Variables
321
+
322
+ Use template variables in section files (processed during build):
323
+
324
+ ```markdown
325
+ Last updated: {{date}}
326
+ Version: {{version}}
327
+ Word count: {{word_count}}
328
+ ```
329
+
330
+ | Variable | Description |
331
+ |----------|-------------|
332
+ | `{{date}}` | Current date (YYYY-MM-DD) |
333
+ | `{{date:MMMM D, YYYY}}` | Custom format (December 29, 2025) |
334
+ | `{{year}}` | Current year |
335
+ | `{{version}}` | Version from rev.yaml |
336
+ | `{{title}}` | Document title |
337
+ | `{{author}}` | First author name |
338
+ | `{{authors}}` | All authors (comma-separated) |
339
+ | `{{word_count}}` | Total word count |
340
+
252
341
  ## Comment Replies
253
342
 
254
343
  Reply to reviewer comments with your name: