docrev 0.8.1 → 0.9.0

package/dist/lib/orcid.js

@@ -0,0 +1,117 @@
+/**
+ * ORCID integration for author metadata
+ *
+ * Fetches author information from ORCID public API
+ */
+/**
+ * Validate ORCID format (0000-0000-0000-0000)
+ */
+export function isValidOrcid(orcid) {
+    return /^(\d{4}-){3}\d{3}[\dX]$/i.test(orcid);
+}
+/**
+ * Clean ORCID input (removes URLs, whitespace)
+ */
+export function cleanOrcid(input) {
+    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) {
+    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();
+    // 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) => 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) {
+    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();
+    return data.group?.length || 0;
+}
+/**
+ * Format author for YAML
+ */
+export function formatAuthorYaml(profile) {
+    const lines = [];
+    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) {
+    const cleanId = cleanOrcid(orcid);
+    return `[![ORCID](https://img.shields.io/badge/ORCID-${cleanId}-a6ce39)](https://orcid.org/${cleanId})`;
+}
+//# sourceMappingURL=orcid.js.map

package/dist/lib/orcid.js.map

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

package/dist/lib/pdf-comments.d.ts

@@ -0,0 +1,95 @@
+/**
+ * PDF comment rendering for dual export
+ *
+ * Converts CriticMarkup comments to LaTeX margin notes for PDF output
+ */
+/**
+ * LaTeX preamble for margin comments
+ * Uses todonotes package with custom styling
+ */
+export declare const MARGIN_NOTES_PREAMBLE = "\n% Margin notes for comments\n\\usepackage[colorinlistoftodos,textsize=scriptsize]{todonotes}\n\\usepackage{xcolor}\n\n% Define comment colors by author\n\\definecolor{commentblue}{RGB}{59, 130, 246}\n\\definecolor{commentgreen}{RGB}{34, 197, 94}\n\\definecolor{commentorange}{RGB}{249, 115, 22}\n\\definecolor{commentpurple}{RGB}{168, 85, 247}\n\\definecolor{commentgray}{RGB}{107, 114, 128}\n\n% Custom margin note command\n\\newcommand{\\margincomment}[2][]{%\n  \\todo[linecolor=commentblue,backgroundcolor=commentblue!10,bordercolor=commentblue,size=\\scriptsize,#1]{#2}%\n}\n\n% Author-specific commands\n\\newcommand{\\reviewercomment}[2]{%\n  \\todo[linecolor=commentgreen,backgroundcolor=commentgreen!10,bordercolor=commentgreen,size=\\scriptsize]{\\textbf{#1:} #2}%\n}\n\n% Increase margin for notes (if needed)\n% \\setlength{\\marginparwidth}{2.5cm}\n";
+/**
+ * Simpler preamble using marginpar (no extra packages needed)
+ */
+export declare const SIMPLE_MARGIN_PREAMBLE = "\n% Simple margin notes for comments\n\\usepackage{xcolor}\n\\definecolor{commentcolor}{RGB}{59, 130, 246}\n\n\\newcommand{\\margincomment}[1]{%\n  \\marginpar{\\raggedright\\scriptsize\\textcolor{commentcolor}{#1}}%\n}\n";
+/**
+ * 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 declare function convertCommentsToMarginNotes(markdown: string, options?: CommentConversionOptions): CommentConversionResult;
+/**
+ * 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 declare function convertTrackChangesToLatex(markdown: string): TrackChangesResult;
+/**
+ * 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 declare function getCombinedPreamble(options?: PreambleOptions): string;
+/**
+ * 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 declare function prepareMarkdownForAnnotatedPdf(markdown: string, options?: AnnotatedPdfOptions): AnnotatedPdfResult;
+//# sourceMappingURL=pdf-comments.d.ts.map

package/dist/lib/pdf-comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-comments.d.ts","sourceRoot":"","sources":["../../lib/pdf-comments.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,eAAO,MAAM,qBAAqB,q2BAwBjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,kOAQlC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,wBAA6B,GACrC,uBAAuB,CAwCzB;AAgBD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CA2B/E;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,eAAoB,GAAG,MAAM,CAwBzE;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,mBAAwB,GAChC,kBAAkB,CA0BpB"}

package/dist/lib/pdf-comments.js

@@ -0,0 +1,192 @@
+/**
+ * PDF comment rendering for dual export
+ *
+ * Converts CriticMarkup comments to LaTeX margin notes for PDF output
+ */
+/**
+ * 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}}%
+}
+`;
+/**
+ * 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, options = {}) {
+    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,
+    };
+}
+/**
+ * Escape LaTeX special characters
+ * @param text - Text to escape
+ * @returns Escaped text
+ */
+function escapeLatex(text) {
+    return text
+        .replace(/\\/g, '\\textbackslash{}')
+        .replace(/([#$%&_{}])/g, '\\$1')
+        .replace(/\^/g, '\\textasciicircum{}')
+        .replace(/~/g, '\\textasciitilde{}')
+        .replace(/\n/g, ' '); // Replace newlines with spaces
+}
+/**
+ * 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) {
+    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 };
+}
+/**
+ * Get combined preamble for comments and track changes
+ * @param options - { comments: boolean, trackChanges: boolean, useTodonotes: boolean }
+ * @returns Combined LaTeX preamble
+ */
+export function getCombinedPreamble(options = {}) {
+    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;
+}
+/**
+ * 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, options = {}) {
+    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 };
+}
+//# sourceMappingURL=pdf-comments.js.map

package/dist/lib/pdf-comments.js.map

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

package/dist/lib/pdf-import.d.ts

@@ -0,0 +1,118 @@
+/**
+ * PDF comment extraction for docrev
+ *
+ * Extracts annotations (comments, highlights, sticky notes) from PDF files
+ * and converts them to CriticMarkup format for insertion into markdown.
+ * Also extracts the actual text content under highlights using pdfjs-dist.
+ */
+/**
+ * Raw PDF annotation extracted from pdf-lib
+ */
+export interface PdfAnnotation {
+    type: string;
+    page: number;
+    contents: string;
+    author: string;
+    date: string;
+    rect: number[];
+    quadPoints: number[];
+}
+/**
+ * PDF comment converted to CriticMarkup format
+ */
+export interface PdfComment {
+    author: string;
+    text: string;
+    page: number;
+    type: string;
+    date?: string;
+}
+/**
+ * PDF annotation with extracted highlighted text
+ */
+export interface PdfAnnotationWithText extends PdfAnnotation {
+    highlightedText: string;
+}
+/**
+ * Options for PDF extraction
+ */
+export interface ExtractOptions {
+    timeout?: number;
+}
+/**
+ * Options for markdown insertion
+ */
+export interface InsertOptions {
+    sectionPerPage?: boolean;
+}
+/**
+ * Statistics about PDF comments
+ */
+export interface PdfCommentStats {
+    total: number;
+    byType: Record<string, number>;
+    byAuthor: Record<string, number>;
+    byPage: Record<number, number>;
+}
+/**
+ * Extract raw annotations from a PDF file
+ * @param pdfPath - Path to PDF file
+ * @param options - { timeout: number (ms) }
+ * @returns Array of PDF annotations
+ */
+export declare function extractPdfAnnotations(pdfPath: string, options?: ExtractOptions): Promise<PdfAnnotation[]>;
+/**
+ * Convert PDF annotations to CriticMarkup comments
+ * @param annotations - From extractPdfAnnotations
+ * @returns Array of PDF comments
+ */
+export declare function annotationsToComments(annotations: PdfAnnotation[]): PdfComment[];
+/**
+ * Extract comments from PDF and format for display
+ * @param pdfPath - Path to PDF file
+ * @returns Array of PDF comments
+ */
+export declare function extractPdfComments(pdfPath: string): Promise<PdfComment[]>;
+/**
+ * Insert PDF comments into markdown based on page/position heuristics
+ * Since PDFs don't have direct text anchors like Word, we use page numbers
+ * and append comments to the end of corresponding sections
+ *
+ * @param markdown - The markdown content
+ * @param comments - Comments from extractPdfComments
+ * @param options - { sectionPerPage: boolean }
+ * @returns Markdown with comments inserted
+ */
+export declare function insertPdfCommentsIntoMarkdown(markdown: string, comments: PdfComment[], options?: InsertOptions): string;
+/**
+ * Format PDF comments for CLI display
+ * @param comments - Array of PDF comments
+ * @returns Formatted string
+ */
+export declare function formatPdfComments(comments: PdfComment[]): string;
+/**
+ * Get statistics about PDF comments
+ * @param comments - Array of PDF comments
+ * @returns Statistics object
+ */
+export declare function getPdfCommentStats(comments: PdfComment[]): PdfCommentStats;
+/**
+ * Extract highlighted text from a PDF using QuadPoints
+ * @param pdfPath - Path to PDF file
+ * @param annotations - Annotations with quadPoints from extractPdfAnnotations
+ * @returns Annotations with highlighted text extracted
+ */
+export declare function extractHighlightedText(pdfPath: string, annotations: PdfAnnotation[]): Promise<PdfAnnotationWithText[]>;
+/**
+ * Extract annotations with highlighted text in one call
+ * @param pdfPath - Path to PDF file
+ * @returns Annotations with highlighted text
+ */
+export declare function extractPdfAnnotationsWithText(pdfPath: string): Promise<PdfAnnotationWithText[]>;
+/**
+ * Format annotation with highlighted text for display
+ * @param annot - Annotation with highlightedText
+ * @returns Formatted string
+ */
+export declare function formatAnnotationWithText(annot: PdfAnnotationWithText): string;
+//# sourceMappingURL=pdf-import.d.ts.map

package/dist/lib/pdf-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-import.d.ts","sourceRoot":"","sources":["../../lib/pdf-import.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkBH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAaD;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,EAAE,CAAC,CAyG1B;AA2CD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,aAAa,EAAE,GAAG,UAAU,EAAE,CAUhF;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAG/E;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CA6BR;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,MAAM,CAqBhE;AAmBD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,eAAe,CAe1E;AAwCD;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,aAAa,EAAE,GAC3B,OAAO,CAAC,qBAAqB,EAAE,CAAC,CA2DlC;AAED;;;;GAIG;AACH,wBAAsB,6BAA6B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAGrG;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAc7E"}