@uniweb/scholar 0.2.0 → 0.2.2

package/src/bibliography/utils/dates.js

@@ -1,228 +0,0 @@
-/**
- * Date Formatting Utilities
- *
- * Functions for formatting dates in various citation styles.
- *
- * @module @uniweb/scholar/bibliography/utils/dates
- */
-
-/**
- * Month names for formatting
- */
-const MONTHS_FULL = [
-  'January',
-  'February',
-  'March',
-  'April',
-  'May',
-  'June',
-  'July',
-  'August',
-  'September',
-  'October',
-  'November',
-  'December',
-]
-
-const MONTHS_SHORT = [
-  'Jan.',
-  'Feb.',
-  'Mar.',
-  'Apr.',
-  'May',
-  'June',
-  'July',
-  'Aug.',
-  'Sep.',
-  'Oct.',
-  'Nov.',
-  'Dec.',
-]
-
-/**
- * Parse a date from various formats
- *
- * @param {string|number|Date|Object} date - Date input
- * @returns {{ year?: number, month?: number, day?: number }}
- */
-export function parseDate(date) {
-  if (!date) return {}
-
-  // Already structured
-  if (typeof date === 'object' && !(date instanceof Date)) {
-    return {
-      year: date.year ?? date.Year,
-      month: date.month ?? date.Month,
-      day: date.day ?? date.Day,
-    }
-  }
-
-  // JavaScript Date
-  if (date instanceof Date) {
-    return {
-      year: date.getFullYear(),
-      month: date.getMonth() + 1,
-      day: date.getDate(),
-    }
-  }
-
-  // Number (year only)
-  if (typeof date === 'number') {
-    return { year: date }
-  }
-
-  // String parsing
-  const str = String(date).trim()
-
-  // ISO format: YYYY-MM-DD
-  const isoMatch = str.match(/^(\d{4})(?:-(\d{1,2})(?:-(\d{1,2}))?)?/)
-  if (isoMatch) {
-    return {
-      year: parseInt(isoMatch[1], 10),
-      month: isoMatch[2] ? parseInt(isoMatch[2], 10) : undefined,
-      day: isoMatch[3] ? parseInt(isoMatch[3], 10) : undefined,
-    }
-  }
-
-  // Year only
-  const yearMatch = str.match(/^\d{4}$/)
-  if (yearMatch) {
-    return { year: parseInt(str, 10) }
-  }
-
-  // Month Year: "January 2024", "Jan 2024"
-  const monthYearMatch = str.match(
-    /^(\w+)\s+(\d{4})$/
-  )
-  if (monthYearMatch) {
-    const monthName = monthYearMatch[1].toLowerCase()
-    const monthIndex = MONTHS_FULL.findIndex(
-      (m) => m.toLowerCase().startsWith(monthName.slice(0, 3))
-    )
-    return {
-      year: parseInt(monthYearMatch[2], 10),
-      month: monthIndex !== -1 ? monthIndex + 1 : undefined,
-    }
-  }
-
-  return {}
-}
-
-/**
- * Format date for APA style
- *
- * @param {Object} date - Parsed date object
- * @returns {string}
- */
-export function formatApaDate(date) {
-  const parsed = parseDate(date)
-
-  if (!parsed.year) return 'n.d.'
-
-  if (parsed.month && parsed.day) {
-    return `${parsed.year}, ${MONTHS_FULL[parsed.month - 1]} ${parsed.day}`
-  }
-
-  if (parsed.month) {
-    return `${parsed.year}, ${MONTHS_FULL[parsed.month - 1]}`
-  }
-
-  return String(parsed.year)
-}
-
-/**
- * Format date for MLA style
- *
- * @param {Object} date - Parsed date object
- * @returns {string}
- */
-export function formatMlaDate(date) {
-  const parsed = parseDate(date)
-
-  if (!parsed.year) return ''
-
-  if (parsed.month && parsed.day) {
-    return `${parsed.day} ${MONTHS_SHORT[parsed.month - 1]} ${parsed.year}`
-  }
-
-  if (parsed.month) {
-    return `${MONTHS_SHORT[parsed.month - 1]} ${parsed.year}`
-  }
-
-  return String(parsed.year)
-}
-
-/**
- * Format date for Chicago style
- *
- * @param {Object} date - Parsed date object
- * @returns {string}
- */
-export function formatChicagoDate(date) {
-  const parsed = parseDate(date)
-
-  if (!parsed.year) return 'n.d.'
-
-  if (parsed.month && parsed.day) {
-    return `${MONTHS_FULL[parsed.month - 1]} ${parsed.day}, ${parsed.year}`
-  }
-
-  if (parsed.month) {
-    return `${MONTHS_FULL[parsed.month - 1]} ${parsed.year}`
-  }
-
-  return String(parsed.year)
-}
-
-/**
- * Format date for IEEE style
- *
- * @param {Object} date - Parsed date object
- * @returns {string}
- */
-export function formatIeeeDate(date) {
-  const parsed = parseDate(date)
-
-  if (!parsed.year) return ''
-
-  if (parsed.month) {
-    return `${MONTHS_SHORT[parsed.month - 1]} ${parsed.year}`
-  }
-
-  return String(parsed.year)
-}
-
-/**
- * Format date for a specific style
- *
- * @param {any} date - Date input
- * @param {Object} [options]
- * @param {string} [options.style='apa'] - Citation style
- * @returns {string}
- */
-export function formatDate(date, options = {}) {
-  const { style = 'apa' } = options
-
-  switch (style) {
-    case 'apa':
-      return formatApaDate(date)
-    case 'mla':
-      return formatMlaDate(date)
-    case 'chicago':
-      return formatChicagoDate(date)
-    case 'ieee':
-      return formatIeeeDate(date)
-    default:
-      return formatApaDate(date)
-  }
-}
-
-/**
- * Get year from date
- *
- * @param {any} date - Date input
- * @returns {number|undefined}
- */
-export function getYear(date) {
-  return parseDate(date).year
-}

package/src/bibliography/utils/index.js

@@ -1,8 +0,0 @@
-/**
- * Bibliography Utilities
- *
- * @module @uniweb/scholar/bibliography/utils
- */
-
-export * from './authors.js'
-export * from './dates.js'

package/src/math/Math.jsx

@@ -1,115 +0,0 @@
-/**
- * Math Component
- *
- * Renders LaTeX math expressions using KaTeX.
- * Supports both inline and display (block) modes.
- *
- * @module @uniweb/scholar/math/Math
- */
-
-import React, { useEffect, useState } from 'react'
-import { loadKatex } from './katex-loader.js'
-
-/**
- * Math - Render LaTeX math expressions
- *
- * @param {Object} props
- * @param {string} props.children - LaTeX expression to render
- * @param {boolean} [props.display=false] - Display mode (block) vs inline
- * @param {string} [props.className] - Additional CSS classes
- *
- * @example
- * // Inline math
- * <Math>E = mc^2</Math>
- *
- * @example
- * // Display (block) math
- * <Math display>
- *   \int_0^\infty e^{-x^2} dx = \frac{\sqrt{\pi}}{2}
- * </Math>
- */
-export function Math({ children, display = false, className, ...props }) {
-  const [html, setHtml] = useState(null)
-  const [error, setError] = useState(null)
-
-  // Extract LaTeX string from children
-  const latex = typeof children === 'string' ? children.trim() : ''
-
-  useEffect(() => {
-    if (!latex) return
-
-    let cancelled = false
-
-    async function render() {
-      const katex = await loadKatex()
-      if (cancelled || !katex) return
-
-      try {
-        const rendered = katex.renderToString(latex, {
-          displayMode: display,
-          throwOnError: false,
-          errorColor: '#cc0000',
-        })
-        if (!cancelled) {
-          setHtml(rendered)
-          setError(null)
-        }
-      } catch (e) {
-        if (!cancelled) {
-          setError(e.message)
-          setHtml(null)
-        }
-      }
-    }
-
-    render()
-
-    return () => {
-      cancelled = true
-    }
-  }, [latex, display])
-
-  // Error state
-  if (error) {
-    return (
-      <span
-        className={className}
-        style={{ color: '#cc0000', fontFamily: 'monospace' }}
-        title={error}
-        {...props}
-      >
-        {latex}
-      </span>
-    )
-  }
-
-  // Loading state - show raw LaTeX in code format
-  if (!html) {
-    return (
-      <code className={className} {...props}>
-        {latex}
-      </code>
-    )
-  }
-
-  // Rendered math
-  if (display) {
-    return (
-      <div
-        className={className}
-        dangerouslySetInnerHTML={{ __html: html }}
-        {...props}
-      />
-    )
-  }
-
-  return (
-    <span
-      className={className}
-      dangerouslySetInnerHTML={{ __html: html }}
-      {...props}
-    />
-  )
-}
-
-export default Math

package/src/math/katex-loader.js

@@ -1,105 +0,0 @@
-/**
- * KaTeX Lazy Loader
- *
- * Provides lazy loading of KaTeX with module-level caching.
- * KaTeX is only loaded when math rendering is actually needed.
- *
- * @module @uniweb/scholar/math/katex-loader
- */
-
-// Module-level state for singleton pattern
-let katexInstance = null
-let katexLoadPromise = null
-let cssInjected = false
-
-/**
- * CDN URL for KaTeX CSS (matches the katex version in package.json)
- */
-const KATEX_CSS_URL = 'https://cdn.jsdelivr.net/npm/katex@0.16.0/dist/katex.min.css'
-
-/**
- * Inject KaTeX CSS into the document head
- * Only injects once per page load
- */
-function injectKatexCSS() {
-  if (cssInjected || typeof document === 'undefined') return
-
-  const styleId = 'uniweb-katex-css'
-
-  // Check if already injected
-  if (document.getElementById(styleId)) {
-    cssInjected = true
-    return
-  }
-
-  const link = document.createElement('link')
-  link.id = styleId
-  link.rel = 'stylesheet'
-  link.href = KATEX_CSS_URL
-  link.crossOrigin = 'anonymous'
-  document.head.appendChild(link)
-
-  cssInjected = true
-}
-
-/**
- * Load KaTeX lazily
- *
- * Returns cached instance if already loaded, otherwise loads
- * KaTeX dynamically and injects its CSS.
- *
- * @returns {Promise<Object>} The KaTeX module
- */
-export async function loadKatex() {
-  if (katexInstance) return katexInstance
-  if (katexLoadPromise) return katexLoadPromise
-
-  katexLoadPromise = (async () => {
-    try {
-      const katex = await import('katex')
-      katexInstance = katex.default || katex
-
-      // Inject CSS when KaTeX is loaded
-      injectKatexCSS()
-
-      return katexInstance
-    } catch (error) {
-      console.warn('[scholar/math] Failed to load KaTeX:', error)
-      katexLoadPromise = null
-      return null
-    }
-  })()
-
-  return katexLoadPromise
-}
-
-/**
- * Check if KaTeX is already loaded
- *
- * @returns {boolean} True if KaTeX is loaded and ready
- */
-export function isKatexLoaded() {
-  return katexInstance !== null
-}
-
-/**
- * Render LaTeX to HTML string
- *
- * @param {string} latex - LaTeX string to render
- * @param {Object} options - KaTeX options
- * @returns {Promise<string|null>} Rendered HTML or null on error
- */
-export async function renderLatex(latex, options = {}) {
-  const katex = await loadKatex()
-  if (!katex) return null
-
-  try {
-    return katex.renderToString(latex, {
-      throwOnError: false,
-      ...options,
-    })
-  } catch (error) {
-    console.warn('[scholar/math] LaTeX render error:', error.message)
-    return null
-  }
-}