@uniweb/scholar 0.1.0

package/src/bibliography/formatters/ieee.js

@@ -0,0 +1,332 @@
+/**
+ * IEEE Reference Formatter
+ *
+ * Formats references according to IEEE citation style.
+ *
+ * @module @uniweb/scholar/bibliography/formatters/ieee
+ */
+
+import { formatIeeeAuthors, parseAuthorString } from '../utils/authors.js'
+import { formatIeeeDate, getYear } from '../utils/dates.js'
+
+/**
+ * Format a journal article in IEEE style
+ *
+ * @param {Object} pub - Publication data
+ * @returns {string}
+ */
+function formatArticle(pub) {
+  const parts = []
+
+  // Authors
+  const authors = Array.isArray(pub.authors)
+    ? pub.authors
+    : parseAuthorString(pub.authors || pub.author)
+  if (authors.length) {
+    parts.push(`${formatIeeeAuthors(authors)},`)
+  }
+
+  // Title in quotes
+  if (pub.title) {
+    parts.push(`"${pub.title},"`)
+  }
+
+  // Journal (italicized)
+  if (pub.journal) {
+    let journalPart = pub.journal
+    if (pub.volume) {
+      journalPart += `, vol. ${pub.volume}`
+    }
+    if (pub.issue) {
+      journalPart += `, no. ${pub.issue}`
+    }
+    if (pub.pages) {
+      journalPart += `, pp. ${pub.pages}`
+    }
+    // Date
+    const date = formatIeeeDate(pub.date || pub.year)
+    if (date) {
+      journalPart += `, ${date}`
+    }
+    parts.push(`${journalPart}.`)
+  }
+
+  // DOI
+  if (pub.doi) {
+    parts.push(`doi: ${pub.doi.replace(/^https?:\/\/doi\.org\//, '')}.`)
+  }
+
+  return parts.join(' ')
+}
+
+/**
+ * Format a book in IEEE style
+ *
+ * @param {Object} pub - Publication data
+ * @returns {string}
+ */
+function formatBook(pub) {
+  const parts = []
+
+  // Authors or editors
+  const authors = Array.isArray(pub.authors)
+    ? pub.authors
+    : parseAuthorString(pub.authors || pub.author)
+  const editors = Array.isArray(pub.editors)
+    ? pub.editors
+    : parseAuthorString(pub.editors || pub.editor)
+
+  if (authors.length) {
+    parts.push(`${formatIeeeAuthors(authors)},`)
+  } else if (editors.length) {
+    parts.push(`${formatIeeeAuthors(editors)}, Ed${editors.length > 1 ? 's' : ''}.,`)
+  }
+
+  // Title (italicized)
+  if (pub.title) {
+    let title = pub.title
+    if (pub.edition && pub.edition !== '1') {
+      title += `, ${pub.edition} ed`
+    }
+    parts.push(`${title}.`)
+  }
+
+  // Place and publisher
+  if (pub.address && pub.publisher) {
+    parts.push(`${pub.address}: ${pub.publisher},`)
+  } else if (pub.publisher) {
+    parts.push(`${pub.publisher},`)
+  }
+
+  // Year
+  const year = getYear(pub.year || pub.date)
+  if (year) {
+    parts.push(`${year}.`)
+  }
+
+  return parts.join(' ')
+}
+
+/**
+ * Format a book chapter in IEEE style
+ *
+ * @param {Object} pub - Publication data
+ * @returns {string}
+ */
+function formatInBook(pub) {
+  const parts = []
+
+  // Chapter authors
+  const authors = Array.isArray(pub.authors)
+    ? pub.authors
+    : parseAuthorString(pub.authors || pub.author)
+  if (authors.length) {
+    parts.push(`${formatIeeeAuthors(authors)},`)
+  }
+
+  // Chapter title in quotes
+  if (pub.title) {
+    parts.push(`"${pub.title},"`)
+  }
+
+  // Book title
+  if (pub.bookTitle) {
+    let bookPart = `in ${pub.bookTitle}`
+    const editors = Array.isArray(pub.editors)
+      ? pub.editors
+      : parseAuthorString(pub.editors || pub.editor)
+    if (editors.length) {
+      bookPart += `, ${formatIeeeAuthors(editors)}, Ed${editors.length > 1 ? 's' : ''}.`
+    }
+    parts.push(bookPart)
+  }
+
+  // Place and publisher
+  if (pub.address && pub.publisher) {
+    parts.push(`${pub.address}: ${pub.publisher},`)
+  } else if (pub.publisher) {
+    parts.push(`${pub.publisher},`)
+  }
+
+  // Year and pages
+  const year = getYear(pub.year || pub.date)
+  if (year) {
+    if (pub.pages) {
+      parts.push(`${year}, pp. ${pub.pages}.`)
+    } else {
+      parts.push(`${year}.`)
+    }
+  }
+
+  return parts.join(' ')
+}
+
+/**
+ * Format conference proceedings in IEEE style
+ *
+ * @param {Object} pub - Publication data
+ * @returns {string}
+ */
+function formatConference(pub) {
+  const parts = []
+
+  // Authors
+  const authors = Array.isArray(pub.authors)
+    ? pub.authors
+    : parseAuthorString(pub.authors || pub.author)
+  if (authors.length) {
+    parts.push(`${formatIeeeAuthors(authors)},`)
+  }
+
+  // Title in quotes
+  if (pub.title) {
+    parts.push(`"${pub.title},"`)
+  }
+
+  // Conference
+  if (pub.booktitle || pub.conference) {
+    let confPart = `in ${pub.booktitle || pub.conference}`
+    if (pub.address || pub.location) {
+      confPart += `, ${pub.address || pub.location}`
+    }
+    // Year
+    const year = getYear(pub.year || pub.date)
+    if (year) {
+      confPart += `, ${year}`
+    }
+    if (pub.pages) {
+      confPart += `, pp. ${pub.pages}`
+    }
+    parts.push(`${confPart}.`)
+  }
+
+  // DOI
+  if (pub.doi) {
+    parts.push(`doi: ${pub.doi.replace(/^https?:\/\/doi\.org\//, '')}.`)
+  }
+
+  return parts.join(' ')
+}
+
+/**
+ * Format a website/webpage in IEEE style
+ *
+ * @param {Object} pub - Publication data
+ * @returns {string}
+ */
+function formatWebsite(pub) {
+  const parts = []
+
+  // Authors or organization
+  const authors = Array.isArray(pub.authors)
+    ? pub.authors
+    : parseAuthorString(pub.authors || pub.author)
+  if (authors.length) {
+    parts.push(`${formatIeeeAuthors(authors)}.`)
+  } else if (pub.organization) {
+    parts.push(`${pub.organization}.`)
+  }
+
+  // Title in quotes
+  if (pub.title) {
+    parts.push(`"${pub.title}."`)
+  }
+
+  // Site name (italicized)
+  if (pub.siteName) {
+    parts.push(`${pub.siteName}.`)
+  }
+
+  // URL and access date
+  if (pub.url) {
+    let urlPart = pub.url
+    if (pub.accessDate) {
+      urlPart += ` (accessed ${formatIeeeDate(pub.accessDate)})`
+    }
+    parts.push(`${urlPart}.`)
+  }
+
+  return parts.join(' ')
+}
+
+/**
+ * Format a thesis/dissertation in IEEE style
+ *
+ * @param {Object} pub - Publication data
+ * @returns {string}
+ */
+function formatThesis(pub) {
+  const parts = []
+
+  // Author
+  const authors = Array.isArray(pub.authors)
+    ? pub.authors
+    : parseAuthorString(pub.authors || pub.author)
+  if (authors.length) {
+    parts.push(`${formatIeeeAuthors(authors)},`)
+  }
+
+  // Title in quotes
+  if (pub.title) {
+    parts.push(`"${pub.title},"`)
+  }
+
+  // Type
+  const type = pub.type === 'mastersthesis' ? 'M.S. thesis' : 'Ph.D. dissertation'
+  parts.push(type + ',')
+
+  // Institution
+  if (pub.school || pub.institution) {
+    parts.push(`${pub.school || pub.institution},`)
+  }
+
+  // Location and year
+  if (pub.address) {
+    parts.push(`${pub.address},`)
+  }
+  const year = getYear(pub.year || pub.date)
+  if (year) {
+    parts.push(`${year}.`)
+  }
+
+  return parts.join(' ')
+}
+
+/**
+ * Format a reference in IEEE style
+ *
+ * @param {Object} pub - Publication data
+ * @param {Object} [options] - Formatting options
+ * @returns {string}
+ */
+export function formatIeee(pub, options = {}) {
+  const type = (pub.type || pub.entryType || 'article').toLowerCase()
+
+  switch (type) {
+    case 'article':
+    case 'journal':
+      return formatArticle(pub)
+    case 'book':
+      return formatBook(pub)
+    case 'inbook':
+    case 'incollection':
+    case 'chapter':
+      return formatInBook(pub)
+    case 'inproceedings':
+    case 'conference':
+    case 'proceedings':
+      return formatConference(pub)
+    case 'webpage':
+    case 'website':
+    case 'online':
+      return formatWebsite(pub)
+    case 'thesis':
+    case 'phdthesis':
+    case 'mastersthesis':
+      return formatThesis(pub)
+    default:
+      return formatArticle(pub)
+  }
+}
+
+export default formatIeee

package/src/bibliography/formatters/index.js

@@ -0,0 +1,56 @@
+/**
+ * Bibliography Formatters
+ *
+ * @module @uniweb/scholar/bibliography/formatters
+ */
+
+export { formatApa } from './apa.js'
+export { formatMla } from './mla.js'
+export { formatChicago } from './chicago.js'
+export { formatIeee } from './ieee.js'
+
+import { formatApa } from './apa.js'
+import { formatMla } from './mla.js'
+import { formatChicago } from './chicago.js'
+import { formatIeee } from './ieee.js'
+
+/**
+ * Available citation style formatters
+ */
+export const formatters = {
+  apa: formatApa,
+  mla: formatMla,
+  chicago: formatChicago,
+  ieee: formatIeee,
+}
+
+/**
+ * Format a reference in a specific style
+ *
+ * @param {Object} publication - Publication data
+ * @param {Object} [options]
+ * @param {string} [options.style='apa'] - Citation style (apa, mla, chicago, ieee)
+ * @returns {string} Formatted reference string
+ *
+ * @example
+ * const ref = formatReference({
+ *   type: 'article',
+ *   authors: [{ family: 'Smith', given: 'John' }],
+ *   year: 2024,
+ *   title: 'A Study of Something',
+ *   journal: 'Journal of Studies',
+ *   volume: '10',
+ *   pages: '1-10',
+ *   doi: '10.1234/example'
+ * }, { style: 'apa' })
+ */
+export function formatReference(publication, options = {}) {
+  const { style = 'apa' } = options
+
+  const formatter = formatters[style.toLowerCase()]
+  if (!formatter) {
+    throw new Error(`Unknown citation style: ${style}. Available: ${Object.keys(formatters).join(', ')}`)
+  }
+
+  return formatter(publication, options)
+}

package/src/bibliography/formatters/mla.js

@@ -0,0 +1,335 @@
+/**
+ * MLA 9th Edition Reference Formatter
+ *
+ * Formats references according to MLA 9th edition guidelines.
+ *
+ * @module @uniweb/scholar/bibliography/formatters/mla
+ */
+
+import { formatMlaAuthors, parseAuthorString } from '../utils/authors.js'
+import { formatMlaDate, getYear } from '../utils/dates.js'
+
+/**
+ * Format a journal article in MLA style
+ *
+ * @param {Object} pub - Publication data
+ * @returns {string}
+ */
+function formatArticle(pub) {
+  const parts = []
+
+  // Authors
+  const authors = Array.isArray(pub.authors)
+    ? pub.authors
+    : parseAuthorString(pub.authors || pub.author)
+  if (authors.length) {
+    parts.push(`${formatMlaAuthors(authors)}.`)
+  }
+
+  // Title in quotes
+  if (pub.title) {
+    parts.push(`"${pub.title}."`)
+  }
+
+  // Container (journal name, italicized)
+  if (pub.journal) {
+    let container = pub.journal
+    if (pub.volume) {
+      container += `, vol. ${pub.volume}`
+    }
+    if (pub.issue) {
+      container += `, no. ${pub.issue}`
+    }
+    // Date
+    const year = getYear(pub.year || pub.date)
+    if (year) {
+      container += `, ${year}`
+    }
+    // Pages
+    if (pub.pages) {
+      container += `, pp. ${pub.pages}`
+    }
+    parts.push(`${container}.`)
+  }
+
+  // DOI
+  if (pub.doi) {
+    const doi = pub.doi.startsWith('http')
+      ? pub.doi
+      : `https://doi.org/${pub.doi}`
+    parts.push(doi)
+  }
+
+  return parts.join(' ')
+}
+
+/**
+ * Format a book in MLA style
+ *
+ * @param {Object} pub - Publication data
+ * @returns {string}
+ */
+function formatBook(pub) {
+  const parts = []
+
+  // Authors or editors
+  const authors = Array.isArray(pub.authors)
+    ? pub.authors
+    : parseAuthorString(pub.authors || pub.author)
+  const editors = Array.isArray(pub.editors)
+    ? pub.editors
+    : parseAuthorString(pub.editors || pub.editor)
+
+  if (authors.length) {
+    parts.push(`${formatMlaAuthors(authors)}.`)
+  } else if (editors.length) {
+    parts.push(
+      `${formatMlaAuthors(editors)}, editor${editors.length > 1 ? 's' : ''}.`
+    )
+  }
+
+  // Title (italicized)
+  if (pub.title) {
+    parts.push(`${pub.title}.`)
+  }
+
+  // Edition
+  if (pub.edition && pub.edition !== '1') {
+    parts.push(`${pub.edition} ed.,`)
+  }
+
+  // Publisher
+  if (pub.publisher) {
+    parts.push(`${pub.publisher},`)
+  }
+
+  // Year
+  const year = getYear(pub.year || pub.date)
+  if (year) {
+    parts.push(`${year}.`)
+  }
+
+  return parts.join(' ')
+}
+
+/**
+ * Format a book chapter in MLA style
+ *
+ * @param {Object} pub - Publication data
+ * @returns {string}
+ */
+function formatInBook(pub) {
+  const parts = []
+
+  // Chapter authors
+  const authors = Array.isArray(pub.authors)
+    ? pub.authors
+    : parseAuthorString(pub.authors || pub.author)
+  if (authors.length) {
+    parts.push(`${formatMlaAuthors(authors)}.`)
+  }
+
+  // Chapter title in quotes
+  if (pub.title) {
+    parts.push(`"${pub.title}."`)
+  }
+
+  // Book title (italicized)
+  if (pub.bookTitle) {
+    parts.push(`${pub.bookTitle},`)
+  }
+
+  // Editors
+  const editors = Array.isArray(pub.editors)
+    ? pub.editors
+    : parseAuthorString(pub.editors || pub.editor)
+  if (editors.length) {
+    parts.push(
+      `edited by ${formatMlaAuthors(editors)},`
+    )
+  }
+
+  // Publisher
+  if (pub.publisher) {
+    parts.push(`${pub.publisher},`)
+  }
+
+  // Year
+  const year = getYear(pub.year || pub.date)
+  if (year) {
+    parts.push(`${year},`)
+  }
+
+  // Pages
+  if (pub.pages) {
+    parts.push(`pp. ${pub.pages}.`)
+  }
+
+  return parts.join(' ')
+}
+
+/**
+ * Format conference proceedings in MLA style
+ *
+ * @param {Object} pub - Publication data
+ * @returns {string}
+ */
+function formatConference(pub) {
+  const parts = []
+
+  // Authors
+  const authors = Array.isArray(pub.authors)
+    ? pub.authors
+    : parseAuthorString(pub.authors || pub.author)
+  if (authors.length) {
+    parts.push(`${formatMlaAuthors(authors)}.`)
+  }
+
+  // Title in quotes
+  if (pub.title) {
+    parts.push(`"${pub.title}."`)
+  }
+
+  // Conference/Proceedings (italicized)
+  if (pub.booktitle || pub.conference) {
+    parts.push(`${pub.booktitle || pub.conference},`)
+  }
+
+  // Year
+  const year = getYear(pub.year || pub.date)
+  if (year) {
+    parts.push(`${year},`)
+  }
+
+  // Pages
+  if (pub.pages) {
+    parts.push(`pp. ${pub.pages}.`)
+  }
+
+  // DOI
+  if (pub.doi) {
+    const doi = pub.doi.startsWith('http')
+      ? pub.doi
+      : `https://doi.org/${pub.doi}`
+    parts.push(doi)
+  }
+
+  return parts.join(' ')
+}
+
+/**
+ * Format a website/webpage in MLA style
+ *
+ * @param {Object} pub - Publication data
+ * @returns {string}
+ */
+function formatWebsite(pub) {
+  const parts = []
+
+  // Authors
+  const authors = Array.isArray(pub.authors)
+    ? pub.authors
+    : parseAuthorString(pub.authors || pub.author)
+  if (authors.length) {
+    parts.push(`${formatMlaAuthors(authors)}.`)
+  }
+
+  // Title in quotes
+  if (pub.title) {
+    parts.push(`"${pub.title}."`)
+  }
+
+  // Site name (italicized)
+  if (pub.siteName) {
+    parts.push(`${pub.siteName},`)
+  }
+
+  // Date
+  const date = formatMlaDate(pub.date || pub.year)
+  if (date) {
+    parts.push(`${date},`)
+  }
+
+  // URL
+  if (pub.url) {
+    parts.push(`${pub.url}.`)
+  }
+
+  return parts.join(' ')
+}
+
+/**
+ * Format a thesis/dissertation in MLA style
+ *
+ * @param {Object} pub - Publication data
+ * @returns {string}
+ */
+function formatThesis(pub) {
+  const parts = []
+
+  // Author
+  const authors = Array.isArray(pub.authors)
+    ? pub.authors
+    : parseAuthorString(pub.authors || pub.author)
+  if (authors.length) {
+    parts.push(`${formatMlaAuthors(authors)}.`)
+  }
+
+  // Title (italicized)
+  if (pub.title) {
+    parts.push(`${pub.title}.`)
+  }
+
+  // Year
+  const year = getYear(pub.year || pub.date)
+  if (year) {
+    parts.push(`${year}.`)
+  }
+
+  // Institution and type
+  if (pub.school || pub.institution) {
+    const type = pub.type === 'mastersthesis' ? 'MA thesis' : 'PhD dissertation'
+    parts.push(`${pub.school || pub.institution}, ${type}.`)
+  }
+
+  return parts.join(' ')
+}
+
+/**
+ * Format a reference in MLA 9th edition style
+ *
+ * @param {Object} pub - Publication data
+ * @param {Object} [options] - Formatting options
+ * @returns {string}
+ */
+export function formatMla(pub, options = {}) {
+  const type = (pub.type || pub.entryType || 'article').toLowerCase()
+
+  switch (type) {
+    case 'article':
+    case 'journal':
+      return formatArticle(pub)
+    case 'book':
+      return formatBook(pub)
+    case 'inbook':
+    case 'incollection':
+    case 'chapter':
+      return formatInBook(pub)
+    case 'inproceedings':
+    case 'conference':
+    case 'proceedings':
+      return formatConference(pub)
+    case 'webpage':
+    case 'website':
+    case 'online':
+      return formatWebsite(pub)
+    case 'thesis':
+    case 'phdthesis':
+    case 'mastersthesis':
+      return formatThesis(pub)
+    default:
+      return formatArticle(pub)
+  }
+}
+
+export default formatMla