Highlightjs not respecting parent regex of a sub mode

I need to write a lexer which highlights my command-line tool commands properly.

$ dvc add file.csv
$ dvc pipeline list

So the command starts with dvc and it may have one or two subcommands - add or pipeline list respectively.

Therefore, it should highlight dvc add and dvc pipeline list in first and second case respectively.

contains: [
  {
    begin: /^\s*\$\s(dvc|git) [a-z-]+/,
    returnBegin: true,
    contains: [
      {
        begin: /dvc [a-z-]+ ?/,
        lexemes: '[a-z-]+',
        keywords: {
          built_in:
             'dvc'
          },
          contains: [
            {
              begin: /\w+(?![\S])/,
              keywords: {
                built_in: 'list'
              }
            }
          ],
          className: 'strong'
        }
      ]
    }
 ]

It matches $ dvc pipeline list even though the parent regex i.e. /^\s*\$\s(dvc|git) [a-z-]+/ and should only match till $ dvc pipeline. How is it exactly functioning?

How does /dvc [a-z-]+ ?/ override it and continues matching the expression?

[joshgoebel]

Added: https://github.com/highlightjs/highlight.js/pull/2242

Closing this as asked and answered, though conversation can continue if you have any other questions.

[joshgoebel]

Or a different sub-mode for EVERY command… really at this point you’d probably want to write code to build your syntax, not write it by hand…

language_rules = []
language_rules.push(add_command("dvc add"))
language_rules.push(add_command("dvc pipeline", keywords: {...}))

return {
 contains: language_rules
}