docrev 0.8.0 → 0.8.5

package/README.md

@@ -117,6 +117,14 @@ rev sync annotated.pdf            # extract PDF comments
 rev pdf-comments annotated.pdf --append methods.md
 ```
 
+Multiple reviewers sending back separate files? Merge them:
+
+```bash
+rev merge reviewer_A.docx reviewer_B.docx   # three-way merge
+```
+
+The merge command uses the original document (auto-saved in `.rev/base.docx` on build) to detect what each reviewer changed, identifies conflicts when reviewers edit the same text differently, and lets you resolve them interactively.
+
 Your entire revision cycle stays in the terminal. `final_v3_REAL_final.docx` is over.
 
 ## Getting Started
@@ -207,6 +215,39 @@ Configure your name for comment replies:
 rev config user "Your Name"
 ```
 
+### Table Formatting
+
+For PDF output, configure columns that should not wrap:
+
+```yaml
+tables:
+  nowrap:
+    - Prior              # column headers to keep on one line
+    - "$\\widehat{R}$"
+```
+
+Distribution notation in nowrap columns is auto-converted to LaTeX math:
+`Normal(0, 0.5)` → `$\mathcal{N}(0, 0.5)$`
+
+### Postprocess Scripts
+
+Run custom scripts after output generation:
+
+```yaml
+postprocess:
+  pdf: ./scripts/fix-tables.py    # runs after PDF
+  docx: ./scripts/add-meta.js     # runs after DOCX
+  all: ./scripts/notify.sh        # runs after any format
+```
+
+Scripts receive environment variables: `OUTPUT_FILE`, `OUTPUT_FORMAT`, `PROJECT_DIR`, `CONFIG_PATH`.
+
+Use `--verbose` to see script output:
+
+```bash
+rev build pdf --verbose
+```
+
 ## Annotation Syntax
 
 Track changes from Word appear as [CriticMarkup](http://criticmarkup.com/):
@@ -271,6 +312,7 @@ Cross-references: `@fig:label`, `@tbl:label`, `@eq:label` → "Figure 1", "Table
 | Resolve comment | `rev resolve file.md -n 1` |
 | Show contributors | `rev contributors` |
 | Lookup ORCID | `rev orcid 0000-0002-1825-0097` |
+| Merge reviewer feedback | `rev merge reviewer_A.docx reviewer_B.docx` |
 | Archive reviewer files | `rev archive` |
 | Check DOIs | `rev doi check references.bib` |
 | Find missing DOIs | `rev doi lookup references.bib` |

package/bin/rev.js

@@ -1,138 +1,19 @@
 #!/usr/bin/env node
 
-/**
- * rev - Revision workflow for Word ↔ Markdown round-trips
- *
- * Handles track changes and comments when collaborating on academic papers.
- * Preserves reviewer feedback through the Markdown editing workflow.
- */
+// Wrapper to run the TypeScript entry point via tsx
+// This allows `rev` command to work after npm link / npm install
 
-import { program } from 'commander';
-import chalk from 'chalk';
-import * as fs from 'fs';
+import { spawnSync } from 'child_process';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
 
-// Import refactored command modules
-import {
-  registerAllCommands,
-  setQuietMode,
-  setJsonMode,
-} from '../lib/commands/index.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const tsEntry = join(__dirname, 'rev.ts');
 
-// Global flags
-let quietMode = false;
-let jsonMode = false;
-
-// Levenshtein distance for command suggestions
-function levenshtein(a, b) {
-  const matrix = Array(b.length + 1).fill(null).map(() => Array(a.length + 1).fill(null));
-  for (let i = 0; i <= a.length; i++) matrix[0][i] = i;
-  for (let j = 0; j <= b.length; j++) matrix[j][0] = j;
-  for (let j = 1; j <= b.length; j++) {
-    for (let i = 1; i <= a.length; i++) {
-      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
-      matrix[j][i] = Math.min(
-        matrix[j][i - 1] + 1,
-        matrix[j - 1][i] + 1,
-        matrix[j - 1][i - 1] + cost
-      );
-    }
-  }
-  return matrix[b.length][a.length];
-}
-
-// Find similar commands for typo suggestions
-function suggestCommand(input, commands) {
-  const suggestions = commands
-    .map(cmd => ({ cmd, dist: levenshtein(input.toLowerCase(), cmd.toLowerCase()) }))
-    .filter(({ dist }) => dist <= 3)
-    .sort((a, b) => a.dist - b.dist)
-    .slice(0, 3)
-    .map(({ cmd }) => cmd);
-  return suggestions;
-}
-
-// Read version from package.json
-const pkgPath = new URL('../package.json', import.meta.url);
-const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
-
-program
-  .name('rev')
-  .description('Revision workflow for Word ↔ Markdown round-trips')
-  .version(`${pkg.version}\nNode ${process.version} | ${process.platform} ${process.arch}`, '-V, --version', 'Output version information')
-  .configureOutput({
-    outputError: (str, write) => write(chalk.red(str)),
-  })
-  .showHelpAfterError(chalk.dim('(use --help for usage information)'))
-  .option('--no-color', 'Disable colored output')
-  .option('-q, --quiet', 'Suppress non-essential output')
-  .option('--json', 'Output in JSON format (for scripting)')
-  .hook('preAction', (thisCommand) => {
-    const opts = thisCommand.opts();
-    if (opts.color === false) {
-      chalk.level = 0;
-    }
-    if (opts.quiet) {
-      quietMode = true;
-      setQuietMode(true);
-    }
-    if (opts.json) {
-      jsonMode = true;
-      setJsonMode(true);
-      chalk.level = 0; // Disable colors in JSON mode
-    }
-  });
-
-// Register all command modules
-// Commands organized by module:
-//   core.js: review, strip, status
-//   comments.js: comments, resolve, next, prev, first, last, todo, accept, reject, reply
-//   init.js: init, new, config
-//   sections.js: import, extract, split, sync, merge
-//   build.js: refs, migrate, install, doctor, build
-//   response.js: response, validate, profiles, anonymize
-//   citations.js: citations, figures, equations, pdf-comments
-//   doi.js: doi, orcid
-//   history.js: diff, history, contributors
-//   utilities.js: help, completions, word-count, stats, search, backup, archive,
-//                 export, preview, watch, lint, grammar, annotate, apply, comment,
-//                 clean, check, open, spelling, upgrade, batch, install-cli-skill
-registerAllCommands(program, pkg);
-
-// Get all command names for typo suggestions
-const allCommands = program.commands.map(cmd => cmd.name());
-const allAliases = program.commands.flatMap(cmd => cmd.aliases());
-const allCommandNames = [...allCommands, ...allAliases];
-
-// Handle unknown commands with suggestions
-program.on('command:*', (operands) => {
-  const unknown = operands[0];
-  console.error(chalk.red(`Unknown command: ${unknown}`));
-
-  const suggestions = suggestCommand(unknown, allCommandNames);
-  if (suggestions.length > 0) {
-    console.error();
-    console.error(chalk.yellow('Did you mean?'));
-    for (const s of suggestions) {
-      console.error(chalk.cyan(`  rev ${s}`));
-    }
-  }
-  console.error();
-  console.error(chalk.dim('Run "rev help" for available commands.'));
-  process.exit(1);
+// Run tsx with the TypeScript entry point
+const result = spawnSync('npx', ['tsx', tsEntry, ...process.argv.slice(2)], {
+  stdio: 'inherit',
+  shell: true
 });
 
-// Default to status when no command given
-const args = process.argv.slice(2);
-const globalOpts = ['--no-color', '-q', '--quiet', '--json', '-V', '--version', '-h', '--help'];
-const hasOnlyGlobalOpts = args.every(arg => globalOpts.includes(arg) || arg.startsWith('--no-') || arg.startsWith('-'));
-const hasCommand = args.some(arg => !arg.startsWith('-') && !globalOpts.includes(arg));
-
-if (args.length === 0 || (hasOnlyGlobalOpts && !hasCommand && !args.includes('-h') && !args.includes('--help') && !args.includes('-V') && !args.includes('--version'))) {
-  // Insert 'status' after any global options
-  const insertPos = process.argv.findIndex((arg, i) => i >= 2 && !arg.startsWith('-'));
-  if (insertPos === -1) {
-    process.argv.push('status');
-  }
-}
-
-program.parse();
+process.exit(result.status ?? 0);

package/bin/rev.ts

@@ -0,0 +1,145 @@
+#!/usr/bin/env tsx
+
+/**
+ * rev - Revision workflow for Word ↔ Markdown round-trips
+ *
+ * Handles track changes and comments when collaborating on academic papers.
+ * Preserves reviewer feedback through the Markdown editing workflow.
+ */
+
+import { program, Command } from 'commander';
+import chalk from 'chalk';
+import * as fs from 'fs';
+
+// Import refactored command modules
+import {
+  registerAllCommands,
+  setQuietMode,
+  setJsonMode,
+} from '../lib/commands/index.js';
+
+// Global flags
+let quietMode = false;
+let jsonMode = false;
+
+// Levenshtein distance for command suggestions
+function levenshtein(a: string, b: string): number {
+  const matrix: number[][] = Array(b.length + 1).fill(null).map(() => Array(a.length + 1).fill(0));
+  for (let i = 0; i <= a.length; i++) matrix[0]![i] = i;
+  for (let j = 0; j <= b.length; j++) matrix[j]![0] = j;
+  for (let j = 1; j <= b.length; j++) {
+    for (let i = 1; i <= a.length; i++) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+      matrix[j]![i] = Math.min(
+        matrix[j]![i - 1]! + 1,
+        matrix[j - 1]![i]! + 1,
+        matrix[j - 1]![i - 1]! + cost
+      );
+    }
+  }
+  return matrix[b.length]![a.length]!;
+}
+
+// Find similar commands for typo suggestions
+function suggestCommand(input: string, commands: string[]): string[] {
+  const suggestions = commands
+    .map(cmd => ({ cmd, dist: levenshtein(input.toLowerCase(), cmd.toLowerCase()) }))
+    .filter(({ dist }) => dist <= 3)
+    .sort((a, b) => a.dist - b.dist)
+    .slice(0, 3)
+    .map(({ cmd }) => cmd);
+  return suggestions;
+}
+
+interface PackageJson {
+  version: string;
+  name?: string;
+  description?: string;
+  [key: string]: unknown;
+}
+
+// Read version from package.json
+const pkgPath = new URL('../package.json', import.meta.url);
+const pkg: PackageJson = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+
+program
+  .name('rev')
+  .description('Revision workflow for Word ↔ Markdown round-trips')
+  .version(`${pkg.version}\nNode ${process.version} | ${process.platform} ${process.arch}`, '-V, --version', 'Output version information')
+  .configureOutput({
+    outputError: (str: string, write: (str: string) => void) => write(chalk.red(str)),
+  })
+  .showHelpAfterError(chalk.dim('(use --help for usage information)'))
+  .option('--no-color', 'Disable colored output')
+  .option('-q, --quiet', 'Suppress non-essential output')
+  .option('--json', 'Output in JSON format (for scripting)')
+  .hook('preAction', (thisCommand: Command) => {
+    const opts = thisCommand.opts<{ color?: boolean; quiet?: boolean; json?: boolean }>();
+    if (opts.color === false) {
+      chalk.level = 0;
+    }
+    if (opts.quiet) {
+      quietMode = true;
+      setQuietMode(true);
+    }
+    if (opts.json) {
+      jsonMode = true;
+      setJsonMode(true);
+      chalk.level = 0; // Disable colors in JSON mode
+    }
+  });
+
+// Register all command modules
+// Commands organized by module:
+//   core.js: review, strip, status
+//   comments.js: comments, resolve, next, prev, first, last, todo, accept, reject, reply
+//   init.js: init, new, config
+//   sections.js: import, extract, split, sync, merge
+//   build.js: refs, migrate, install, doctor, build
+//   response.js: response, validate, profiles, anonymize
+//   citations.js: citations, figures, equations, pdf-comments
+//   doi.js: doi, orcid
+//   history.js: diff, history, contributors
+//   utilities.js: help, completions, word-count, stats, search, backup, archive,
+//                 export, preview, watch, lint, grammar, annotate, apply, comment,
+//                 clean, check, open, spelling, upgrade, batch, install-cli-skill
+registerAllCommands(program, pkg);
+
+// Get all command names for typo suggestions
+const allCommands = program.commands.map(cmd => cmd.name());
+const allAliases = program.commands.flatMap(cmd => cmd.aliases());
+const allCommandNames = [...allCommands, ...allAliases];
+
+// Handle unknown commands with suggestions
+program.on('command:*', (operands: string[]) => {
+  const unknown = operands[0];
+  console.error(chalk.red(`Unknown command: ${unknown}`));
+
+  const suggestions = suggestCommand(unknown!, allCommandNames);
+  if (suggestions.length > 0) {
+    console.error();
+    console.error(chalk.yellow('Did you mean?'));
+    for (const s of suggestions) {
+      console.error(chalk.cyan(`  rev ${s}`));
+    }
+  }
+  console.error();
+  console.error(chalk.dim('Run "rev help" for available commands.'));
+  process.exit(1);
+});
+
+// Default to status when no command given
+const args = process.argv.slice(2);
+const globalOpts = ['--no-color', '-q', '--quiet', '--json', '-V', '--version', '-h', '--help'];
+const hasOnlyGlobalOpts = args.every(arg => globalOpts.includes(arg) || arg.startsWith('--no-') || arg.startsWith('-'));
+const hasCommand = args.some(arg => !arg.startsWith('-') && !globalOpts.includes(arg));
+
+if (args.length === 0 || (hasOnlyGlobalOpts && !hasCommand && !args.includes('-h') && !args.includes('--help') && !args.includes('-V') && !args.includes('--version'))) {
+  // Insert 'status' after any global options
+  const insertPos = process.argv.findIndex((arg, i) => i >= 2 && !arg.startsWith('-'));
+  if (insertPos === -1) {
+    process.argv.push('status');
+  }
+}
+
+program.parse();

package/dist/bin/rev.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env tsx
+/**
+ * rev - Revision workflow for Word ↔ Markdown round-trips
+ *
+ * Handles track changes and comments when collaborating on academic papers.
+ * Preserves reviewer feedback through the Markdown editing workflow.
+ */
+export {};
+//# sourceMappingURL=rev.d.ts.map

package/dist/bin/rev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rev.d.ts","sourceRoot":"","sources":["../../bin/rev.ts"],"names":[],"mappings":";AAEA;;;;;GAKG"}

package/dist/bin/rev.js

@@ -0,0 +1,118 @@
+#!/usr/bin/env tsx
+/**
+ * rev - Revision workflow for Word ↔ Markdown round-trips
+ *
+ * Handles track changes and comments when collaborating on academic papers.
+ * Preserves reviewer feedback through the Markdown editing workflow.
+ */
+import { program } from 'commander';
+import chalk from 'chalk';
+import * as fs from 'fs';
+// Import refactored command modules
+import { registerAllCommands, setQuietMode, setJsonMode, } from '../lib/commands/index.js';
+// Global flags
+let quietMode = false;
+let jsonMode = false;
+// Levenshtein distance for command suggestions
+function levenshtein(a, b) {
+    const matrix = Array(b.length + 1).fill(null).map(() => Array(a.length + 1).fill(0));
+    for (let i = 0; i <= a.length; i++)
+        matrix[0][i] = i;
+    for (let j = 0; j <= b.length; j++)
+        matrix[j][0] = j;
+    for (let j = 1; j <= b.length; j++) {
+        for (let i = 1; i <= a.length; i++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            matrix[j][i] = Math.min(matrix[j][i - 1] + 1, matrix[j - 1][i] + 1, matrix[j - 1][i - 1] + cost);
+        }
+    }
+    return matrix[b.length][a.length];
+}
+// Find similar commands for typo suggestions
+function suggestCommand(input, commands) {
+    const suggestions = commands
+        .map(cmd => ({ cmd, dist: levenshtein(input.toLowerCase(), cmd.toLowerCase()) }))
+        .filter(({ dist }) => dist <= 3)
+        .sort((a, b) => a.dist - b.dist)
+        .slice(0, 3)
+        .map(({ cmd }) => cmd);
+    return suggestions;
+}
+// Read version from package.json
+const pkgPath = new URL('../package.json', import.meta.url);
+const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+program
+    .name('rev')
+    .description('Revision workflow for Word ↔ Markdown round-trips')
+    .version(`${pkg.version}\nNode ${process.version} | ${process.platform} ${process.arch}`, '-V, --version', 'Output version information')
+    .configureOutput({
+    outputError: (str, write) => write(chalk.red(str)),
+})
+    .showHelpAfterError(chalk.dim('(use --help for usage information)'))
+    .option('--no-color', 'Disable colored output')
+    .option('-q, --quiet', 'Suppress non-essential output')
+    .option('--json', 'Output in JSON format (for scripting)')
+    .hook('preAction', (thisCommand) => {
+    const opts = thisCommand.opts();
+    if (opts.color === false) {
+        chalk.level = 0;
+    }
+    if (opts.quiet) {
+        quietMode = true;
+        setQuietMode(true);
+    }
+    if (opts.json) {
+        jsonMode = true;
+        setJsonMode(true);
+        chalk.level = 0; // Disable colors in JSON mode
+    }
+});
+// Register all command modules
+// Commands organized by module:
+//   core.js: review, strip, status
+//   comments.js: comments, resolve, next, prev, first, last, todo, accept, reject, reply
+//   init.js: init, new, config
+//   sections.js: import, extract, split, sync, merge
+//   build.js: refs, migrate, install, doctor, build
+//   response.js: response, validate, profiles, anonymize
+//   citations.js: citations, figures, equations, pdf-comments
+//   doi.js: doi, orcid
+//   history.js: diff, history, contributors
+//   utilities.js: help, completions, word-count, stats, search, backup, archive,
+//                 export, preview, watch, lint, grammar, annotate, apply, comment,
+//                 clean, check, open, spelling, upgrade, batch, install-cli-skill
+registerAllCommands(program, pkg);
+// Get all command names for typo suggestions
+const allCommands = program.commands.map(cmd => cmd.name());
+const allAliases = program.commands.flatMap(cmd => cmd.aliases());
+const allCommandNames = [...allCommands, ...allAliases];
+// Handle unknown commands with suggestions
+program.on('command:*', (operands) => {
+    const unknown = operands[0];
+    console.error(chalk.red(`Unknown command: ${unknown}`));
+    const suggestions = suggestCommand(unknown, allCommandNames);
+    if (suggestions.length > 0) {
+        console.error();
+        console.error(chalk.yellow('Did you mean?'));
+        for (const s of suggestions) {
+            console.error(chalk.cyan(`  rev ${s}`));
+        }
+    }
+    console.error();
+    console.error(chalk.dim('Run "rev help" for available commands.'));
+    process.exit(1);
+});
+// Default to status when no command given
+const args = process.argv.slice(2);
+const globalOpts = ['--no-color', '-q', '--quiet', '--json', '-V', '--version', '-h', '--help'];
+const hasOnlyGlobalOpts = args.every(arg => globalOpts.includes(arg) || arg.startsWith('--no-') || arg.startsWith('-'));
+const hasCommand = args.some(arg => !arg.startsWith('-') && !globalOpts.includes(arg));
+if (args.length === 0 || (hasOnlyGlobalOpts && !hasCommand && !args.includes('-h') && !args.includes('--help') && !args.includes('-V') && !args.includes('--version'))) {
+    // Insert 'status' after any global options
+    const insertPos = process.argv.findIndex((arg, i) => i >= 2 && !arg.startsWith('-'));
+    if (insertPos === -1) {
+        process.argv.push('status');
+    }
+}
+program.parse();
+//# sourceMappingURL=rev.js.map

package/dist/bin/rev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rev.js","sourceRoot":"","sources":["../../bin/rev.ts"],"names":[],"mappings":"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"}

package/dist/lib/annotations.d.ts

@@ -0,0 +1,91 @@
+/**
+ * CriticMarkup annotation parsing and manipulation
+ *
+ * Syntax:
+ *   {++inserted text++}     - Insertions
+ *   {--deleted text--}      - Deletions
+ *   {~~old~>new~~}          - Substitutions
+ *   {>>Author: comment<<}   - Comments
+ *   {==text==}              - Highlights
+ */
+import type { Annotation, AnnotationCounts, StripOptions, CommentFilterOptions } from './types.js';
+/**
+ * Parse all annotations from text
+ * @param text - Markdown text containing CriticMarkup annotations
+ * @returns Array of parsed annotations sorted by position
+ * @throws TypeError If text is not a string
+ */
+export declare function parseAnnotations(text: string): Annotation[];
+/**
+ * Strip annotations from text, applying changes
+ * Handles nested annotations by iterating until stable
+ * @param text - Markdown text with CriticMarkup annotations
+ * @param options - Strip options
+ * @returns Clean text with annotations applied/removed
+ * @throws TypeError If text is not a string
+ */
+export declare function stripAnnotations(text: string, options?: StripOptions): string;
+/**
+ * Collapse multiple spaces to single space, preserving table formatting
+ * Useful for cleaning up messy Word imports
+ * @param text - Text to normalize
+ * @returns Text with multiple spaces collapsed to single spaces
+ * @throws TypeError If text is not a string
+ */
+export declare function stripToSingleSpace(text: string): string;
+/**
+ * Check if text contains any CriticMarkup annotations
+ * @param text - Text to check
+ * @returns True if text contains any annotations
+ * @throws TypeError If text is not a string
+ */
+export declare function hasAnnotations(text: string): boolean;
+/**
+ * Apply a decision to a single annotation (accept or reject)
+ * @param text - Document text containing the annotation
+ * @param annotation - Annotation object from parseAnnotations()
+ * @param accept - True to accept the change, false to reject
+ * @returns Updated text with the decision applied
+ * @throws TypeError If text is not a string or annotation is invalid
+ */
+export declare function applyDecision(text: string, annotation: Annotation, accept: boolean): string;
+/**
+ * Get track changes only (no comments)
+ * @param text - Markdown text with CriticMarkup annotations
+ * @returns Array of insert/delete/substitute annotations
+ * @throws TypeError If text is not a string
+ */
+export declare function getTrackChanges(text: string): Annotation[];
+/**
+ * Get comments only
+ * @param text - Markdown text with CriticMarkup annotations
+ * @param options - Filter options
+ * @returns Array of comment annotations
+ * @throws TypeError If text is not a string
+ */
+export declare function getComments(text: string, options?: CommentFilterOptions): Annotation[];
+/**
+ * Mark a comment as resolved or pending
+ * @param text - Document text containing the comment
+ * @param comment - Comment annotation object from getComments()
+ * @param resolved - True to mark resolved, false to mark pending
+ * @returns Updated text with status marker applied
+ * @throws TypeError If text is not a string or comment is invalid
+ */
+export declare function setCommentStatus(text: string, comment: Annotation, resolved: boolean): string;
+/**
+ * Count annotations by type
+ * @param text - Markdown text with CriticMarkup annotations
+ * @returns Counts by annotation type
+ * @throws TypeError If text is not a string
+ */
+export declare function countAnnotations(text: string): AnnotationCounts;
+/**
+ * Clean up orphaned/malformed CriticMarkup markers
+ * This can happen when track changes span across comment boundaries
+ * @param text - Document text with potentially malformed markers
+ * @returns Cleaned text with orphaned markers removed
+ * @throws TypeError If text is not a string
+ */
+export declare function cleanupOrphanedMarkers(text: string): string;
+//# sourceMappingURL=annotations.d.ts.map

package/dist/lib/annotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.d.ts","sourceRoot":"","sources":["../../lib/annotations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAmHnG;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,CA6G3D;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,MAAM,CAuEjF;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqDvD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAUpD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAiD3F;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,CAG1D;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,UAAU,EAAE,CAyB1F;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAmB7F;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAwB/D;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA6C3D"}