🛠️ Developer Guide

interface Document {
    id: string;              // File path as unique ID
    file: TFile;             // Obsidian file reference
    title: string;           // Display title
    type: DocumentType;      // 'markdown' | 'pdf' | 'epub' | 'image'
    path: string;            // Full vault path
    folder: string;          // Parent folder
    
    // Metadata from frontmatter
    cover?: string;          // Cover image path
    category?: string;       // Category property
    tags: string[];          // Tags array
    author?: string;         // Author name
    description?: string;    // Brief description
    status?: string;         // Workflow status
    rating?: number;         // 1-5 star rating
    
    // Timestamps
    dateCreated: number;
    dateModified: number;
    
    // Computed properties
    thumbnail?: string;
    excerpt?: string;
    wordCount?: number;
    size: number;
}

type DocumentType = 'markdown' | 'pdf' | 'epub' | 'image';

type SortOption = 'title' | 'dateCreated' | 'dateModified' | 'type' | 'category' | 'rating';

type ViewMode = 'grid' | 'list' | 'table';

interface FilterOptions {
    type?: DocumentType | 'all';
    category?: string;
    tags?: string[];
    status?: string;
    folder?: string;
    search?: string;
    rating?: number;
}

async onload(): Promise<void> {
    // 1. Load settings
    await this.loadSettings();
    
    // 2. Initialize thumbnail generator
    this.thumbnailGenerator = new ThumbnailGenerator(this.app, this);
    
    // 3. Register view
    this.registerView(
        DOCUMENT_VIEW_TYPE,
        (leaf) => new DocumentManagerView(leaf, this)
    );
    
    // 4. Add ribbon icon
    this.addRibbonIcon('library', 'Document Manager', () => {
        this.activateView();
    });
    
    // 5. Add commands
    this.addCommand({
        id: 'open-document-manager',
        name: 'Open Document Manager',
        callback: () => this.activateView()
    });
    
    // 6. Add settings tab
    this.addSettingTab(new DocumentManagerSettingTab(this.app, this));
}

async indexDocuments(): Promise<Document[]> {
    const files = this.app.vault.getFiles();
    const documents: Document[] = [];

    for (const file of files) {
        // Check if file should be included
        if (!shouldIncludeFile(file, this.settings)) {
            continue;
        }

        // Check file type
        const docType = getDocumentType(file);
        if (!docType) continue;

        // Parse document metadata
        const doc = await parseDocument(file, this.app, this.settings);
        documents.push(doc);
    }

    this.documents = documents;
    return documents;
}

class DocumentManagerView extends ItemView {
    plugin: DocumentManagerPlugin;
    private documents: Document[] = [];
    private filteredDocuments: Document[] = [];
    private filters: FilterOptions = {};
    private viewMode: ViewMode = 'grid';

    async onOpen(): Promise<void> {
        this.mainContainer = this.contentEl.createDiv({ cls: 'dm-container' });
        
        // Sidebar with filters
        this.sidebarEl = this.mainContainer.createDiv({ cls: 'dm-sidebar' });
        this.buildSidebar();

        // Main content area
        this.mainContentEl = this.mainContainer.createDiv({ cls: 'dm-main' });
        
        // Toolbar
        this.toolbarEl = this.mainContentEl.createDiv({ cls: 'dm-toolbar' });
        this.buildToolbar();

        // Document grid
        this.documentGridEl = this.mainContentEl.createDiv({ cls: 'dm-documents' });

        // Load documents
        await this.loadDocuments();
    }
}

class ThumbnailGenerator {
    private cache: Map<string, string> = new Map();

    async getThumbnail(doc: Document): Promise<string | null> {
        // 1. Check for custom cover in frontmatter
        if (doc.cover) {
            const coverPath = this.resolveCoverPath(doc.cover, doc.file);
            const coverFile = this.app.vault.getAbstractFileByPath(coverPath);
            if (coverFile instanceof TFile) {
                return this.app.vault.getResourcePath(coverFile);
            }
        }

        // 2. Check cache
        if (this.cache.has(doc.id)) {
            return this.cache.get(doc.id) || null;
        }

        // 3. Generate based on type
        switch (doc.type) {
            case 'markdown':
                return this.generateMarkdownThumbnail(doc);
            case 'image':
                return this.app.vault.getResourcePath(doc.file);
            default:
                return this.getPlaceholder(doc.type);
        }
    }
}

/* Block */
.dm-container { }
.dm-sidebar { }

/* Element */
.dm-sidebar-section { }
.dm-toolbar-group { }

/* Modifier */
.dm-sidebar.collapsed { }
.dm-view-btn.active { }