L3MON4D3/LuaSnip

Features

• Neovim Snippet Engines - Ships a scriptable Lua-based snippet engine for Neovim with tabstops, dynamic content, and tree-sitter integration.
• Structural AST Triggers - Uses abstract syntax tree patterns as triggers for snippet expansion instead of text matching.
• AST Node Matching - Matches snippet expansions against the abstract syntax tree of the file, enabling context-sensitive completions.
• Multi-Format Snippet Importers - Imports snippet collections from VSCode, SnipMate, and LSP formats into a unified snippet system for cross-editor compatibility.
• Tabstop Navigation - Defines text templates with numbered placeholders for jumping through after expansion.
• Tabstop Navigation - Moves the cursor through numbered placeholders within an expanded snippet for sequential text entry.
• Context-Aware Triggers - Triggers snippet expansions based on abstract syntax tree patterns rather than simple text matching.
• LSP Snippet String Parsers - Converts a string in the LSP snippet format into a LuaSnip snippet or snippet node.
• Lua Snippet Definitions - Creates snippets programmatically using Lua code with function, dynamic, choice, and restore nodes.
• Dynamic Snippet Content Generation - Runs Lua code at expansion time to produce snippet content that adapts to editor state or user input.
• Choice Node Cycling - Switches between alternative text options within a choice node while editing a snippet.
• Snippet Expanders - Expands Lua-defined text templates with tabstops and placeholders for interactive editing.
• Auto-Trigger Snippets - Expands a snippet automatically as soon as the trigger text is typed, without a key press.
• Snippet Templates - Defines text expansion patterns with placeholders, tabstops, and dynamic content for code insertion.
• Snippet Syntax Parsing - Parses snippet definitions from LSP, VSCode, and SnipMate formats into a unified engine.
• Choice Presentation Nodes - Provides interactive choice nodes that let users switch between alternative text options during snippet editing.
• Contextual Snippet Activation - Activates specific snippet collections based on detected file type or syntax tree position.
• Postfix Buffer Transformations - Wraps text immediately before the trigger with a template for IDE-style postfix completions.
• Snippet Collection Loading - Reads snippet definitions from VSCode, SnipMate, or Lua files on disk and registers them for the appropriate filetypes.
• Programmatic Snippet APIs - Provides a programmatic API to register new snippets via the add_snippets function.
• Text Expansion Snippets - Creates text-expansion snippets by pairing a trigger pattern with a tree of nodes.
• Lua-Based Snippet Templates - Builds reusable text templates using Lua scripting for complex, context-aware snippet generation.
• Interactive Snippet Expansion - Navigates through tabstops, choices, and computed fields within an expanded snippet for efficient text entry.
• Conditional Expansion Predicates - Applies Lua functions or logical conditions that must be true for a snippet to trigger.
• Scriptable Dynamic Content - Runs Lua functions that read other snippet nodes and insert computed results dynamically.
• Pattern-Based Triggers - Matches the text before the cursor against a Lua pattern, ECMAScript regex, or Vim regex and expands the snippet on match.
• Regex Triggers - Fires a snippet when typed text matches a regular expression pattern.
• VSCode-Style Snippet Creators - Reads snippet collections from VSCode-style package.json and JSON files and registers them for expansion.
• Tree-Sitter Prefix Matchers - Expands a snippet only when a specific tree-sitter node type or query capture precedes the trigger.
• Visual Selection Capture - Captures the current visual selection into snippet variables (TMSELECTEDTEXT, LSSELECTRAW) for use in expansions.
• Snippet Environment Variables - Provides LSP-style variables (TMCURRENTLINE, TMSELECTEDTEXT, etc.) and custom namespaced variables inside snippet nodes.
• Snippet - Reads LSP‑defined variables (TMCURRENTLINE, TM_FILENAME, etc.) and custom variables inside snippet functions.
• Snippet Frameworks - Creates reusable text templates with Lua scripting, supporting dynamic content, tabstops, and interactive fields.
• Runtime Node Evaluations - Expands snippets by evaluating a tree of nodes that can include functions, lambdas, and interactive fields at runtime.
• Snippet Placeholder References - Inserts the content of one placeholder into another location using lambdas or function nodes.
• Postfix Prefix Matchers - Triggers a postfix snippet only when a specific tree‑sitter node sits in front of the trigger.
• Node Insertions - Inserts a copy of the text from a referenced node at the current position.
• Snippet Text Repeaters - Inserts the exact content of a referenced node at the current position within a snippet.
• State-Preserving Choice Nodes - Implements choice nodes that retain user edits in shared restore nodes when switching alternatives.
• Event Callbacks - Ships a callback system that fires on node enter, leave, choice change, and pre-expand events.
• Nested Snippet Sessions - Embeds one snippet inside another so expanding the inner snippet replaces a placeholder.
• Placeholder Marker Snippet Definitions - Writes snippet bodies as strings with delimiters replaced by node objects to reduce boilerplate.
• SnipMate Syntax Parsers - Converts a string in the SnipMate format, including backtick evaluation, into a runnable LuaSnip snippet.
• Snippet Format Strings - Provides a format string syntax with placeholder markers to define snippet bodies more readably.
• Lazy Snippet Loaders - Defers loading snippet collections until a buffer with a matching filetype is opened to optimize memory usage.
• Lua File Snippet Loaders - Reads snippet collections from Lua files that return snippet tables and registers them for expansion.
• SnipMate Collection Loaders - Imports snippet collections formatted for SnipMate, including custom .snippets files, into the snippet engine.
• Editable Computed Text Insertions - Inserts lambda-computed text as editable nodes that users can override after expansion.
• Computed Value Insertions - Evaluates a function once when a snippet expands and inserts the computed return value.
• Logical Condition Combinators - Joins multiple expansion conditions with AND, OR, NOT, XOR, or XNOR operators to form complex rules.
• Behavioral Configuration - Sets global preferences such as root linking, autosnippet enabling, update events, and filetype functions.
• Event-Driven Callbacks - Attaches functions that run on node entry, exit, or choice changes to react to snippet lifecycle events.
• Conditional Fallback Insertions - Inserts conditional fallback text based on whether a referenced snippet node is empty.
• Editable Computed Text Insertions - Inserts lambda-computed text as editable nodes that users can override after expansion.
• Node Content Conditional Insertions - Inserts text conditionally by checking a predicate against a snippet node's content.
• Predicate-Based Conditional Insertions - Inserts text conditionally by evaluating a predicate against referenced node content.
• Snippet Engine Configurations - Sets options like root linking, autosnippet enabling, update events, and filetype resolution in a central setup call.
• Snippet Management - Lua-based snippet engine.

Star history