docrev 0.11.2 → 0.12.0

package/lib/orcid.ts

@@ -1,144 +0,0 @@
-/**
- * ORCID integration for author metadata
- *
- * Fetches author information from ORCID public API
- */
-
-export interface OrcidProfile {
-  orcid: string;
-  name: string;
-  affiliation: string;
-  email: string;
-}
-
-/**
- * Validate ORCID format (0000-0000-0000-0000)
- */
-export function isValidOrcid(orcid: string): boolean {
-  return /^(\d{4}-){3}\d{3}[\dX]$/i.test(orcid);
-}
-
-/**
- * Clean ORCID input (removes URLs, whitespace)
- */
-export function cleanOrcid(input: string): string {
-  if (!input) return '';
-
-  // Remove URL prefix if present
-  let clean = input.trim()
-    .replace(/^https?:\/\/(www\.)?orcid\.org\//i, '')
-    .replace(/^orcid\.org\//i, '')
-    .trim();
-
-  return clean;
-}
-
-/**
- * Fetch author info from ORCID public API
- */
-export async function fetchOrcidProfile(orcid: string): Promise<OrcidProfile> {
-  const cleanId = cleanOrcid(orcid);
-
-  if (!isValidOrcid(cleanId)) {
-    throw new Error(`Invalid ORCID format: ${orcid}`);
-  }
-
-  const url = `https://pub.orcid.org/v3.0/${cleanId}/person`;
-
-  const response = await fetch(url, {
-    headers: {
-      'Accept': 'application/json',
-    },
-  });
-
-  if (!response.ok) {
-    if (response.status === 404) {
-      throw new Error(`ORCID not found: ${cleanId}`);
-    }
-    throw new Error(`ORCID API error: ${response.status}`);
-  }
-
-  const data = await response.json() as any;
-
-  // Extract name
-  const nameData = data.name;
-  let name = '';
-  if (nameData) {
-    const given = nameData['given-names']?.value || '';
-    const family = nameData['family-name']?.value || '';
-    name = `${given} ${family}`.trim();
-  }
-
-  // Extract primary affiliation
-  let affiliation = '';
-  const affiliations = data.employments?.['affiliation-group'] || [];
-  if (affiliations.length > 0) {
-    const primary = affiliations[0]?.summaries?.[0]?.['employment-summary'];
-    affiliation = primary?.organization?.name || '';
-  }
-
-  // Extract email (if public)
-  let email = '';
-  const emails = data.emails?.email || [];
-  const primaryEmail = emails.find((e: any) => e.primary) || emails[0];
-  if (primaryEmail?.email) {
-    email = primaryEmail.email;
-  }
-
-  return {
-    orcid: cleanId,
-    name,
-    affiliation,
-    email,
-  };
-}
-
-/**
- * Fetch work count from ORCID
- */
-export async function fetchOrcidWorkCount(orcid: string): Promise<number> {
-  const cleanId = cleanOrcid(orcid);
-
-  if (!isValidOrcid(cleanId)) {
-    throw new Error(`Invalid ORCID format: ${orcid}`);
-  }
-
-  const url = `https://pub.orcid.org/v3.0/${cleanId}/works`;
-
-  const response = await fetch(url, {
-    headers: {
-      'Accept': 'application/json',
-    },
-  });
-
-  if (!response.ok) {
-    return 0;
-  }
-
-  const data = await response.json() as any;
-  return data.group?.length || 0;
-}
-
-/**
- * Format author for YAML
- */
-export function formatAuthorYaml(profile: OrcidProfile): string {
-  const lines: string[] = [];
-  lines.push(`  - name: ${profile.name}`);
-  if (profile.affiliation) {
-    lines.push(`    affiliation: ${profile.affiliation}`);
-  }
-  if (profile.email) {
-    lines.push(`    email: ${profile.email}`);
-  }
-  lines.push(`    orcid: ${profile.orcid}`);
-  return lines.join('\n');
-}
-
-/**
- * Generate ORCID badge markdown
- */
-export function getOrcidBadge(orcid: string): string {
-  const cleanId = cleanOrcid(orcid);
-  return `[![ORCID](https://img.shields.io/badge/ORCID-${cleanId}-a6ce39)](https://orcid.org/${cleanId})`;
-}

package/lib/pdf-comments.ts

@@ -1,263 +0,0 @@
-/**
- * PDF comment rendering for dual export
- *
- * Converts CriticMarkup comments to LaTeX margin notes for PDF output
- */
-
-import { escapeLatex } from './utils.js';
-
-/**
- * LaTeX preamble for margin comments
- * Uses todonotes package with custom styling
- */
-export const MARGIN_NOTES_PREAMBLE = `
-% Margin notes for comments
-\\usepackage[colorinlistoftodos,textsize=scriptsize]{todonotes}
-\\usepackage{xcolor}
-
-% Define comment colors by author
-\\definecolor{commentblue}{RGB}{59, 130, 246}
-\\definecolor{commentgreen}{RGB}{34, 197, 94}
-\\definecolor{commentorange}{RGB}{249, 115, 22}
-\\definecolor{commentpurple}{RGB}{168, 85, 247}
-\\definecolor{commentgray}{RGB}{107, 114, 128}
-
-% Custom margin note command
-\\newcommand{\\margincomment}[2][]{%
-  \\todo[linecolor=commentblue,backgroundcolor=commentblue!10,bordercolor=commentblue,size=\\scriptsize,#1]{#2}%
-}
-
-% Author-specific commands
-\\newcommand{\\reviewercomment}[2]{%
-  \\todo[linecolor=commentgreen,backgroundcolor=commentgreen!10,bordercolor=commentgreen,size=\\scriptsize]{\\textbf{#1:} #2}%
-}
-
-% Increase margin for notes (if needed)
-% \\setlength{\\marginparwidth}{2.5cm}
-`;
-
-/**
- * Simpler preamble using marginpar (no extra packages needed)
- */
-export const SIMPLE_MARGIN_PREAMBLE = `
-% Simple margin notes for comments
-\\usepackage{xcolor}
-\\definecolor{commentcolor}{RGB}{59, 130, 246}
-
-\\newcommand{\\margincomment}[1]{%
-  \\marginpar{\\raggedright\\scriptsize\\textcolor{commentcolor}{#1}}%
-}
-`;
-
-/**
- * Options for converting comments to margin notes
- */
-export interface CommentConversionOptions {
-  useTodonotes?: boolean;
-  stripResolved?: boolean;
-}
-
-/**
- * Result of comment conversion
- */
-export interface CommentConversionResult {
-  markdown: string;
-  commentCount: number;
-  preamble: string;
-}
-
-/**
- * Convert CriticMarkup comments to LaTeX margin notes
- * {>>Author: comment text<<} -> \margincomment{Author: comment text}
- *
- * @param markdown - Markdown with CriticMarkup comments
- * @param options - { useTodonotes: boolean, stripResolved: boolean }
- * @returns Converted markdown with comment count and preamble
- */
-export function convertCommentsToMarginNotes(
-  markdown: string,
-  options: CommentConversionOptions = {}
-): CommentConversionResult {
-  const { useTodonotes = true, stripResolved = true } = options;
-
-  let commentCount = 0;
-
-  // Pattern for CriticMarkup comments: {>>author: text<<} or {>>text<<}
-  // Also handle resolved comments: {>>✓ author: text<<}
-  const commentPattern = /\{>>(✓\s*)?([^<]+)<<\}/g;
-
-  const converted = markdown.replace(commentPattern, (match, resolved, content) => {
-    // Skip resolved comments if requested
-    if (resolved && stripResolved) {
-      return '';
-    }
-
-    commentCount++;
-
-    // Escape LaTeX special characters
-    const escaped = escapeLatex(content.trim());
-
-    if (useTodonotes) {
-      // Check if content has author prefix (Author: text)
-      const authorMatch = escaped.match(/^([^:]+):\s*([\s\S]+)$/);
-      if (authorMatch) {
-        const [, author, text] = authorMatch;
-        return `\\reviewercomment{${author}}{${text}}`;
-      }
-      return `\\margincomment{${escaped}}`;
-    } else {
-      return `\\margincomment{${escaped}}`;
-    }
-  });
-
-  const preamble = useTodonotes ? MARGIN_NOTES_PREAMBLE : SIMPLE_MARGIN_PREAMBLE;
-
-  return {
-    markdown: converted,
-    commentCount,
-    preamble,
-  };
-}
-
-/**
- * Result of track changes conversion
- */
-export interface TrackChangesResult {
-  markdown: string;
-  preamble: string;
-}
-
-/**
- * Convert track changes to visible LaTeX formatting
- * {++inserted++} -> \textcolor{green}{inserted}
- * {--deleted--} -> \textcolor{red}{\sout{deleted}}
- * {~~old~>new~~} -> \textcolor{red}{\sout{old}}\textcolor{green}{new}
- *
- * @param markdown - Markdown with track changes
- * @returns Converted markdown and preamble
- */
-export function convertTrackChangesToLatex(markdown: string): TrackChangesResult {
-  let result = markdown;
-
-  // Insertions: {++text++} -> green text
-  result = result.replace(/\{\+\+([^+]+)\+\+\}/g, (match, text) => {
-    return `\\textcolor{green}{${escapeLatex(text)}}`;
-  });
-
-  // Deletions: {--text--} -> red strikethrough
-  result = result.replace(/\{--([^-]+)--\}/g, (match, text) => {
-    return `\\textcolor{red}{\\sout{${escapeLatex(text)}}}`;
-  });
-
-  // Substitutions: {~~old~>new~~} -> red strikethrough + green new
-  result = result.replace(/\{~~([^~]+)~>([^~]+)~~\}/g, (match, oldText, newText) => {
-    return `\\textcolor{red}{\\sout{${escapeLatex(oldText)}}}\\textcolor{green}{${escapeLatex(newText)}}`;
-  });
-
-  const preamble = `
-% Track changes visualization
-\\usepackage{xcolor}
-\\usepackage[normalem]{ulem}
-\\definecolor{green}{RGB}{34, 197, 94}
-\\definecolor{red}{RGB}{239, 68, 68}
-`;
-
-  return { markdown: result, preamble };
-}
-
-/**
- * Options for combined preamble
- */
-export interface PreambleOptions {
-  comments?: boolean;
-  trackChanges?: boolean;
-  useTodonotes?: boolean;
-}
-
-/**
- * Get combined preamble for comments and track changes
- * @param options - { comments: boolean, trackChanges: boolean, useTodonotes: boolean }
- * @returns Combined LaTeX preamble
- */
-export function getCombinedPreamble(options: PreambleOptions = {}): string {
-  const { comments = true, trackChanges = false, useTodonotes = true } = options;
-
-  let preamble = '';
-
-  if (comments) {
-    preamble += useTodonotes ? MARGIN_NOTES_PREAMBLE : SIMPLE_MARGIN_PREAMBLE;
-  }
-
-  if (trackChanges) {
-    preamble += `
-% Track changes visualization
-\\usepackage[normalem]{ulem}
-`;
-    if (!comments) {
-      preamble += `\\usepackage{xcolor}\n`;
-    }
-    preamble += `
-\\definecolor{insertgreen}{RGB}{34, 197, 94}
-\\definecolor{deletered}{RGB}{239, 68, 68}
-`;
-  }
-
-  return preamble;
-}
-
-/**
- * Options for preparing markdown for annotated PDF
- */
-export interface AnnotatedPdfOptions {
-  showTrackChanges?: boolean;
-  useTodonotes?: boolean;
-  stripResolved?: boolean;
-}
-
-/**
- * Result of preparing markdown for annotated PDF
- */
-export interface AnnotatedPdfResult {
-  markdown: string;
-  preamble: string;
-  commentCount: number;
-}
-
-/**
- * Prepare markdown for PDF with visible comments
- * Converts comments to margin notes and optionally shows track changes
- *
- * @param markdown - Markdown content
- * @param options - { showTrackChanges: boolean, useTodonotes: boolean }
- * @returns Converted markdown with preamble and comment count
- */
-export function prepareMarkdownForAnnotatedPdf(
-  markdown: string,
-  options: AnnotatedPdfOptions = {}
-): AnnotatedPdfResult {
-  const { showTrackChanges = false, useTodonotes = true, stripResolved = true } = options;
-
-  let result = markdown;
-  let preamble = '';
-  let commentCount = 0;
-
-  // Convert comments to margin notes
-  const commentResult = convertCommentsToMarginNotes(result, { useTodonotes, stripResolved });
-  result = commentResult.markdown;
-  commentCount = commentResult.commentCount;
-  preamble += commentResult.preamble;
-
-  // Optionally show track changes
-  if (showTrackChanges) {
-    const trackResult = convertTrackChangesToLatex(result);
-    result = trackResult.markdown;
-    // Add ulem package if not already in todonotes preamble
-    if (!useTodonotes) {
-      preamble += trackResult.preamble;
-    } else {
-      preamble += `\\usepackage[normalem]{ulem}\n`;
-    }
-  }
-
-  return { markdown: result, preamble, commentCount };
-}