filemayor 2.0.0

package/core/categories.js

@@ -0,0 +1,235 @@
+#!/usr/bin/env node
+
+/**
+ * ═══════════════════════════════════════════════════════════════════
+ * FILEMAYOR CORE — CATEGORIES
+ * Extension → Category mapping with configurable overrides
+ * ═══════════════════════════════════════════════════════════════════
+ */
+
+'use strict';
+
+// ─── Default Category Definitions ─────────────────────────────────
+const DEFAULT_CATEGORIES = {
+    documents: {
+        label: 'Documents',
+        extensions: [
+            '.pdf', '.doc', '.docx', '.xls', '.xlsx', '.ppt', '.pptx',
+            '.odt', '.ods', '.odp', '.rtf', '.txt', '.csv', '.tsv',
+            '.md', '.tex', '.epub', '.mobi', '.pages', '.numbers', '.key'
+        ],
+        color: '#d4af37',
+        icon: 'FileText'
+    },
+    images: {
+        label: 'Images',
+        extensions: [
+            '.jpg', '.jpeg', '.png', '.gif', '.svg', '.webp', '.bmp',
+            '.tiff', '.tif', '.ico', '.heic', '.heif', '.raw', '.cr2',
+            '.nef', '.arw', '.dng', '.psd', '.ai', '.eps', '.xcf'
+        ],
+        color: '#f472b6',
+        icon: 'Image'
+    },
+    audio: {
+        label: 'Audio',
+        extensions: [
+            '.mp3', '.wav', '.flac', '.aac', '.ogg', '.m4a', '.wma',
+            '.aiff', '.alac', '.opus', '.mid', '.midi', '.pcm'
+        ],
+        color: '#38bdf8',
+        icon: 'Music'
+    },
+    video: {
+        label: 'Video',
+        extensions: [
+            '.mp4', '.mkv', '.avi', '.mov', '.wmv', '.webm', '.flv',
+            '.m4v', '.mpg', '.mpeg', '.3gp', '.ts', '.vob', '.ogv'
+        ],
+        color: '#a78bfa',
+        icon: 'Video'
+    },
+    archives: {
+        label: 'Archives',
+        extensions: [
+            '.zip', '.rar', '.7z', '.tar', '.gz', '.bz2', '.xz',
+            '.tgz', '.tbz2', '.lz', '.lzma', '.cab', '.iso', '.dmg',
+            '.img', '.zst', '.br'
+        ],
+        color: '#34d399',
+        icon: 'Archive'
+    },
+    code: {
+        label: 'Code',
+        extensions: [
+            '.js', '.ts', '.jsx', '.tsx', '.py', '.java', '.cpp', '.c',
+            '.cs', '.go', '.rs', '.rb', '.php', '.swift', '.kt', '.scala',
+            '.lua', '.r', '.m', '.h', '.hpp', '.vue', '.svelte', '.astro',
+            '.sh', '.bash', '.zsh', '.fish', '.ps1', '.bat', '.cmd',
+            '.sql', '.graphql', '.proto', '.wasm'
+        ],
+        color: '#fb923c',
+        icon: 'Code'
+    },
+    config: {
+        label: 'Config',
+        extensions: [
+            '.json', '.yaml', '.yml', '.toml', '.ini', '.cfg', '.conf',
+            '.env', '.properties', '.xml', '.plist', '.reg'
+        ],
+        color: '#94a3b8',
+        icon: 'Settings'
+    },
+    fonts: {
+        label: 'Fonts',
+        extensions: [
+            '.ttf', '.otf', '.woff', '.woff2', '.eot', '.fon'
+        ],
+        color: '#e879f9',
+        icon: 'Type'
+    },
+    data: {
+        label: 'Data',
+        extensions: [
+            '.db', '.sqlite', '.sqlite3', '.mdb', '.accdb', '.dbf',
+            '.parquet', '.avro', '.arrow', '.ndjson', '.jsonl',
+            '.hdf5', '.h5', '.nc', '.fits'
+        ],
+        color: '#22d3ee',
+        icon: 'Database'
+    },
+    executables: {
+        label: 'Executables',
+        extensions: [
+            '.exe', '.msi', '.app', '.apk', '.deb', '.rpm', '.snap',
+            '.flatpak', '.appimage', '.pkg', '.bin', '.run',
+            '.dll', '.so', '.dylib'
+        ],
+        color: '#ef4444',
+        icon: 'Cpu'
+    },
+    design: {
+        label: 'Design',
+        extensions: [
+            '.fig', '.sketch', '.xd', '.indd', '.blend', '.3ds',
+            '.obj', '.fbx', '.stl', '.gltf', '.glb', '.usdz',
+            '.dwg', '.dxf', '.step', '.stp'
+        ],
+        color: '#c084fc',
+        icon: 'Palette'
+    },
+    books: {
+        label: 'Books',
+        extensions: [
+            '.epub', '.mobi', '.azw', '.azw3', '.djvu', '.cbz', '.cbr'
+        ],
+        color: '#fbbf24',
+        icon: 'BookOpen'
+    }
+};
+
+// ─── Extension Cache ──────────────────────────────────────────────
+let _extensionMap = null;
+
+/**
+ * Build a flat map of extension → category for O(1) lookups
+ * @param {Object} categories - Category definitions
+ * @returns {Map<string, string>} Extension to category name map
+ */
+function buildExtensionMap(categories = DEFAULT_CATEGORIES) {
+    const map = new Map();
+    for (const [categoryName, def] of Object.entries(categories)) {
+        for (const ext of def.extensions) {
+            map.set(ext.toLowerCase(), categoryName);
+        }
+    }
+    return map;
+}
+
+/**
+ * Get the category for a file extension
+ * @param {string} ext - File extension (with dot, e.g. '.pdf')
+ * @param {Object} customCategories - Optional custom categories
+ * @returns {string} Category name or 'other'
+ */
+function categorize(ext, customCategories = null) {
+    if (!ext) return 'other';
+    const normalized = ext.toLowerCase();
+
+    if (customCategories) {
+        const customMap = buildExtensionMap(customCategories);
+        return customMap.get(normalized) || 'other';
+    }
+
+    // Use cached map for default categories
+    if (!_extensionMap) {
+        _extensionMap = buildExtensionMap(DEFAULT_CATEGORIES);
+    }
+    return _extensionMap.get(normalized) || 'other';
+}
+
+/**
+ * Get all registered categories with metadata
+ * @param {Object} customCategories - Optional overrides
+ * @returns {Object} Merged categories
+ */
+function getCategories(customCategories = null) {
+    if (!customCategories) return { ...DEFAULT_CATEGORIES };
+    return { ...DEFAULT_CATEGORIES, ...customCategories };
+}
+
+/**
+ * Get all extensions registered across all categories
+ * @returns {string[]} List of all known extensions
+ */
+function getAllExtensions() {
+    const all = [];
+    for (const def of Object.values(DEFAULT_CATEGORIES)) {
+        all.push(...def.extensions);
+    }
+    return all;
+}
+
+/**
+ * Merge user-defined categories with defaults
+ * @param {Object} userCategories - User category overrides
+ * @returns {Object} Merged category map
+ */
+function mergeCategories(userCategories) {
+    const merged = { ...DEFAULT_CATEGORIES };
+    for (const [name, def] of Object.entries(userCategories)) {
+        if (merged[name]) {
+            // Merge extensions (deduplicate)
+            const existingExts = new Set(merged[name].extensions);
+            for (const ext of (def.extensions || [])) {
+                existingExts.add(ext.toLowerCase());
+            }
+            merged[name] = {
+                ...merged[name],
+                ...def,
+                extensions: [...existingExts]
+            };
+        } else {
+            // New category
+            merged[name] = {
+                label: def.label || name,
+                extensions: (def.extensions || []).map(e => e.toLowerCase()),
+                color: def.color || '#6b7280',
+                icon: def.icon || 'File'
+            };
+        }
+    }
+
+    // Rebuild cache
+    _extensionMap = buildExtensionMap(merged);
+    return merged;
+}
+
+module.exports = {
+    DEFAULT_CATEGORIES,
+    categorize,
+    getCategories,
+    getAllExtensions,
+    mergeCategories,
+    buildExtensionMap
+};