Neovim support for Factor

A Neovim plugin for the Factor programming language, providing vocabulary navigation, syntax highlighting, and auto-pairing support.

Features

Vocabulary Navigation: Quickly navigate between Factor vocabularies and their related files (implementation, docs, tests)
Syntax Highlighting: Full syntax highlighting for Factor code
Auto-pairing: Smart bracket, quote, and parenthesis pairing (optional)
File Type Detection: Automatic detection of Factor files and proper filetype setting
Vocabulary Roots: Support for multiple vocabulary roots including custom paths

Installation

Using lazy.nvim

{
  "factor/factor.nvim",
  ft = "factor",
  config = function()
    require("factor").setup({
      -- Configuration options (see below)
    })
  end
}

Using packer.nvim

use {
  "factor/factor.nvim",
  ft = "factor",
  config = function()
    require("factor").setup({
      -- Configuration options (see below)
    })
  end
}

Configuration

The plugin can be configured by calling the setup function:

require("factor").setup({
  -- Path to your Factor installation (default: ~/factor/)
  resource_path = vim.fn.expand("~/factor/"),
  
  -- Default vocabulary roots
  default_vocab_roots = {
    "resource:core",
    "resource:basis", 
    "resource:extra",
    "resource:work"
  },
  
  -- Additional vocabulary roots (can also be set in ~/.factor-roots)
  additional_vocab_roots = nil,
  
  -- Function to determine the root for new vocabularies
  new_vocab_root = function()
    return "resource:work"
  end,
  
  -- Enable smart auto-pairing of brackets, quotes, etc.
  enable_autopairs = false,
  
  -- Characters to escape in glob patterns
  glob_escape = vim.loop.os_uname().sysname == "Windows" and "*[]?`{$" or "*[]?`{$\\"
})

Key Mappings

The plugin provides the following default key mappings:

Key	Description
`<Leader>fi`	Go to vocabulary implementation file
`<Leader>fd`	Go to vocabulary documentation file
`<Leader>ft`	Go to vocabulary tests file
`<Leader>fv`	Go to a vocabulary (prompts for name)
`<Leader>fn`	Create a new vocabulary (prompts for name)

Commands

Command	Description
`:FactorVocab <name>`	Navigate to a vocabulary by name
`:NewFactorVocab <name>`	Create a new vocabulary
`:FactorVocabImpl`	Go to the implementation file of the current vocabulary
`:FactorVocabDocs`	Go to the documentation file of the current vocabulary
`:FactorVocabTests`	Go to the tests file of the current vocabulary

Auto-pairing

When enable_autopairs is set to true, the plugin provides intelligent auto-pairing:

[ → [] with cursor in between
( → () with cursor in between
{ → {} with cursor in between
" → "" with cursor in between
[ + = → [=|=] for literal arrays
( + Space → ( -- ) for stack effects
Pressing Space inside brackets adds padding: [] → [ | ]
Pressing Enter inside brackets creates a multi-line block
Backspace intelligently removes paired characters

File Structure

The plugin recognizes the following Factor file conventions:

*.factor - Factor source files
*-docs.factor - Documentation files
*-tests.factor - Test files
.factor-rc, factor-rc - Factor RC files
~/.factor-roots - File containing additional vocabulary roots

Vocabulary Roots

The plugin searches for vocabularies in the following locations:

Standard Factor directories (core, basis, extra, work) under your Factor installation
Custom paths defined in ~/.factor-roots (one path per line)
Additional paths configured via the additional_vocab_roots option

Vocabulary roots can be specified using:

resource: prefix - relative to Factor installation directory
vocab: prefix - search in all vocabulary roots
Absolute paths

Requirements

Neovim 0.7.0 or higher
Factor programming language (for actual code execution)

Credits

Based on the original factor.vim Vimscript plugin.