@uniweb/scholar 0.1.0

package/src/citations/Citation.jsx

@@ -0,0 +1,196 @@
+/**
+ * Citation Component
+ *
+ * Renders an inline citation that links to the bibliography.
+ *
+ * @module @uniweb/scholar/citations/Citation
+ */
+
+import React, { useMemo } from 'react'
+import { useCitation } from './CitationProvider.jsx'
+import { getYear } from '../bibliography/utils/dates.js'
+
+/**
+ * Format author names for inline citation
+ *
+ * @param {Array} authors - Array of author objects
+ * @param {string} style - Citation style
+ * @returns {string}
+ */
+function formatInlineAuthors(authors, style) {
+  if (!authors?.length) return ''
+
+  const getName = (a) => {
+    if (typeof a === 'string') return a.split(',')[0].trim()
+    return a.family || a.lastName || ''
+  }
+
+  if (authors.length === 1) {
+    return getName(authors[0])
+  }
+
+  if (authors.length === 2) {
+    if (style === 'apa') {
+      return `${getName(authors[0])} & ${getName(authors[1])}`
+    }
+    return `${getName(authors[0])} and ${getName(authors[1])}`
+  }
+
+  // 3+ authors
+  return `${getName(authors[0])} et al.`
+}
+
+/**
+ * Citation - Inline citation component
+ *
+ * @param {Object} props
+ * @param {string} [props.id] - Single reference ID to cite
+ * @param {Array<string>} [props.ids] - Multiple reference IDs to cite
+ * @param {string} [props.page] - Page number(s)
+ * @param {string} [props.prefix] - Text before citation (e.g., "see")
+ * @param {string} [props.suffix] - Text after citation
+ * @param {boolean} [props.suppressAuthor] - Show only year (for narrative citations)
+ * @param {string} [props.format='parenthetical'] - Format: 'parenthetical', 'narrative', or 'numeric'
+ * @param {string} [props.className] - Additional CSS classes
+ *
+ * @example
+ * // Parenthetical citation: (Smith, 2024)
+ * <Citation id="smith2024" />
+ *
+ * @example
+ * // Narrative citation: Smith (2024)
+ * <Citation id="smith2024" format="narrative" />
+ *
+ * @example
+ * // With page number: (Smith, 2024, p. 42)
+ * <Citation id="smith2024" page="42" />
+ *
+ * @example
+ * // Multiple sources: (Smith, 2024; Jones, 2023)
+ * <Citation ids={['smith2024', 'jones2023']} />
+ *
+ * @example
+ * // IEEE-style numeric: [1]
+ * <Citation id="smith2024" format="numeric" />
+ */
+export function Citation({
+  id,
+  ids,
+  page,
+  prefix,
+  suffix,
+  suppressAuthor = false,
+  format = 'parenthetical',
+  className,
+  ...props
+}) {
+  const { cite, getReference, style } = useCitation()
+
+  // Get all IDs to cite
+  const allIds = useMemo(() => {
+    if (ids?.length) return ids
+    if (id) return [id]
+    return []
+  }, [id, ids])
+
+  // Cite all references and get their info
+  const citations = useMemo(() => {
+    return allIds.map((refId) => {
+      const number = cite(refId)
+      const reference = getReference(refId)
+      return { id: refId, number, reference }
+    })
+  }, [allIds, cite, getReference])
+
+  // Format the citation text
+  const citationText = useMemo(() => {
+    if (!citations.length) return '??'
+
+    // Numeric format (IEEE style)
+    if (format === 'numeric' || style === 'ieee') {
+      const numbers = citations.map((c) => c.number).join(', ')
+      return `[${numbers}]`
+    }
+
+    // Author-date formats
+    const parts = citations.map((c) => {
+      if (!c.reference) return c.id
+
+      const authors = c.reference.authors || []
+      const year = getYear(c.reference.year || c.reference.date)
+      const authorStr = formatInlineAuthors(authors, style)
+
+      if (suppressAuthor) {
+        return year || 'n.d.'
+      }
+
+      if (!year) {
+        return authorStr || c.id
+      }
+
+      return `${authorStr}, ${year}`
+    })
+
+    let text = parts.join('; ')
+
+    // Add page number
+    if (page) {
+      const pagePrefix = page.includes('-') || page.includes('–') ? 'pp.' : 'p.'
+      text += `, ${pagePrefix} ${page}`
+    }
+
+    // Add prefix/suffix
+    if (prefix) text = `${prefix} ${text}`
+    if (suffix) text = `${text}, ${suffix}`
+
+    // Wrap in parentheses for parenthetical format
+    if (format === 'parenthetical') {
+      return `(${text})`
+    }
+
+    return text
+  }, [citations, format, style, suppressAuthor, page, prefix, suffix])
+
+  // For narrative format, we need to split author and year
+  if (format === 'narrative' && citations.length === 1 && citations[0].reference) {
+    const c = citations[0]
+    const authors = c.reference.authors || []
+    const year = getYear(c.reference.year || c.reference.date)
+    const authorStr = formatInlineAuthors(authors, style)
+
+    let yearPart = year || 'n.d.'
+    if (page) {
+      const pagePrefix = page.includes('-') || page.includes('–') ? 'pp.' : 'p.'
+      yearPart += `, ${pagePrefix} ${page}`
+    }
+
+    return (
+      <span className={className} {...props}>
+        {prefix && `${prefix} `}
+        {authorStr}{' '}
+        <a
+          href={`#ref-${c.id}`}
+          style={{ textDecoration: 'none' }}
+        >
+          ({yearPart})
+        </a>
+        {suffix && ` ${suffix}`}
+      </span>
+    )
+  }
+
+  // Single link for all citations
+  const firstId = citations[0]?.id
+  return (
+    <a
+      href={firstId ? `#ref-${firstId}` : undefined}
+      className={className}
+      style={{ textDecoration: 'none' }}
+      {...props}
+    >
+      {citationText}
+    </a>
+  )
+}
+
+export default Citation

package/src/citations/CitationProvider.jsx

@@ -0,0 +1,147 @@
+/**
+ * Citation Provider Component
+ *
+ * Provides context for managing citations throughout a document.
+ * Tracks which references have been cited and their order.
+ *
+ * @module @uniweb/scholar/citations/CitationProvider
+ */
+
+import React, { createContext, useContext, useState, useMemo, useCallback } from 'react'
+import { parseBibtex } from '../bibliography/parsers/bibtex.js'
+
+/**
+ * Citation context
+ */
+export const CitationContext = createContext(null)
+
+/**
+ * Hook to access citation context
+ *
+ * @returns {{ cite: Function, getCitation: Function, references: Array, style: string, cited: Map }}
+ */
+export function useCitation() {
+  const ctx = useContext(CitationContext)
+  if (!ctx) {
+    throw new Error('useCitation must be used within a CitationProvider')
+  }
+  return ctx
+}
+
+/**
+ * CitationProvider - Manages citation state for a document
+ *
+ * @param {Object} props
+ * @param {Array|string} props.references - Array of reference objects or BibTeX string
+ * @param {string} [props.style='apa'] - Citation style (apa, mla, chicago, ieee)
+ * @param {React.ReactNode} props.children
+ *
+ * @example
+ * <CitationProvider references={refs} style="apa">
+ *   <p>According to <Citation id="smith2024" />, this is true.</p>
+ *   <Bibliography />
+ * </CitationProvider>
+ */
+export function CitationProvider({ references, style = 'apa', children }) {
+  // Track cited references in order
+  const [cited, setCited] = useState(new Map())
+
+  // Parse references if BibTeX string
+  const refs = useMemo(() => {
+    if (!references) return []
+    if (typeof references === 'string') {
+      return parseBibtex(references)
+    }
+    if (Array.isArray(references)) {
+      return references
+    }
+    return []
+  }, [references])
+
+  // Create a lookup map by id
+  const refsById = useMemo(() => {
+    const map = new Map()
+    refs.forEach((ref) => {
+      if (ref.id) map.set(ref.id, ref)
+      if (ref.citationKey) map.set(ref.citationKey, ref)
+    })
+    return map
+  }, [refs])
+
+  /**
+   * Cite a reference by id
+   * Returns the citation number (order in which it was first cited)
+   */
+  const cite = useCallback(
+    (id) => {
+      // Check if already cited
+      if (cited.has(id)) {
+        return cited.get(id)
+      }
+
+      // Add to cited list
+      const number = cited.size + 1
+      setCited((prev) => {
+        if (prev.has(id)) return prev
+        const next = new Map(prev)
+        next.set(id, number)
+        return next
+      })
+
+      return number
+    },
+    [cited]
+  )
+
+  /**
+   * Get citation info without citing
+   */
+  const getCitation = useCallback(
+    (id) => {
+      return {
+        number: cited.get(id),
+        reference: refsById.get(id),
+        isCited: cited.has(id),
+      }
+    },
+    [cited, refsById]
+  )
+
+  /**
+   * Get reference by id
+   */
+  const getReference = useCallback(
+    (id) => refsById.get(id),
+    [refsById]
+  )
+
+  /**
+   * Get all cited references in citation order
+   */
+  const getCitedReferences = useCallback(() => {
+    const sorted = Array.from(cited.entries()).sort((a, b) => a[1] - b[1])
+    return sorted.map(([id]) => refsById.get(id)).filter(Boolean)
+  }, [cited, refsById])
+
+  const value = useMemo(
+    () => ({
+      cite,
+      getCitation,
+      getReference,
+      getCitedReferences,
+      references: refs,
+      refsById,
+      style,
+      cited,
+    }),
+    [cite, getCitation, getReference, getCitedReferences, refs, refsById, style, cited]
+  )
+
+  return (
+    <CitationContext.Provider value={value}>
+      {children}
+    </CitationContext.Provider>
+  )
+}
+
+export default CitationProvider

package/src/citations/index.js

@@ -0,0 +1,16 @@
+/**
+ * Citations Module
+ *
+ * Components for managing inline citations and bibliographies.
+ *
+ * @module @uniweb/scholar/citations
+ */
+
+export {
+  CitationProvider,
+  CitationContext,
+  useCitation,
+} from './CitationProvider.jsx'
+
+export { Citation } from './Citation.jsx'
+export { Bibliography } from './Bibliography.jsx'

package/src/components/AuthorList.jsx

@@ -0,0 +1,147 @@
+/**
+ * AuthorList Component
+ *
+ * Renders a formatted list of authors with optional ORCID links.
+ *
+ * @module @uniweb/scholar/components/AuthorList
+ */
+
+import React from 'react'
+import { formatAuthors } from '../bibliography/utils/authors.js'
+
+/**
+ * AuthorList - Formatted author names
+ *
+ * @param {Object} props
+ * @param {Array|string} props.authors - Authors array or string
+ * @param {string} [props.style='apa'] - Formatting style
+ * @param {boolean} [props.showOrcid=true] - Show ORCID links if available
+ * @param {string} [props.separator=', '] - Separator between authors
+ * @param {string} [props.className] - Additional CSS classes
+ *
+ * @example
+ * <AuthorList authors={[{ family: 'Smith', given: 'John', orcid: '0000-0001-2345-6789' }]} />
+ *
+ * @example
+ * <AuthorList authors="Smith, John and Doe, Jane" style="mla" />
+ */
+export function AuthorList({
+  authors,
+  style = 'apa',
+  showOrcid = true,
+  separator = ', ',
+  className,
+  ...props
+}) {
+  // If authors is a string, just format it
+  if (typeof authors === 'string') {
+    return (
+      <span className={className} {...props}>
+        {formatAuthors(authors, { style })}
+      </span>
+    )
+  }
+
+  // If no array or empty, return nothing
+  if (!authors?.length) {
+    return null
+  }
+
+  // Check if any author has ORCID
+  const hasOrcid = showOrcid && authors.some((a) => a.orcid)
+
+  // If no ORCID to show, use simple formatted string
+  if (!hasOrcid) {
+    return (
+      <span className={className} {...props}>
+        {formatAuthors(authors, { style })}
+      </span>
+    )
+  }
+
+  // Render with ORCID links
+  return (
+    <span className={className} {...props}>
+      {authors.map((author, index) => {
+        const isLast = index === authors.length - 1
+        const isSecondToLast = index === authors.length - 2
+
+        // Format name based on style and position
+        let name
+        if (typeof author === 'string') {
+          name = author
+        } else {
+          const suffix = author.suffix ? `, ${author.suffix}` : ''
+          if (style === 'apa') {
+            // APA: Last, F.
+            const initials = author.given
+              ? author.given
+                  .split(/\s+/)
+                  .map((n) => `${n.charAt(0)}.`)
+                  .join(' ')
+              : ''
+            name = initials
+              ? `${author.family}${suffix}, ${initials}`
+              : author.family + suffix
+          } else {
+            // Default: First Last
+            name = author.given
+              ? `${author.given} ${author.family}${suffix}`
+              : author.family + suffix
+          }
+        }
+
+        // Determine separator
+        let sep = ''
+        if (!isLast) {
+          if (authors.length === 2) {
+            sep = style === 'apa' ? ' & ' : ' and '
+          } else if (isSecondToLast) {
+            sep = style === 'apa' ? ', & ' : ', and '
+          } else {
+            sep = separator
+          }
+        }
+
+        return (
+          <React.Fragment key={index}>
+            <span style={{ whiteSpace: 'nowrap' }}>
+              {name}
+              {author.orcid && (
+                <a
+                  href={`https://orcid.org/${author.orcid}`}
+                  target="_blank"
+                  rel="noopener noreferrer"
+                  title={`ORCID: ${author.orcid}`}
+                  style={{
+                    marginLeft: '0.25rem',
+                    display: 'inline-flex',
+                    verticalAlign: 'middle',
+                  }}
+                >
+                  <svg
+                    style={{ width: '1rem', height: '1rem' }}
+                    viewBox="0 0 256 256"
+                    xmlns="http://www.w3.org/2000/svg"
+                  >
+                    <path
+                      d="M128 0C57.3 0 0 57.3 0 128s57.3 128 128 128 128-57.3 128-128S198.7 0 128 0z"
+                      fill="#A6CE39"
+                    />
+                    <path
+                      d="M86.3 186.2H70.9V79.1h15.4v107.1zm22.7 0h-15V79.1h41.6c32.1 0 46.3 14.2 46.3 38.4 0 24.9-15.2 40.3-46.9 40.3h-26v28.4zm0-43.7h24.5c22.1 0 32.6-8.6 32.6-25.1 0-17.7-11.1-25-31.6-25h-25.5v50.1zm-43.4-79.4c5.9 0 10.6 4.8 10.6 10.6 0 5.9-4.8 10.6-10.6 10.6S55 79.6 55 73.7c0-5.8 4.8-10.6 10.6-10.6z"
+                      fill="#fff"
+                    />
+                  </svg>
+                </a>
+              )}
+            </span>
+            {sep}
+          </React.Fragment>
+        )
+      })}
+    </span>
+  )
+}
+
+export default AuthorList

package/src/components/BibtexBlock.jsx

@@ -0,0 +1,160 @@
+/**
+ * BibtexBlock Component
+ *
+ * Displays a BibTeX entry with copy functionality.
+ *
+ * @module @uniweb/scholar/components/BibtexBlock
+ */
+
+import React, { useState } from 'react'
+import { exportBibtex } from '../bibliography/parsers/bibtex.js'
+
+/**
+ * BibtexBlock - Display copyable BibTeX entry
+ *
+ * @param {Object} props
+ * @param {Object|string} props.entry - Publication object or BibTeX string
+ * @param {boolean} [props.showCopyButton=true] - Show copy button
+ * @param {string} [props.className] - Additional CSS classes
+ *
+ * @example
+ * <BibtexBlock entry={publication} />
+ *
+ * @example
+ * <BibtexBlock entry="@article{smith2024, ...}" />
+ */
+export function BibtexBlock({
+  entry,
+  showCopyButton = true,
+  className,
+  ...props
+}) {
+  const [copied, setCopied] = useState(false)
+
+  // Get BibTeX string
+  const bibtex = typeof entry === 'string' ? entry : exportBibtex(entry)
+
+  // Copy to clipboard
+  async function handleCopy() {
+    try {
+      await navigator.clipboard.writeText(bibtex)
+      setCopied(true)
+      setTimeout(() => setCopied(false), 2000)
+    } catch (err) {
+      console.error('Failed to copy:', err)
+    }
+  }
+
+  return (
+    <div
+      className={className}
+      style={{
+        position: 'relative',
+        backgroundColor: '#f8fafc',
+        border: '1px solid #e2e8f0',
+        borderRadius: '0.5rem',
+        overflow: 'hidden',
+      }}
+      {...props}
+    >
+      {/* Header */}
+      <div
+        style={{
+          display: 'flex',
+          justifyContent: 'space-between',
+          alignItems: 'center',
+          padding: '0.5rem 1rem',
+          backgroundColor: '#f1f5f9',
+          borderBottom: '1px solid #e2e8f0',
+        }}
+      >
+        <span
+          style={{
+            fontSize: '0.75rem',
+            fontWeight: '600',
+            color: '#64748b',
+            textTransform: 'uppercase',
+            letterSpacing: '0.05em',
+          }}
+        >
+          BibTeX
+        </span>
+
+        {showCopyButton && (
+          <button
+            type="button"
+            onClick={handleCopy}
+            style={{
+              display: 'inline-flex',
+              alignItems: 'center',
+              gap: '0.25rem',
+              padding: '0.25rem 0.5rem',
+              fontSize: '0.75rem',
+              color: copied ? '#059669' : '#64748b',
+              backgroundColor: copied ? '#ecfdf5' : 'transparent',
+              border: 'none',
+              borderRadius: '0.25rem',
+              cursor: 'pointer',
+            }}
+          >
+            {copied ? (
+              <>
+                <svg
+                  style={{ width: '0.875rem', height: '0.875rem' }}
+                  fill="none"
+                  stroke="currentColor"
+                  viewBox="0 0 24 24"
+                >
+                  <path
+                    strokeLinecap="round"
+                    strokeLinejoin="round"
+                    strokeWidth={2}
+                    d="M5 13l4 4L19 7"
+                  />
+                </svg>
+                Copied
+              </>
+            ) : (
+              <>
+                <svg
+                  style={{ width: '0.875rem', height: '0.875rem' }}
+                  fill="none"
+                  stroke="currentColor"
+                  viewBox="0 0 24 24"
+                >
+                  <path
+                    strokeLinecap="round"
+                    strokeLinejoin="round"
+                    strokeWidth={2}
+                    d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z"
+                  />
+                </svg>
+                Copy
+              </>
+            )}
+          </button>
+        )}
+      </div>
+
+      {/* BibTeX content */}
+      <pre
+        style={{
+          margin: 0,
+          padding: '1rem',
+          fontSize: '0.875rem',
+          lineHeight: '1.6',
+          fontFamily:
+            'ui-monospace, SFMono-Regular, "SF Mono", Menlo, Monaco, Consolas, monospace',
+          color: '#334155',
+          overflowX: 'auto',
+          whiteSpace: 'pre-wrap',
+          wordBreak: 'break-word',
+        }}
+      >
+        {bibtex}
+      </pre>
+    </div>
+  )
+}
+
+export default BibtexBlock