Saffron for VS Code

Language support for Saffron's .saffron files — the Gherkin superset with StepSet: — plus vocabulary-aware editing for plain .feature files in Saffron projects.

What you get

• Syntax highlighting for .saffron: all Gherkin keywords plus first-class StepSet: definitions and StepSet <name> invocations, <param> placeholders, tables, doc strings.
• Step completion with status badges. Type a step keyword (Given , When , …) and every step the project knows is suggested, ranked by usage, badged from the replay cache:
  • ● recorded — replays at zero tokens
  • ● divergent — same text, different recordings
  • ○ written, not recorded yet
• StepSet completion after typing StepSet , with the set's steps in the documentation popup.
• Go to definition on a StepSet <name> invocation jumps to the StepSet: block, wherever it lives.
• Hover on steps (status, usage, files) and on invocations (the expanded steps with badges).
• Diagnostics: unknown StepSet names, duplicate set definitions (with the "remove the colon to invoke" hint), and near-duplicate wording warnings — writing "I visit the home page" when "I navigate to the home page" is already recorded gets flagged before it costs a recording.

The vocabulary is derived live from your workspace: .feature/.saffron files contribute the wording, .saffron/cache/**.json contributes the status. No configuration.

Install (pre-marketplace)

The extension ships to the marketplace with Saffron's public release. Until then, from this folder:

npm run package                                   # builds saffron-vscode-0.1.0.vsix
code --install-extension saffron-vscode-0.1.0.vsix

or for development: open this folder in VS Code and press F5 (Extension Development Host).

Zero-extension fallback

Without this extension, saffron steps --snippets writes .vscode/saffron.code-snippets for native completion, and one settings line gives .saffron files Gherkin highlighting:

{ "files.associations": { "*.saffron": "feature" } }