lumide_api 1.0.0

lumide_api: ^1.0.0 copied to clipboard

🦊 Initial stable release for lumide_api. The API is now mostly feature-complete for Language Server Protocol (LSP) integrations and core editor extensions.

New features #

• Languages API — Added languages.registerLanguageServer to register custom Language Server Protocol (LSP) providers for specific file extensions.
• FileSystem API — Added fs.downloadFile to download files natively from the IDE with built-in progress tracking and optional .tar.gz/.zip extraction.

New features #

• Quick Pick Improvements — QuickPickItem now supports a tooltip field for rendering rich hover tooltips on individual options.

New features #

• Workspace — getRootUri() to get the workspace root path, findFiles(glob) to search files by glob pattern.
• FileSystem — isDirectory(path) to check if a path is a directory.
• Editor — getDocumentText(uri) to read open document content, openDocument(uri) to open files, revealRange() to navigate to a specific location.
• Window — showConfirmDialog(message) for OK/Cancel dialogs, title parameter on showMessage().
• Shell — workingDirectory parameter on run() to execute commands in a specific directory.

Improvements #

• Plugin lifecycle — LumidePlugin.run() now guarantees onDeactivate() is called even when the host IDE crashes or the stdio pipe breaks unexpectedly. This prevents orphaned child processes from plugins that spawn external processes.

New features #

• Theming system — Support contributing color themes and icon themes via contributes.themes and contributes.iconThemes in plugin.yaml.
• Manifest improvements — Added copyWith to LumideManifest for easier state modification.

New features #

• WebViews — Create and manage custom UI panels via window.createWebviewPanel.
• URL Opening — Open external URLs via window.openUrl.
• Output Control — Added LumideOutputChannel.clear() to clear logs programmatically.

New features #

• Activation Events — LumideManifest now supports activation_events to control plugin loading (e.g., onCommand, workspaceContains).
• Quick Pick Icons — QuickPickItem now supports iconPath (SVG/Image), enabled state, and isSeparator.
• Status Bar Icons — LumideStatusBar items now support iconPath for rendering SVGs.
• Toolbar Icons — LumideToolbar items now support iconPath for rendering SVGs.

New features #

• Structured Logging — LumideOutputChannel.appendLog allows appending structured log records (LumideLogRecord) with levels, error details, and stack traces.

New features #

• Toolbar API — Register items in the top toolbar via LumideToolbar. Supports icons, tooltips, alignment, and priority.
• Terminal API — Create, control, and interact with integrated terminals via LumideTerminal.
• Output API — Create and write to output channels via LumideOutputChannel.
• Editor Selection API — getSelectedText and replaceSelection for easier text manipulation.
• Quick Pick Improvements — showQuickPick now supports rich QuickPickItem objects with descriptions, details, and icons.
• Window Positioning — showQuickPick accepts an optional anchor position.

Breaking changes #

• Commands API — LumideCommands.registerCommand callback now accepts an optional Map<String, dynamic>? args parameter. Existing callbacks must be updated.

New features #

• Commands API — Register commands for the Command Palette via LumideCommands.registerCommand().
• Keybindings — Declare keybindings in plugin.yaml under contributes.keybindings.
• Status Bar API — Create, update, show/hide, and dispose status bar items via LumideStatusBar.
• Editor events — editor.onDidChangeSelections and editor.onDidChangeActiveDocument push selection and focus changes to plugins.
• Workspace events — workspace.onDidSaveTextDocument notifies when a document is saved.

Breaking changes #

• workspace/onDidChangeConfiguration is now a host-to-plugin method (was previously plugin-to-IDE). Plugins receive configuration updates passively instead of polling.

• Initial public release of the Lumide Plugin SDK.
• Support for core plugin lifecycle management (onActivate, onDeactivate).
• FileSystem API: Generic file/directory operations (read, write, list, exists).
• Editor API: Active document tracking, text insertion, selection management, and range replacement.
• Workspace API: Configuration management and document event listeners (open, close, change).
• Window API: UI interaction methods (showMessage, showQuickPick, showInputBox).
• Shell API: Controlled execution of host shell commands.
• HTTP API: Standardized network requests (GET, POST).
• Comprehensive JSON-RPC 2.0 based communication layer.