emoemu 0.1.0

package/src/frontend/playlist/labelFormatter/consts.ts

@@ -0,0 +1,15 @@
+/** Articles that can appear at end of title (case-insensitive matching) */
+export const TRAILING_ARTICLES = ['The', 'A', 'An'];
+
+/** Words that should be lowercase in title case (unless first word) */
+export const LOWERCASE_WORDS = new Set([
+  'a', 'an', 'the',           // articles
+  'and', 'but', 'or', 'nor',  // conjunctions
+  'for', 'yet', 'so',         // FANBOYS conjunctions
+  'at', 'by', 'in', 'of',     // short prepositions
+  'on', 'to', 'up', 'as',
+  'vs', 'vs.',                // versus
+]);
+
+/** Roman numeral pattern (I, II, III, IV, V, etc.) */
+export const ROMAN_NUMERAL_PATTERN = /^(M{0,3})(CM|CD|D?C{0,3})(XC|XL|L?X{0,3})(IX|IV|V?I{0,3})$/i;

package/src/frontend/playlist/labelFormatter/index.ts

@@ -0,0 +1,155 @@
+/**
+ * ROM Label Formatting Utility
+ *
+ * Fixes common formatting issues in ROM titles:
+ * - Converts ALL CAPS to Title Case
+ * - Moves trailing articles (The, A, An) to the front
+ */
+
+import {
+  TRAILING_ARTICLES,
+  LOWERCASE_WORDS,
+  ROMAN_NUMERAL_PATTERN,
+} from './consts';
+import { getSupportedExtensions } from '../../coreRegistry';
+
+export * from './consts';
+
+/**
+ * Check if a word is a Roman numeral.
+ */
+const isRomanNumeral = (word: string): boolean => {
+  const cleaned = word.replace(/[^a-zA-Z]/g, '');
+  return cleaned.length > 0 && ROMAN_NUMERAL_PATTERN.test(cleaned);
+};
+
+/**
+ * Check if a string is all uppercase (ignoring non-letter characters).
+ * Returns false for strings with no letters.
+ */
+const isAllCaps = (str: string): boolean => {
+  const letters = str.replace(/[^a-zA-Z]/g, '');
+  return letters.length > 0 && letters === letters.toUpperCase();
+};
+
+/**
+ * Capitalize the first letter of a word, preserving the rest.
+ */
+const capitalizeFirst = (word: string): string => {
+  if (word.length === 0) { return word; }
+  return word.charAt(0).toUpperCase() + word.slice(1).toLowerCase();
+};
+
+/**
+ * Convert a string to title case.
+ * - First word is always capitalized
+ * - Articles, short prepositions, and conjunctions are lowercase (unless first word)
+ * - Roman numerals stay uppercase
+ */
+const toTitleCase = (str: string): string => {
+  const words = str.split(/(\s+)/); // Split but keep whitespace
+
+  let isFirstWord = true;
+  return words.map((segment) => {
+    // Preserve whitespace segments
+    if (/^\s+$/.test(segment)) {
+      return segment;
+    }
+
+    const word = segment;
+    const lowerWord = word.toLowerCase();
+
+    // Roman numerals stay uppercase
+    if (isRomanNumeral(word)) {
+      isFirstWord = false;
+      return word.toUpperCase();
+    }
+
+    // First word is always capitalized
+    if (isFirstWord) {
+      isFirstWord = false;
+      return capitalizeFirst(word);
+    }
+
+    // Check if this word should stay lowercase
+    if (LOWERCASE_WORDS.has(lowerWord)) {
+      return lowerWord;
+    }
+
+    // Capitalize the word
+    return capitalizeFirst(word);
+  }).join('');
+};
+
+/**
+ * Strip file extension from the end of a label (case-insensitive).
+ * Uses extensions supported by loaded cores.
+ * "Super Mario Bros.NES" -> "Super Mario Bros"
+ */
+const stripFileExtension = (str: string): string => {
+  // Match any extension at the end (e.g., ".NES", ".nes", ".sfc")
+  const match = str.match(/(\.[a-zA-Z0-9]+)$/);
+  if (match) {
+    const ext = match[1].toLowerCase();
+    // Get supported extensions from loaded cores (already lowercase with dot)
+    const supportedExtensions = new Set(getSupportedExtensions());
+    if (supportedExtensions.has(ext)) {
+      return str.slice(0, -ext.length).trim();
+    }
+  }
+  return str;
+};
+
+/**
+ * Move trailing articles to the front of the title.
+ * "Legend of Zelda, The" -> "The Legend of Zelda"
+ * "Legend of Zelda. The" -> "The Legend of Zelda"
+ * "Boy and His Blob, A" -> "A Boy and His Blob"
+ */
+const moveTrailingArticle = (str: string): string => {
+  for (const article of TRAILING_ARTICLES) {
+    // Match ", The" or ". The" with any amount of whitespace (case insensitive)
+    const pattern = new RegExp(`[,.]\\s*${article}\\s*$`, 'i');
+    const match = str.match(pattern);
+    if (match) {
+      const withoutArticle = str.slice(0, match.index).trim();
+      // Use the canonical article casing
+      return `${article} ${withoutArticle}`;
+    }
+  }
+  return str;
+};
+
+/**
+ * Format a ROM label for display.
+ * - Strips file extensions (.nes, .sfc, etc.)
+ * - Replaces underscores with spaces
+ * - Moves trailing articles (The, A, An) to the front
+ * - Converts ALL CAPS titles to Title Case
+ * - Normalizes whitespace
+ */
+export const formatRomLabel = (label: string): string => {
+  let result = label.trim();
+
+  // Strip file extension first
+  result = stripFileExtension(result);
+
+  // Replace underscores with spaces
+  result = result.replace(/_/g, ' ');
+
+  // Check if all caps BEFORE any transformations
+  const wasAllCaps = isAllCaps(result);
+
+  // Move trailing articles to front
+  result = moveTrailingArticle(result);
+
+  // Convert all caps to title case (based on original check)
+  if (wasAllCaps) {
+    result = toTitleCase(result);
+  }
+
+  // Normalize whitespace (collapse multiple spaces)
+  result = result.replace(/\s+/g, ' ').trim();
+
+  return result;
+};

package/src/frontend/playlist/labelFormatter/tests.ts

@@ -0,0 +1,153 @@
+/**
+ * Tests for ROM label formatting utility
+ */
+
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { formatRomLabel } from '.';
+
+// Mock the core registry to provide test extensions (lowercase, matching real behavior)
+vi.mock('../../coreRegistry', () => ({
+  getSupportedExtensions: () => ['.nes', '.sfc', '.md', '.gba', '.bin'],
+}));
+
+beforeEach(() => {
+  vi.clearAllMocks();
+});
+
+describe('formatRomLabel', () => {
+  describe('trailing article handling', () => {
+    it('moves "The" from end to beginning', () => {
+      expect(formatRomLabel('Legend of Zelda, The')).toBe('The Legend of Zelda');
+    });
+
+    it('moves "A" from end to beginning', () => {
+      expect(formatRomLabel('Boy and His Blob, A')).toBe('A Boy and His Blob');
+    });
+
+    it('moves "An" from end to beginning', () => {
+      expect(formatRomLabel('American Tail, An')).toBe('An American Tail');
+    });
+
+    it('handles no space after comma', () => {
+      expect(formatRomLabel('Legend of Zelda,The')).toBe('The Legend of Zelda');
+    });
+
+    it('handles multiple spaces after comma', () => {
+      expect(formatRomLabel('Legend of Zelda,  The')).toBe('The Legend of Zelda');
+      expect(formatRomLabel('Legend of Zelda,   The')).toBe('The Legend of Zelda');
+    });
+
+    it('handles period instead of comma', () => {
+      expect(formatRomLabel('Legend of Zelda. The')).toBe('The Legend of Zelda');
+      expect(formatRomLabel('Legend of Zelda.The')).toBe('The Legend of Zelda');
+      expect(formatRomLabel('Legend of Zelda.   The')).toBe('The Legend of Zelda');
+    });
+
+    it('is case-insensitive for article matching', () => {
+      expect(formatRomLabel('Legend of Zelda, THE')).toBe('The Legend of Zelda');
+      expect(formatRomLabel('Legend of Zelda, the')).toBe('The Legend of Zelda');
+    });
+
+    it('does not modify titles without trailing articles', () => {
+      expect(formatRomLabel('Super Mario Bros')).toBe('Super Mario Bros');
+    });
+
+    it('does not match articles in the middle', () => {
+      expect(formatRomLabel('The Legend of Zelda')).toBe('The Legend of Zelda');
+    });
+  });
+
+  describe('all caps to title case', () => {
+    it('converts all caps to title case', () => {
+      expect(formatRomLabel('THE LEGEND OF ZELDA')).toBe('The Legend of Zelda');
+    });
+
+    it('lowercases articles and prepositions in the middle', () => {
+      expect(formatRomLabel('SUPER MARIO BROS')).toBe('Super Mario Bros');
+      expect(formatRomLabel('STREETS OF RAGE')).toBe('Streets of Rage');
+    });
+
+    it('preserves Roman numerals', () => {
+      expect(formatRomLabel('FINAL FANTASY III')).toBe('Final Fantasy III');
+      expect(formatRomLabel('MEGA MAN II')).toBe('Mega Man II');
+      expect(formatRomLabel('SUPER MARIO BROS IV')).toBe('Super Mario Bros IV');
+    });
+
+    it('does not modify mixed case titles', () => {
+      expect(formatRomLabel('The Legend of Zelda')).toBe('The Legend of Zelda');
+      expect(formatRomLabel('Super Mario Bros.')).toBe('Super Mario Bros.');
+    });
+
+    it('handles single word all caps', () => {
+      expect(formatRomLabel('TETRIS')).toBe('Tetris');
+    });
+  });
+
+  describe('combined transformations', () => {
+    it('moves article and converts case', () => {
+      expect(formatRomLabel('LEGEND OF ZELDA, THE')).toBe('The Legend of Zelda');
+    });
+
+    it('handles complex titles', () => {
+      expect(formatRomLabel('ADVENTURES OF LOLO III, THE')).toBe('The Adventures of Lolo III');
+    });
+  });
+
+  describe('file extension stripping', () => {
+    it('strips .NES extension (uppercase)', () => {
+      expect(formatRomLabel('The Legend of Zelda.NES')).toBe('The Legend of Zelda');
+    });
+
+    it('strips .nes extension (lowercase)', () => {
+      expect(formatRomLabel('Super Mario Bros.nes')).toBe('Super Mario Bros');
+    });
+
+    it('strips various ROM extensions', () => {
+      expect(formatRomLabel('Sonic.md')).toBe('Sonic');
+      expect(formatRomLabel('Zelda.sfc')).toBe('Zelda');
+      expect(formatRomLabel('Pokemon.gba')).toBe('Pokemon');
+      expect(formatRomLabel('Game.bin')).toBe('Game');
+    });
+
+    it('strips extension and converts all caps', () => {
+      expect(formatRomLabel('SUPER MARIO BROS.NES')).toBe('Super Mario Bros');
+    });
+
+    it('does not strip unknown extensions', () => {
+      expect(formatRomLabel('Game.xyz')).toBe('Game.xyz');
+    });
+
+    it('handles extension with spaces before it', () => {
+      expect(formatRomLabel('Super Mario Bros .nes')).toBe('Super Mario Bros');
+    });
+  });
+
+  describe('underscore handling', () => {
+    it('replaces underscores with spaces (mixed case preserved)', () => {
+      expect(formatRomLabel('Super_Mario_Bros')).toBe('Super Mario Bros');
+    });
+
+    it('replaces underscores and converts all caps', () => {
+      expect(formatRomLabel('SUPER_MARIO_ALL_STARS')).toBe('Super Mario All Stars');
+    });
+
+    it('handles multiple underscores', () => {
+      expect(formatRomLabel('LEGEND__OF__ZELDA')).toBe('Legend of Zelda');
+    });
+  });
+
+  describe('whitespace handling', () => {
+    it('trims leading and trailing whitespace', () => {
+      expect(formatRomLabel('  Super Mario Bros  ')).toBe('Super Mario Bros');
+    });
+
+    it('normalizes multiple spaces in the middle', () => {
+      expect(formatRomLabel('Super  Mario   Bros')).toBe('Super Mario Bros');
+      expect(formatRomLabel('Mario    Bros')).toBe('Mario Bros');
+    });
+
+    it('normalizes tabs and other whitespace', () => {
+      expect(formatRomLabel('Super\tMario\t\tBros')).toBe('Super Mario Bros');
+    });
+  });
+});