@life-and-dev/mdsite 0.0.3

package/mdsite-nuxt/app/types/table.ts

@@ -0,0 +1,57 @@
+/**
+ * TypeScript types for table parsing and v-data-table integration
+ */
+
+/**
+ * v-data-table header configuration
+ */
+export interface TableHeader {
+  /** Display title for the column */
+  title: string
+  /** Unique key for accessing data */
+  key: string
+  /** Whether column is sortable (default: true) */
+  sortable?: boolean
+  /** Column alignment */
+  align?: 'start' | 'end' | 'center'
+  /** Column width */
+  width?: string | number
+}
+
+/**
+ * v-data-table item (row data)
+ * Dynamic object with keys matching header keys
+ */
+export type TableItem = Record<string, any>
+
+/**
+ * Parsed table structure ready for v-data-table
+ */
+export interface ParsedTable {
+  /** Column headers */
+  headers: TableHeader[]
+  /** Row data */
+  items: TableItem[]
+}
+
+/**
+ * Raw table cell data during parsing
+ */
+export interface TableCell {
+  /** Text content of cell */
+  text: string
+  /** HTML content of cell (for complex formatting) */
+  html: string
+  /** Column index */
+  colIndex: number
+}
+
+/**
+ * Raw table row data during parsing
+ */
+export interface TableRow {
+  /** Cells in this row */
+  cells: TableCell[]
+  /** Row index */
+  rowIndex: number
+}

package/mdsite-nuxt/app/utils/bible-book-names.ts

@@ -0,0 +1,37 @@
+/**
+ * Bible book names whitelist (66 books)
+ * Used for detecting Bible references while avoiding false positives
+ */
+export const BIBLE_BOOK_NAMES = [
+  'Genesis', 'Exodus', 'Leviticus', 'Numbers', 'Deuteronomy', 'Joshua', 'Judges', 'Ruth',
+  '1 Samuel', '2 Samuel', '1 Kings', '2 Kings', '1 Chronicles', '2 Chronicles',
+  'Ezra', 'Nehemiah', 'Esther', 'Job', 'Psalm', 'Psalms', 'Proverbs', 'Ecclesiastes',
+  'Song of Solomon', 'Isaiah', 'Jeremiah', 'Lamentations', 'Ezekiel', 'Daniel',
+  'Hosea', 'Joel', 'Amos', 'Obadiah', 'Jonah', 'Micah', 'Nahum', 'Habakkuk',
+  'Zephaniah', 'Haggai', 'Zechariah', 'Malachi',
+  'Matthew', 'Mark', 'Luke', 'John', 'Acts', 'Romans',
+  '1 Corinthians', '2 Corinthians', 'Galatians', 'Ephesians', 'Philippians',
+  'Colossians', '1 Thessalonians', '2 Thessalonians', '1 Timothy', '2 Timothy',
+  'Titus', 'Philemon', 'Hebrews', 'James', '1 Peter', '2 Peter',
+  '1 John', '2 John', '3 John', 'Jude', 'Revelation'
+] as const
+
+/**
+ * Creates Bible reference detection patterns using book name whitelist
+ * @returns Array of RegExp patterns for matching Bible references (with optional translation in brackets)
+ */
+export function createBibleReferencePatterns(): RegExp[] {
+  const bookPattern = BIBLE_BOOK_NAMES.join('|').replace(/\s/g, '\\s+')
+  const translationPattern = '(?:\\s*\\([A-Z]+\\))?'  // Optional (ESV), (KJV), etc.
+
+  return [
+    // Cross-chapter range: "2 Corinthians 4:16-5:9 (ESV)"
+    new RegExp(`\\b(${bookPattern})\\s+(\\d+):(\\d+)-(\\d+):(\\d+)${translationPattern}\\b`, 'g'),
+    // Same chapter range: "John 3:16-18 (ESV)" - ensure we don't match if followed by digits (prevents matching "3:16-5" in "3:16-5:9")
+    new RegExp(`\\b(${bookPattern})\\s+(\\d+):(\\d+)-(\\d+)${translationPattern}\\b(?!\\d)`, 'g'),
+    // Single verse: "John 3:16 (ESV)" - ensure we don't match if followed by dash or digits (allows punctuation like colon, period, comma)
+    new RegExp(`\\b(${bookPattern})\\s+(\\d+):(\\d+)${translationPattern}\\b(?![\\d-])`, 'g'),
+    // Chapter only: "John 3 (ESV)", "Psalm 23 (ESV)" - ensure not followed by colon
+    new RegExp(`\\b(${bookPattern})\\s+(\\d+)${translationPattern}\\b(?!\\s*:)`, 'g')
+  ]
+}

package/mdsite-nuxt/app/utils/bible-verse-utils.test.ts

@@ -0,0 +1,148 @@
+import { describe, it, expect } from 'vitest'
+import { createBibleHubInterlinearUrl, parseReference } from './bible-verse-utils'
+
+/**
+ * Unit tests for BibleHub interlinear URL generation
+ */
+describe('BibleHub Interlinear URL Generation', () => {
+  it('should create URL for single verse reference', () => {
+    const url = createBibleHubInterlinearUrl('John 3:16')
+    expect(url).toBe('https://biblehub.com/interlinear/john/3-16.htm')
+  })
+
+  it('should create URL for chapter-only reference', () => {
+    const url = createBibleHubInterlinearUrl('Psalm 23')
+    expect(url).toBe('https://biblehub.com/interlinear/psalm/23.htm')
+  })
+
+  it('should create URL for verse range (use first verse)', () => {
+    const url = createBibleHubInterlinearUrl('John 3:16-18')
+    expect(url).toBe('https://biblehub.com/interlinear/john/3-16.htm')
+  })
+
+  it('should handle book names with spaces', () => {
+    const url = createBibleHubInterlinearUrl('1 Corinthians 13:4')
+    expect(url).toBe('https://biblehub.com/interlinear/1_corinthians/13-4.htm')
+  })
+
+  it('should handle book names with numbers', () => {
+    const url = createBibleHubInterlinearUrl('2 Timothy 3:16')
+    expect(url).toBe('https://biblehub.com/interlinear/2_timothy/3-16.htm')
+  })
+
+  it('should handle multi-word book names', () => {
+    const url = createBibleHubInterlinearUrl('Song of Solomon 2:1')
+    expect(url).toBe('https://biblehub.com/interlinear/song_of_solomon/2-1.htm')
+  })
+
+  it('should handle cross-chapter ranges (use first reference)', () => {
+    const url = createBibleHubInterlinearUrl('2 Corinthians 4:16-5:9')
+    expect(url).toBe('https://biblehub.com/interlinear/2_corinthians/4-16.htm')
+  })
+
+  it('should handle Genesis references', () => {
+    const url = createBibleHubInterlinearUrl('Genesis 1:1')
+    expect(url).toBe('https://biblehub.com/interlinear/genesis/1-1.htm')
+  })
+
+  it('should handle Revelation references', () => {
+    const url = createBibleHubInterlinearUrl('Revelation 1:5')
+    expect(url).toBe('https://biblehub.com/interlinear/revelation/1-5.htm')
+  })
+
+  it('should handle Ecclesiastes references', () => {
+    const url = createBibleHubInterlinearUrl('Ecclesiastes 1:2')
+    expect(url).toBe('https://biblehub.com/interlinear/ecclesiastes/1-2.htm')
+  })
+
+  it('should handle references with multiple spaces', () => {
+    const url = createBibleHubInterlinearUrl('1  Corinthians  13:4')
+    expect(url).toBe('https://biblehub.com/interlinear/1_corinthians/13-4.htm')
+  })
+
+  it('should fallback to main page for invalid reference', () => {
+    const url = createBibleHubInterlinearUrl('InvalidBook')
+    expect(url).toBe('https://biblehub.com/interlinear/')
+  })
+
+  it('should fallback to main page for empty reference', () => {
+    const url = createBibleHubInterlinearUrl('')
+    expect(url).toBe('https://biblehub.com/interlinear/')
+  })
+
+  it('should normalize book names to lowercase', () => {
+    const url = createBibleHubInterlinearUrl('JOHN 3:16')
+    expect(url).toBe('https://biblehub.com/interlinear/john/3-16.htm')
+  })
+
+  it('should handle chapter with large verse number', () => {
+    const url = createBibleHubInterlinearUrl('Psalm 119:105')
+    expect(url).toBe('https://biblehub.com/interlinear/psalm/119-105.htm')
+  })
+})
+
+/**
+ * Unit tests for Bible reference parsing with translation extraction
+ */
+describe('parseReference', () => {
+  it('should parse reference with ESV translation', () => {
+    const result = parseReference('John 3:16 (ESV)')
+    expect(result.reference).toBe('John 3:16')
+    expect(result.translation).toBe('ESV')
+  })
+
+  it('should parse reference with KJV translation', () => {
+    const result = parseReference('Genesis 1:1 (KJV)')
+    expect(result.reference).toBe('Genesis 1:1')
+    expect(result.translation).toBe('KJV')
+  })
+
+  it('should parse reference with NIV translation', () => {
+    const result = parseReference('Matthew 5:3-12 (NIV)')
+    expect(result.reference).toBe('Matthew 5:3-12')
+    expect(result.translation).toBe('NIV')
+  })
+
+  it('should default to ESV when no translation specified', () => {
+    const result = parseReference('John 3:16')
+    expect(result.reference).toBe('John 3:16')
+    expect(result.translation).toBe('ESV')
+  })
+
+  it('should default to ESV for chapter-only reference', () => {
+    const result = parseReference('Psalm 23')
+    expect(result.reference).toBe('Psalm 23')
+    expect(result.translation).toBe('ESV')
+  })
+
+  it('should handle extra whitespace around translation', () => {
+    const result = parseReference('John 3:16  (ESV)  ')
+    expect(result.reference).toBe('John 3:16')
+    expect(result.translation).toBe('ESV')
+  })
+
+  it('should handle references with extra whitespace', () => {
+    const result = parseReference('  John 3:16  ')
+    expect(result.reference).toBe('John 3:16')
+    expect(result.translation).toBe('ESV')
+  })
+
+  it('should parse cross-chapter range with translation', () => {
+    const result = parseReference('2 Corinthians 4:16-5:9 (ESV)')
+    expect(result.reference).toBe('2 Corinthians 4:16-5:9')
+    expect(result.translation).toBe('ESV')
+  })
+
+  it('should handle translation codes with varying lengths', () => {
+    const result = parseReference('John 3:16 (NKJV)')
+    expect(result.reference).toBe('John 3:16')
+    expect(result.translation).toBe('NKJV')
+  })
+
+  it('should not parse lowercase translations', () => {
+    // Lowercase should not match - treated as no translation
+    const result = parseReference('John 3:16 (esv)')
+    expect(result.reference).toBe('John 3:16 (esv)')
+    expect(result.translation).toBe('ESV')
+  })
+})

package/mdsite-nuxt/app/utils/bible-verse-utils.ts

@@ -0,0 +1,236 @@
+/**
+ * Shared utility functions for Bible verse handling with Bolls.life API
+ */
+
+/**
+ * Bolls.life API response format for single verse
+ */
+interface BollsVerseResponse {
+  pk: number
+  verse: number
+  text: string
+  comment?: string  // HTML cross-references
+}
+
+export interface ProcessedBibleVerse {
+  text: string
+  translation: string
+}
+
+export interface ParsedReference {
+  reference: string  // Reference without translation (e.g., "John 3:16")
+  translation: string  // Translation code (e.g., "ESV", defaults to "ESV")
+}
+
+/**
+ * Standard Bible book numbering (1-66)
+ * Used by Bolls.life API
+ */
+const BOOK_NUMBERS: Record<string, number> = {
+  // Old Testament (1-39)
+  'genesis': 1, 'gen': 1,
+  'exodus': 2, 'exo': 2, 'exod': 2,
+  'leviticus': 3, 'lev': 3,
+  'numbers': 4, 'num': 4,
+  'deuteronomy': 5, 'deut': 5, 'deu': 5,
+  'joshua': 6, 'josh': 6, 'jos': 6,
+  'judges': 7, 'judg': 7, 'jdg': 7,
+  'ruth': 8, 'rut': 8,
+  '1 samuel': 9, '1samuel': 9, '1sam': 9, '1sa': 9, 'i samuel': 9,
+  '2 samuel': 10, '2samuel': 10, '2sam': 10, '2sa': 10, 'ii samuel': 10,
+  '1 kings': 11, '1kings': 11, '1kgs': 11, '1ki': 11, 'i kings': 11,
+  '2 kings': 12, '2kings': 12, '2kgs': 12, '2ki': 12, 'ii kings': 12,
+  '1 chronicles': 13, '1chronicles': 13, '1chr': 13, '1ch': 13, 'i chronicles': 13,
+  '2 chronicles': 14, '2chronicles': 14, '2chr': 14, '2ch': 14, 'ii chronicles': 14,
+  'ezra': 15, 'ezr': 15,
+  'nehemiah': 16, 'neh': 16,
+  'esther': 17, 'est': 17, 'esth': 17,
+  'job': 18,
+  'psalm': 19, 'psalms': 19, 'psa': 19, 'ps': 19,
+  'proverbs': 20, 'prov': 20, 'pro': 20,
+  'ecclesiastes': 21, 'eccl': 21, 'ecc': 21, 'eccles': 21,
+  'song of solomon': 22, 'song': 22, 'sos': 22, 'song of songs': 22,
+  'isaiah': 23, 'isa': 23,
+  'jeremiah': 24, 'jer': 24,
+  'lamentations': 25, 'lam': 25,
+  'ezekiel': 26, 'ezek': 26, 'eze': 26,
+  'daniel': 27, 'dan': 27,
+  'hosea': 28, 'hos': 28,
+  'joel': 29, 'joe': 29,
+  'amos': 30, 'amo': 30,
+  'obadiah': 31, 'obad': 31, 'oba': 31,
+  'jonah': 32, 'jon': 32,
+  'micah': 33, 'mic': 33,
+  'nahum': 34, 'nah': 34, 'nam': 34,
+  'habakkuk': 35, 'hab': 35,
+  'zephaniah': 36, 'zeph': 36, 'zep': 36,
+  'haggai': 37, 'hag': 37,
+  'zechariah': 38, 'zech': 38, 'zec': 38,
+  'malachi': 39, 'mal': 39,
+  // New Testament (40-66)
+  'matthew': 40, 'matt': 40, 'mat': 40, 'mt': 40,
+  'mark': 41, 'mar': 41, 'mk': 41, 'mrk': 41,
+  'luke': 42, 'luk': 42, 'lk': 42,
+  'john': 43, 'joh': 43, 'jn': 43,
+  'acts': 44, 'act': 44,
+  'romans': 45, 'rom': 45, 'rm': 45,
+  '1 corinthians': 46, '1corinthians': 46, '1cor': 46, '1co': 46, 'i corinthians': 46,
+  '2 corinthians': 47, '2corinthians': 47, '2cor': 47, '2co': 47, 'ii corinthians': 47,
+  'galatians': 48, 'gal': 48,
+  'ephesians': 49, 'eph': 49,
+  'philippians': 50, 'phil': 50, 'php': 50,
+  'colossians': 51, 'col': 51,
+  '1 thessalonians': 52, '1thessalonians': 52, '1thess': 52, '1th': 52, 'i thessalonians': 52,
+  '2 thessalonians': 53, '2thessalonians': 53, '2thess': 53, '2th': 53, 'ii thessalonians': 53,
+  '1 timothy': 54, '1timothy': 54, '1tim': 54, '1ti': 54, 'i timothy': 54,
+  '2 timothy': 55, '2timothy': 55, '2tim': 55, '2ti': 55, 'ii timothy': 55,
+  'titus': 56, 'tit': 56,
+  'philemon': 57, 'philem': 57, 'phm': 57,
+  'hebrews': 58, 'heb': 58,
+  'james': 59, 'jas': 59, 'jam': 59,
+  '1 peter': 60, '1peter': 60, '1pet': 60, '1pe': 60, 'i peter': 60,
+  '2 peter': 61, '2peter': 61, '2pet': 61, '2pe': 61, 'ii peter': 61,
+  '1 john': 62, '1john': 62, '1jn': 62, 'i john': 62,
+  '2 john': 63, '2john': 63, '2jn': 63, 'ii john': 63,
+  '3 john': 64, '3john': 64, '3jn': 63, 'iii john': 64,
+  'jude': 65, 'jud': 65,
+  'revelation': 66, 'rev': 66,
+}
+
+/**
+ * Get standard book number (1-66) from book name
+ * @param bookName - Bible book name (case-insensitive)
+ * @returns Book number or null if not found
+ */
+export function getBookNumber(bookName: string): number | null {
+  const normalized = bookName.toLowerCase().trim()
+  return BOOK_NUMBERS[normalized] ?? null
+}
+
+/**
+ * Parse a Bible reference and extract translation
+ * @param fullReference - Full reference with optional translation (e.g., "John 3:16 (KJV)" or "John 3:16")
+ * @returns Parsed reference object with reference and translation
+ */
+export function parseReference(fullReference: string): ParsedReference {
+  // Match translation in parentheses at the end: (ESV), (KJV), etc.
+  const match = fullReference.match(/^(.+?)\s*\(([A-Z]+)\)\s*$/)
+
+  if (match && match[1] && match[2]) {
+    return {
+      reference: match[1].trim(),
+      translation: match[2]
+    }
+  }
+
+  // No translation specified, default to ESV
+  return {
+    reference: fullReference.trim(),
+    translation: 'ESV'
+  }
+}
+
+const MAX_VERSES = 4
+
+/**
+ * Strip HTML tags from text, preserving content
+ * @param html - HTML string
+ * @returns Plain text
+ */
+function stripHtml(html: string): string {
+  return html
+    .replace(/<S>\d+<\/S>/g, '')  // Remove Strong's numbers
+    .replace(/<i>(.*?)<\/i>/g, '$1')  // Keep italicized content
+    .replace(/<a[^>]*>(.*?)<\/a>/g, '$1')  // Keep link text
+    .replace(/<[^>]+>/g, '')  // Remove all other tags
+    .replace(/\s+/g, ' ')  // Normalize whitespace
+    .trim()
+}
+
+/**
+ * Process Bolls.life API response for single verse
+ * @param data - Response from Bolls.life API
+ * @param translation - Translation code
+ * @returns Processed verse with stripped HTML
+ */
+export function processBollsVerse(data: BollsVerseResponse, translation: string): ProcessedBibleVerse {
+  const text = stripHtml(data.text)
+
+  return {
+    text,
+    translation: translation.toUpperCase()
+  }
+}
+
+/**
+ * Process Bolls.life API response for verse range
+ * @param data - Array of verses from Bolls.life API
+ * @param translation - Translation code
+ * @param startVerse - Starting verse number (optional, for range filtering)
+ * @param endVerse - Ending verse number (optional, for range filtering)
+ * @returns Processed verses with truncation if needed
+ */
+export function processBollsVerseRange(
+  data: BollsVerseResponse[],
+  translation: string,
+  startVerse?: number,
+  endVerse?: number
+): ProcessedBibleVerse {
+  let verses = data
+
+  // Filter to verse range if specified
+  if (startVerse !== undefined) {
+    const end = endVerse ?? startVerse
+    verses = data.filter(v => v.verse >= startVerse && v.verse <= end)
+  }
+
+  // Truncate to first 4 verses if needed
+  const wasTruncated = verses.length > MAX_VERSES
+  const limitedVerses = verses.slice(0, MAX_VERSES)
+
+  // Join and strip HTML
+  const text = limitedVerses
+    .map(v => stripHtml(v.text))
+    .join(' ')
+
+  const finalText = wasTruncated ? text + ' ...' : text
+
+  return {
+    text: finalText,
+    translation: translation.toUpperCase()
+  }
+}
+
+/**
+ * Create BibleHub interlinear URL from a Bible reference
+ * @param reference - Bible reference (e.g., "John 3:16", "Genesis 1:1-3", "Psalm 23")
+ * @returns BibleHub interlinear URL
+ */
+export function createBibleHubInterlinearUrl(reference: string): string {
+  // Parse reference: "Book Chapter:Verse" or "Book Chapter:Verse-Verse2" or "Book Chapter"
+  const match = reference.match(/^(.+?)\s+(\d+)(?::(\d+))?(?:-(\d+))?/)
+
+  if (!match) {
+    // Fallback to main interlinear page if we can't parse
+    return 'https://biblehub.com/interlinear/'
+  }
+
+  const [, book, chapter, verse] = match
+
+  // Type guard: ensure book and chapter exist
+  if (!book || !chapter) {
+    return 'https://biblehub.com/interlinear/'
+  }
+
+  // Normalize book name for URL (lowercase, replace spaces with underscores)
+  const bookSlug = book.toLowerCase().replace(/\s+/g, '_')
+
+  // Build URL
+  if (verse) {
+    // Specific verse: /interlinear/book/chapter-verse.htm
+    return `https://biblehub.com/interlinear/${bookSlug}/${chapter}-${verse}.htm`
+  } else {
+    // Chapter only: /interlinear/book/chapter.htm
+    return `https://biblehub.com/interlinear/${bookSlug}/${chapter}.htm`
+  }
+}

package/mdsite-nuxt/content.config.ts

@@ -0,0 +1,18 @@
+import { defineCollection, defineContentConfig } from '@nuxt/content'
+import { loadMdsiteConfigSync } from './utils/mdsite-config.js'
+
+const { contentDir } = loadMdsiteConfigSync()
+
+export default defineContentConfig({
+  collections: {
+    content: defineCollection({
+      type: 'page',
+      source: {
+        cwd: contentDir,
+        include: '**/*.md',
+        exclude: ['**/*.draft.md'],
+        prefix: '/'
+      }
+    })
+  }
+})

package/mdsite-nuxt/example.config.yml

@@ -0,0 +1,67 @@
+content:
+  git:
+    branch: main
+    path: ../example # Path where git content is cloned/checked out relative to this file
+    repo: https://github.com/life-and-dev/md-site # If missing, assume content is part of this git repo
+  path: ../example/docs # Path where md files are located relative to this file
+features:
+  bibleTooltips: true
+  sourceEdit: false
+site:
+  canonical: 'https://life-and-dev.github.io/md-site'
+  name: 'Example Site'
+themes:
+  light:
+    colors:
+      primary: '#802020'
+      secondary: '#ffffff'
+      selected: '#802020'
+      error: '#d64d5b'
+      warning: '#c29e4a'
+      info: '#548af7'
+      success: '#6aab73'
+      background: '#f9f9f9'
+      surface: '#ffffff'
+      surface-rail: '#f5f5f5'
+      surface-appbar: '#f0f0f0'
+      on-surface-rail: '#2a2a2a'
+      on-surface-appbar: '#000000'
+      on-background: '#292929'
+      on-surface: '#292929'
+      on-primary: '#ffffff'
+      on-secondary: '#ffffff'
+      on-selectable: '#292929'
+      on-selected: '#ffffff'
+      on-error: '#ffffff'
+      on-warning: '#ffffff'
+      on-info: '#ffffff'
+      on-success: '#ffffff'
+      outline: '#d7d7d7'
+      outline-bars: '#f4f4f4'
+  dark:
+    colors:
+      primary: '#af5f5f'
+      secondary: '#302d2b'
+      selected: '#af5f5f'
+      error: '#d64d5b'
+      warning: '#c29e4a'
+      info: '#548af7'
+      success: '#6aab73'
+      background: '#161616'
+      surface: '#0d0d0d'
+      surface-rail: '#252525'
+      surface-appbar: '#282828'
+      on-surface-rail: '#d0d0d0'
+      on-surface-appbar: '#ffffff'
+      on-background: '#d1d1d1'
+      on-surface: '#d1d1d1'
+      on-primary: '#111111'
+      on-secondary: '#111111'
+      on-selectable: '#d1d1d1'
+      on-selected: '#ffffff'
+      on-error: '#ffffff'
+      on-warning: '#ffffff'
+      on-info: '#ffffff'
+      on-success: '#ffffff'
+      outline: '#303030'
+      outline-bars: '#161616'