rocks.nvim ecosystem

Lumen-OSS plugins

These plugins form the foundation of Rocksmarker's plugin management and configuration system, providing a robust and streamlined experience for managing Neovim plugins and their dependencies:

rocks.nvim

rocks.nvim is a Neovim plugin manager designed for efficiency and ease of use, inspired by Cargo's dependency management. It uses Luarocks to automate plugin installation, updates, and dependency resolution.

rocks.nvim assigns dependency and build configuration tasks to plugin authors, reducing user effort. This minimizes compatibility issues and ensures plugins remain up to date.

Users define plugins and dependencies in a rocks.toml configuration file. Rocks.nvim automates the setup, updates, and dependency management. The outcome is a streamlined workflow, optimized performance, and a stable editing environment.

rocks-config.nvim

rocks-config.nvim is a lightweight and modular plugin designed to offer a safe, structured, and conflict-free way to manage Neovim configurations. Built as part of the Lumen-OSS ecosystem, it complements rocks.nvim by providing a structured approach to plugin management.
The plugin offers a clean API for loading and organizing plugin settings. This ensures users customize their Neovim environment while avoiding conflicts or instability.

rocks-config.nvim introduces a declarative and isolated approach, allowing users to define configurations in a way that is both predictable and maintainable.
This makes it easier to share configurations across different machines or projects, while also simplifying the process of debugging and updating settings.

One of the key advantages of rocks-config.nvim is its integration with rocks.nvim, which automates dependency management. The plugin uses Lua's modular design to scope configurations by plugin or workflow. This reduces conflicts between different setups.

Its focus on stability and extensibility aligns with the requirements of projects such as Rocksmarker, where a consistent, reliable editing environment is essential.

rocks-treesitter.nvim

rocks-treesitter.nvim is a plugin that automates Tree-sitter parser management in Neovim. It delivers real-time syntax highlighting, code navigation, and advanced text analysis across many languages and file types.
As a part of the Lumen-OSS ecosystem, it integrates with rocks.nvim to automate Tree-sitter parser installation, updates, and configuration by using Luarocks.
This removes the requirement for manual compilation or external tools, guaranteeing parsers remain current and performance-optimized.

The system installs parsers dynamically, on-demand, when opening relevant file types. This maintains a lightweight, responsive Neovim environment while providing the full capabilities of Tree-sitter's incremental parsing.

import = ["rocks-treesitter.toml"]
....
....
[treesitter]
# auto_highlight = "all"
# NOTE: These are parsers, not filetypes.
auto_highlight = [
    "lua",
    "luadoc",
    "markdown",
    "markdown_inline",
    ....
    ....
    "css",
    "html",
]
auto_install = "true"
config_path = "rocks-treesitter.toml"

The plugin uses a declarative configuration system in rocks-treesitter.toml. Users define enabled parsers, customize behavior, and manage dependencies efficiently.

This method simplifies setup and guarantees consistency across machines and projects. rocks-treesitter.nvim supports Markdown, Lua, JSON, YAML, Bash, and additional languages.
It improves editing with context-aware syntax highlighting, code folding, and smart navigation, serving as a core tool for developers and technical writers.

# Treesitter parser configuration files.

# The list is dynamically updated 'on demand' by the rocks-treesitter.nvim
# plugin. If the parser is missing for the open 'file type' in the buffer it is
# downloaded and activated automatically.

[plugins]
tree-sitter-cli = "0.26.3"
tree-sitter-toml = "0.0.31"
tree-sitter-gitcommit = "0.0.34"
tree-sitter-gitignore = "0.0.29"
tree-sitter-markdown = "0.0.48"
tree-sitter-markdown_inline = "0.0.46"
....
....

Deep integration with Rocksmarker delivers exact parsing and increased productivity.

The plugin abstracts parser management complexities, enabling users to concentrate on their tasks while leveraging Tree-sitter's full capabilities in Neovim.

rocks-edit.nvim

rocks-edit.nvim is a diagnostic and editing enhancement plugin designed specifically for the rocks.nvim ecosystem, providing real-time feedback and intelligent editing support directly within Neovim. It acts as a diagnostic provider for the rocks.toml configuration file, helping users identify and resolve issues related to plugin configurations, dependencies, and compatibility.

The plugin delivers inline diagnostics, allowing users to detect and correct errors within the editor. This covers missing dependencies, wrong settings, and version conflicts.

Proactive error detection minimizes setup problems and strengthens the reliability of the Neovim environment.
Beyond diagnostics, rocks-edit.nvim also improves the editing experience by integrating smart editing features, such as auto-completion, syntax-aware navigation, and contextual suggestions, tailored for TOML and other configuration files.

Its integration with rocks.nvim and rocks-config.nvim enables confident plugin and settings management. This reduces configuration errors and enhances workflow efficiency.

Ecosystem overview

The Lumen-OSS suite (rocks.nvim, rocks-config.nvim, rocks-treesitter.nvim, rocks-edit.nvim) simplifies Neovim plugin management and editing.

It automates dependencies, organizes configuration, parses syntax in real time, and provides intelligent diagnostics. Users gain a stable, flexible, and high-performance environment for development, writing, and advanced editing.

Modular, efficient, and user-focused, Lumen-OSS reduces setup overhead and enhances productivity.