App Interface

export default class MyPlugin extends Plugin {
  async onload() {
    // Access via this.app
    const files = await this.app.workspace.getAllFiles();
    const editor = this.app.editorRegistry.getActive();
  }
}

interface App {
  // Plugin management
  pluginManager: PluginManager;
  plugins: Plugins;

  // Theme and configuration
  themeManager: ThemeManager;
  configManager: ConfigManager;

  // Commands and UI
  commandManager: CommandManager;
  tabManager: TabManager;
  statusBarManager: StatusBarManager;
  dialog: DialogManager;

  // File system
  fileSystemManager: FileSystemManager;
  workspace: Workspace;
  workspaceUI: WorkspaceUI;
  fileManager: FileManager;

  // Content and metadata
  metadataCache: MetadataCache;
  markdownProcessor: MarkdownProcessorRegistry;
  editorStateManager: EditorStateManager;
  editorRegistry: EditorRegistry;

  // Features
  bookmarkManager: BookmarkManager;
  tagManager: TagManager;
  searchService: SearchService;
  syncManager: SyncManager;
  fontManager: FontManager;

  // Utilities
  openExternalLink(url: string): Promise<void>;
}

// Get files
const allFiles = await this.app.workspace.getAllFiles();
const mdFiles = await this.app.workspace.getMarkdownFiles();

// File operations
const file = this.app.workspace.getAbstractFileByPath('note.md');
const content = await this.app.workspace.read(file);
await this.app.workspace.modify(file, 'new content');

// Events
this.registerEvent(
  this.app.workspace.onFileCreate((file) => {
    console.log('Created:', file.path);
  })
);

// Get active file
const activeFile = this.app.workspaceUI.getActiveFile();

// Open file
await this.app.workspaceUI.openFile(file, true); // true = new tab

// Events
this.registerEvent(
  this.app.workspaceUI.onActiveFileChange((file) => {
    console.log('Active file:', file?.path);
  })
);

// Create file
const newFile = await this.app.fileManager.createFile(
  'notes/new-note.md',
  '# My Note'
);

// Read and modify
const content = await this.app.fileManager.read(file);
await this.app.fileManager.modify(file, 'updated content');

// Rename and delete
await this.app.fileManager.renameFile(file, 'new-name.md');
await this.app.fileManager.trashFile(file);

// Process frontmatter
await this.app.fileManager.processFrontMatter(file, (fm) => {
  fm.title = 'New Title';
  fm.tags = ['tag1', 'tag2'];
});

// Generate markdown links
const link = this.app.fileManager.generateMarkdownLink(
  file,
  'source.md',
  '#heading',
  'Link Text'
);

// Read/write files
const content = await this.app.fileSystemManager.readFile('/path/to/file.md');
await this.app.fileSystemManager.writeFile('/path/to/file.md', content);

// Directory operations
const files = await this.app.fileSystemManager.readDirectory('/path', true);
await this.app.fileSystemManager.createDirectory('/new/folder');

// File operations
await this.app.fileSystemManager.rename('old.md', 'new.md');
await this.app.fileSystemManager.delete('/path/to/file.md');
const exists = await this.app.fileSystemManager.exists('/path/to/file.md');

// Workspace path
const workspacePath = this.app.fileSystemManager.getWorkspacePath();

// Get active editor
const editor = this.app.editorRegistry.getActive();
if (editor) {
  const content = editor.state.doc.toString();
  console.log('Current content:', content);
}

// Get specific editor
const specificEditor = this.app.editorRegistry.get('editor-id');

// Get content
const content = await this.app.editorStateManager.getContent('/path/to/file.md');

// Update content
this.app.editorStateManager.updateContent('/path/to/file.md', 'new content');

// Save file
await this.app.editorStateManager.saveFile('/path/to/file.md');

// Check if dirty
const isDirty = this.app.editorStateManager.isDirty('/path/to/file.md');

// Register command (prefer Plugin.addCommand)
this.app.commandManager.registerCommand({
  id: 'my-command',
  name: 'My Command',
  callback: () => console.log('Executed'),
}, 'plugin', this.manifest.id);

// Execute command
this.app.commandManager.executeCommand('my-command');

// Get commands
const allCommands = this.app.commandManager.getCommands();
const specific = this.app.commandManager.getCommand('my-command');

// Unregister
this.app.commandManager.unregisterCommand('my-command');

// Get cached metadata
const cache = this.app.metadataCache.getCache('/path/to/file.md');
if (cache) {
  console.log('Frontmatter:', cache.frontmatter);
  console.log('Links:', cache.links);
  console.log('Tags:', cache.tags);
  console.log('Headings:', cache.headings);
}

// Listen for changes
this.registerEvent(
  this.app.metadataCache.onChanged((file, data, cache) => {
    console.log('Metadata changed:', file.path);
  })
);

// Register code block processor
this.app.markdownProcessor.registerCodeBlockProcessor(
  'mermaid',
  (source, el, ctx) => {
    el.setText('Diagram: ' + source);
  }
);

// Register post processor
this.app.markdownProcessor.registerPostProcessor((el, ctx) => {
  const links = el.findAll('a');
  links.forEach(link => link.addClass('external-link'));
});

// Add item (prefer Plugin.addStatusBarItem)
const item = this.app.statusBarManager.addItem(this.manifest.id, 'right');
item.setText('Status');
item.setIcon('info');

// Get all items
const items = this.app.statusBarManager.getItems();

// Remove item
this.app.statusBarManager.removeItem(item.id);

// Open tab
await this.app.tabManager.openTab('/path/to/file.md', {
  openInNewTab: true,
});

// Get tabs
const activeTab = this.app.tabManager.getActiveTab();
const allTabs = this.app.tabManager.getAllTabs();

// Switch/close tabs
this.app.tabManager.switchTab('tab-id');
await this.app.tabManager.closeTab('tab-id');

// Open file dialog
const files = await this.app.dialog.showOpenDialog({
  title: 'Select Files',
  multiple: true,
  filters: [
    { name: 'Markdown', extensions: ['md', 'markdown'] },
    { name: 'All Files', extensions: ['*'] },
  ],
});

// Save dialog
const savePath = await this.app.dialog.showSaveDialog({
  title: 'Save As',
  defaultPath: 'untitled.md',
});

// Folder dialog
const folder = await this.app.dialog.showFolderDialog({
  title: 'Select Folder',
});

// Search
const results = await this.app.searchService.search({
  query: 'search term',
  searchContent: true,
  limit: 50,
});

for (const result of results) {
  console.log(result.file.path);
  console.log('Score:', result.score);
  console.log('Match:', result.matchType);
  console.log('Context:', result.matchContext);
}

// Build index
if (!this.app.searchService.isIndexBuilt()) {
  await this.app.searchService.buildIndex();
}

// Get bookmarks
const groups = this.app.bookmarkManager.getGroups();
const group = this.app.bookmarkManager.getGroup('group-id');

// Create group
const newGroup = await this.app.bookmarkManager.createGroup(
  'My Group',
  'Description',
  '#ff0000'
);

// Add bookmark
const bookmark = await this.app.bookmarkManager.addBookmark(
  group.id,
  '/path/to/file.md',
  'My Bookmark',
  'Some notes'
);

// Check if bookmarked
const isBookmarked = this.app.bookmarkManager.isBookmarked('/path/to/file.md');

// Events
this.registerEvent(
  this.app.bookmarkManager.on('change', () => {
    console.log('Bookmarks changed');
  })
);

// Get tags
const tags = this.app.tagManager.getTags();
const tag = this.app.tagManager.getTag('tag-id');

// Create tag
const newTag = await this.app.tagManager.createTag('important', '#ff0000');

// Tag notes
await this.app.tagManager.addTagToNote('/path/to/file.md', tag.id);
await this.app.tagManager.removeTagFromNote('/path/to/file.md', tag.id);

// Query
const noteTags = this.app.tagManager.getTagsForNote('/path/to/file.md');
const taggedNotes = this.app.tagManager.getNotesForTag(tag.id);

// Events
this.registerEvent(
  this.app.tagManager.on('change', () => {
    console.log('Tags changed');
  })
);

// Get settings
const settings = this.app.pluginManager.getPluginSettings<MySettings>(
  this.manifest.id
);

// Save settings
await this.app.pluginManager.savePluginSettings(
  this.manifest.id,
  settings
);

// Enable/disable plugins
await this.app.pluginManager.enablePlugin('plugin-id');
await this.app.pluginManager.disablePlugin('plugin-id');

// Check if built-in
const isBuiltIn = this.app.pluginManager.isBuiltIn('plugin-id');

// Get plugin
const plugin = this.app.plugins.getPlugin('plugin-id');

// Check status
const isEnabled = this.app.plugins.isEnabled('plugin-id');
const isBuiltIn = this.app.plugins.isBuiltIn('plugin-id');

// Control plugins
await this.app.plugins.enable('plugin-id');
await this.app.plugins.disable('plugin-id');
const newState = await this.app.plugins.toggle('plugin-id');

// Get all plugins
const allPlugins = this.app.plugins.getAll();
const enabledPlugins = this.app.plugins.getEnabled();

// Settings
const settings = this.app.plugins.getSettings<MySettings>('plugin-id');
await this.app.plugins.saveSettings('plugin-id', settings);

// Listen for changes
const unsubscribe = this.app.plugins.onPluginChange(
  (pluginId, changeType) => {
    console.log(`${pluginId} ${changeType}`);
  }
);

// Get color scheme
const scheme = this.app.themeManager.getColorScheme(); // 'light' | 'dark' | 'system'

// Set color scheme
await this.app.themeManager.setColorScheme('dark');

// Get current theme
const theme = this.app.themeManager.getCurrentTheme();

// Load config
const config = await this.app.configManager.loadConfig<MyConfig>('my-config');

// Save config
await this.app.configManager.saveConfig('my-config', {
  setting1: 'value1',
  setting2: true,
});

// Check sync status
const isEnabled = this.app.syncManager.isEnabled();
const isLoggedIn = this.app.syncManager.isLoggedIn();

// Trigger sync
await this.app.syncManager.syncNow();

// Get available fonts
const fonts = this.app.fontManager.getSystemFonts();
console.log('Available fonts:', fonts);

await this.app.openExternalLink('https://inkdown.app');