Grammar-Kit Changelog

April 29, 2026 ยท View on GitHub

Unreleased

2023.3.2

2023.3.1

  • BNF Highlighting: distinguish explicit vs. implicit tokens #383 by @fan-tom
  • Generator: allow configuring fallback stub element type #403
  • Generator: fix invalid @Experimental annotation generation for 2025.1 #399
  • BNF: fix potential NPE in attribute compatibility resolution #404
  • Generator: remove Fleet-related generation
  • Context menu: Remove actions: "Fleet: Generate Parser Code", "Fleet: Generate JFlex Lexer", "Fleet: Run JFlex Generator"

2023.3

  • JFlex: update library from jflex-1.9.1 to jflex-1.9.2 #349
  • Update IntelliJ Platform to 2023.3
  • Compatibility: IntelliJ IDEA 2024.2
  • BNF Highlighting: highlight pinned elements re-using Language Defaults | Identifiers | Reassigned local variable instead of custom setting
  • Context menu: Fleet: Generate Parser Code
  • Context menu: Fleet: Generate JFlex Lexer
  • Context menu: Fleet: Run JFlex Generator

2022.3.2

  • JFlex: complete classes in java references
  • JFlex: support generic java class names #333
  • JFlex: extract skeleton from jflex jar #332
  • JFlex: update library from 1.7.0-2 to jflex-1.9.1 #325
  • JFlex: support both Velocity 1.7 and 2.3 (IJ 232+) #331

2022.3.1

  • Update IntelliJ Platform to 2022.3.1
  • Fixed Exception with 2023.1 EAP: "Do not use constructor injection" #323
  • Fixed IAE: FileEditorManagerImpl.$$$reportNull$$\$0 (EA-746745)
  • Fixed PIEAE: CompositePsiElement.getContainingFile (EA-746675)

2022.3

2021.1.2

  • Generator: cache NEXT to avoid freezes
  • Generator: avoid java-api in standalone mode #278
  • Generator: fix NPE for "exact-types" + factory method #286
  • Generator: fix missing @Override on visitor methods
  • Generator: type annotations support (ASM)

2021.1

  • JFlex: update downloadable lib url #264
  • Plugin: move java-related extensions to optional config #261
  • Editor: do not resolve meta rule parameters to rules
  • LivePreview: problem with meta rules #254

2020.3.1

  • Generator: add missing space after comma in types
  • Generator: fix double annotations for compiled elements (#251)
  • Generator: add override check if mixin present
  • Generator: detailed warning on incorrect method spec (#252)

2020.3

  • Generator: add type annotations (in IDE only)
  • Generator: add @override to visitor methods
  • Generator: do not force child expr consume-type in a non-expr context
  • Generator: skip "upper" rules in containing rules PSI (#248)
  • Generator: switch default java version to 11
  • Generator: use same charset as bnf explicitly
  • Generator: introduce generate=[fqn="yes/no"] option
  • Editor: highlight missing external methods (#242)
  • Editor: more class references in strings
  • Editor: in-place meta arg rename
  • Editor: fix "redundant character escape" warning (#243)
  • Compatibility: IntelliJ IDEA 2020.3

2020.1

  • Generator: fix an endless cycle on cyclic inheritance (#234)
  • Generator: skip sections for string-matched tokens (#231)
  • GPUB: fix pinned upper rules error reporting
  • Compatibility: IntelliJ IDEA 2020.1

2019.3

  • Compatibility: IntelliJ IDEA 2019.3 EAP

2019.1.1

  • Generator: overridable parse_root_ and static parse_root_ methods
  • Generator: support package prefixes
  • JFlex: move generator output to Messages tool window
  • JFlex: suppress all inspections in injected fragments

2019.1

  • Generator: "extraRoot" attribute to explicitly mark a rule as such
  • Generator: method mixins with throws list
  • Generator: method mixins with generic parameters
  • RGH: cardinality calculation fix for meta rules usages
  • Plugin: switch to year-based versions from least "compatible IDE" versions

2017.1.7

  • GPUB: extract extend_marker_impl and improve error elements handling
  • Generator: fix base class calculation for merged AST and PSI
  • NPE: JFlexStateUsageSearcher.processQuery

2017.1.6

  • Generator: generate Java 8 syntax: generate=[java="8"]
  • Generator: generate TokenSets for token choices: generate=[token-sets="yes"]
  • Generator: wrap anonymous classes with functions
  • RGH: fix left rule with several usage detected as recursive

2017.1.5

  • Editor: Move Element Left/Right action in BNF
  • Editor: convert expr? to [expr] and back intention (#183)
  • Generator: FIRST check with the exact consumeTokenType (#185)
  • Generator/PSI: parameter annotations
  • GPUB: configurable token-advancer

2017.1.4

  • Editor: inject Regexp in BNF and Java in JFlex
  • Generator: less markers & less lines in generated code
  • Generator: improve target dir detection, refresh files faster
  • Generator: FIRST check external rules with non-external predicates
  • GPUB: cleanup and error reporting tweaks
  • GPUB: re-check recoverWhile condition after advance when recovering

2017.1.3

  • Generator: fix nested metas generation once again
  • Editor: fix rule attrs being shown in File Structure (improves performance too)
  • Editor: support custom folding regions (region/endregion comments)
  • Editor: tweak pairing paren insertion
  • Editor: fix incorrectly highlighted pin in expression-parsing rules
  • Refactorings: move common sub-menu, reuse common shortcuts

2017.1.2

  • Editor: fix some recoverWhile highlighting
  • Generator: drop confusing LexerAdapter generation
  • Generator: allow predicate rules be public, left and recoverable
  • Generator: make nested meta rules transparent for pinning
  • JFlex: explicitly reuse *.flex encoding on generation

2017.1.1

  • Generator: per-rule psiPackage and psiImplPackage attributes
  • Inspections: comment-based inspection suppression, e.g. //noinspection BnfUnusedRule
  • Editor: improved java references highlighting and "Create Class" quick fixes
  • JFlex: new download link and VM options to override defaults: -Dgrammar.kit.jflex.jar=..., -Dgrammar.kit.jflex.skeleton=...

2017.1

  • Plugin: switch to IntelliJ IDEA versioning scheme
  • BNF and JFlex PSI: merge AST and PSI trees (memory/performance)
  • Generator: support dash-separated and angle-quoted rules
  • Generator: "psi-factory" support for merged AST and PSI trees
  • Generator: honor explicitly set rule name
  • Generator: fix freeze on generation several grammars at once

1.5.2

  • Generator: disable first-check in presence of external predicates
  • Generator: support merged AST and PSI trees (psi.impl.source.tree.CompositePsiElement inheritors)
  • Generator: add generate=[psi-classes-map="yes"] option
  • Generator: alert of missing psi implementation methods #155
  • Generator: merge multiple list-valued attributes, e.g. "implements", "methods"

1.5.1

  • RGH: rule-graph analysis fix for trivial rules (#153)
  • Diagrams: NPE fix on app save/load
  • Generator: support rule names that happen to be java reserved words (#32)

1.5.0

  • Generator: grammar analysis and expression parsing fixes
  • Generator: include quoted tokens in token sequences

1.4.3

  • Generator: constructor and visitor fixes (issues 133, 135, 136)
  • Copyright plugin integration
  • IntelliJ compatibility: 2016.3, 2017.X

1.4.2

  • JFlex: more color options & better AST
  • Generator: meta rule parameter as 'recoverWhile' predicate
  • Generator: support 'extends' with 'upper' and 'external' modifiers
  • Generator/PSI: fix for fake rules PSI accessors calculation
  • Generator/PSi: improved methods/classes names generation logic

1.4.0

  • Generator: introduce "hooks" attribute and white-space binders #91
  • Generator: override 'gen' folder name via 'grammar.kit.gen.dir' system property
  • Generator: generate elementTypes for fake rules when needed #76
  • Generator: improved/unified identifiers generation #97
  • Generator/PSI: generate constructors from super-class #105
  • JFlex: 1.6 syntax and running
  • JFlex: file structure popup (Ctrl-F12)
  • JFlex: additional arguments via 'grammar.kit.gen.jflex.args' system property
  • JFlex: resolve returned token constants & yybegin(state) in action code
  • JFlex: unify default generation path with BNF generator #96
  • Editor: improved completion for angles-quoted rules

1.3.0

  • LivePreview: critical bugs fixed, revitalized
  • Generator: "upper" rules initial (no proper analyzer support)
  • Generator/GPUB: introduce frame.resultType for manual manipulation
  • Generator/Visitor: "visitor-value" generate option to generate Visitor<R>
  • Generator: more "generate" options: elements, element-case, token-case

1.2.1

  • Generator/PSI: fix generic and vararg types generation
  • Generator/PSI: fix private recursive rules handling
  • Generator: made a parser extend com.intellij.lang.LightPsiParser
  • Known exceptions fixed, rebuilt with IntelliJ Platform 14.1.4
  • Editor: method reference navigation revived

1.2.0

  • Generator: mixin-class methods can be used as method-mixin's to populate rule PSI interface
  • Generator: output directories detection for JFlex/BNF generators
  • Generator: "generate" attribute supersedes global "generateXXX" attributes
  • Generator: compact local variables names by default to improve code readability
  • Generator: better PSI generation in complex "extends" / "elementType" cases
  • Generator: improved rule content calculation leading to more correct PSI classes
  • Generator/Pratt: no more explicit PsiBuilder.Marker manipulations in generated code
  • LivePreview: pre-configured tokens are dropped, numbers/strings/whitespaces detected
  • BNF: allow "-" in rule names and other identifiers

1.1.10

  • GPUB: improve error reporting in some cases
  • Generator/Editor: performance fix
  • JFlex: treat "%eof{ return;" case as forced comment instead of error

1.1.8 / 1.1.9

  • Refactoring: expression chooser for introduce rule
  • JFlex: local jar/skeleton detection
  • Generator: parser-based keyword completion improvements
  • Generator: expression parsing improvements

1.1.6 / 1.1.7

  • PSI generator: Improve methods attribute semantics: rename/add new PSI tree accessors
  • PSI generator: Drop obsolete methodRenames attribute and add generateTokenAccessors
  • Live Preview: Auto-generate tokens from usage (no more BAD_TOKEN)
  • Editor: Examples added to attributes documentation (Ctrl-Q)
  • Editor: Turn grammar spell-check

1.1.5

  • Historical typo fixed: recoverUntil attribute renamed to recoverWhile (indeed it always meant while)
  • Editor: recoverable rule highlighting, help improved for pin and recoverWhile
  • GPUB: cleanup and OOM protection
  • Generator: parser size reduced, fragment parsing fixed, empty tokens support (lexer-based preprocessors)
  • Generator: simple #auto recovery predicate generation, i.e. recoverWhile = "#auto"

1.1.4

  • JFlex language support: highlighting/navigation/completion/rename
  • Generator: parser size reduced (most of PsiBuilder-specific logic moved to GPUB)

1.1.3

  • Extensibility: "extends" hooks in GPUB
  • Generator: compact token sequence parsing

1.1.2

  • Context menu: Generate JFlex *.flex file
  • Context menu: Run JFlex generator
  • Context menu: Create custom parser util class

1.1.1

  • IDEA Platform 12.1 compatibility

1.1.0

  • Live Preview mode for fast language prototyping
  • Live Preview: Highlight Grammar action helps visually debug grammars
  • stubParserClass attribute renamed to parserUtilClass for consistency
  • StubIndex support via stubClass attribute or direct implements/mixin approach

1.0.9

  • Pratt-like expression parsing stabilized, see grammar sample for more
  • No compile errors in generated code on cold start
  • Drop unneeded inheritance checks during parse-time

1.0.8

  • Experimental Pratt-like expression parsing (compact grammars and improved performance)
  • Per-rule elementTypeClass/Factory attribute & empty elementType attribute support
  • CamelCase rule names support and PSI classes calculation fixes
  • Grammar code folding for attribute groups and multiline comments

1.0.7

  • Attribute pattern navigation & inspection
  • Short error messages generation instead of long token lists
  • Token sequence completion
  • Standalone invocation (for ant integration & etc.)

1.0.6

  • Grammar diagram (UML support plugin required)
  • Dedicated "tokens" attribute
  • Minor fixes

1.0.5

  • PSI visitor generation
    • better children discovery (esp. for left rules)
    • user methods and method mixins
    • fake rules to generate better hierarchy

1.0.4

  • Bug fixes and performance

1.0.3

  • Improved PSI generation (extends and elementType attributes handling)
  • Configurable FIRST-based parser optimization

1.0.2

  • Error recovery: extended pinning
  • Pin marker annotator
  • Configurable colors (Settings/Editor/Colors and Fonts/Grammar)
  • Parser-based context-aware keyword completion (sample)
  • Language injection in string literals (sample)
  • Performance improvement & other fixes

1.0.1

  • Inspection: Left-recursion detection

1.0

  • Highlighting
  • Completion
  • Navigation
  • Refactorings: inline rule, introduce rule
  • Intentions: flip choice branches
  • Readable PsiBuilder-based recursive descent parser and PSI hierarchy generation