#mizchi/tmgrammar

#Installation

moon add mizchi/tmgrammar

#Module Structure

tmgrammar/
├── oniguruma/   # Oniguruma regex to JS RegExp converter
├── shiki/       # Shiki-compatible HTML highlighter
├── tui/         # Terminal ANSI highlighter
└── grammars/    # Language grammar definitions (37 languages)

#Basic Usage

#Oniguruma Module

{
  "import": [
    "mizchi/tmgrammar/oniguruma"
  ]
}

// Convert pattern with default options (ES2024 target)

///|
let result = @oniguruma.to_pattern("hello")

// Convert with flags

///|
let result = @oniguruma.to_pattern("pattern", flags="im")

// Convert with specific target

///|
let result = @oniguruma.to_pattern("pattern", target=@oniguruma.ES2018)

#Shiki Module

{
  "import": [
    "mizchi/tmgrammar/shiki"
  ]
}

// Create highlighted lines

///|
let lines = [
  @shiki.HighlightedLine::new([
    @shiki.HighlightToken::new("const", scopes=["keyword"]),
    @shiki.HighlightToken::new(" x", scopes=["variable"]),
  ]),
]

// Render to HTML with theme

///|
let html = @shiki.render_to_html(lines, @shiki.dark_plus_theme())

#TUI Module (Terminal ANSI)

{
  "import": [
    "mizchi/tmgrammar/tui"
  ]
}

// Basic colorization
///|
let colored = @tui.colorize("Hello", fg=@tui.Red, style=@tui.Bold)

// RGB TrueColor support
///|
let rgb_text = @tui.colorize("Orange", fg=@tui.Rgb(255, 165, 0))

// Render tokens with theme
///|
let lines = [
  @tui.TermLine::new([
    @tui.TermToken::new("fn ", scopes=["keyword"]),
    @tui.TermToken::new("main", scopes=["entity.name.function"]),
  ]),
]
let output = @tui.render_to_ansi(lines, @tui.dark_theme())

// With line numbers
///|
let options = @tui.TermRenderOptions::new(line_numbers=true)
let output = @tui.render_to_ansi(lines, @tui.monokai_theme(), options~)

#Grammar Plugin System

{
  "import": [
    { "path": "mizchi/tmgrammar/grammars/javascript", "alias": "js_grammar" },
    { "path": "mizchi/tmgrammar/grammars/typescript", "alias": "ts_grammar" }
  ]
}

// Get grammar definition

///|
let js = @js_grammar.grammar()

// Compile all patterns to JS RegExp

///|
let compiled = js.compile()

// Access raw patterns

///|
let patterns = @js_grammar.all_patterns()

///|
let count = @js_grammar.pattern_count()

#Available Grammar Modules (37 languages)

• grammars/c - C
• grammars/cpp - C++
• grammars/rust - Rust
• grammars/go - Go
• grammars/swift - Swift

• grammars/java - Java
• grammars/kotlin - Kotlin
• grammars/scala - Scala

• grammars/csharp - C#

• grammars/javascript - JavaScript/JSX
• grammars/typescript - TypeScript/TSX
• grammars/python - Python
• grammars/ruby - Ruby
• grammars/php - PHP
• grammars/lua - Lua
• grammars/bash - Bash/Shell

• grammars/haskell - Haskell
• grammars/elixir - Elixir

• grammars/dart - Dart/Flutter

• grammars/html - HTML
• grammars/css - CSS
• grammars/scss - SCSS
• grammars/vue - Vue
• grammars/svelte - Svelte
• grammars/astro - Astro

• grammars/json - JSON
• grammars/yaml - YAML
• grammars/toml - TOML
• grammars/xml - XML
• grammars/protobuf - Protocol Buffers
• grammars/graphql - GraphQL
• grammars/sql - SQL

• grammars/docker - Dockerfile
• grammars/make - Makefile

• grammars/markdown - Markdown
• grammars/vim - Vim script
• grammars/moonbit - MoonBit

#Supported Features

• Literals and escape sequences
• Character classes [a-z], [^0-9]
• Shorthand classes \d, \w, \s
• Quantifiers *, +, ?, {n,m}
• Lazy quantifiers *?, +?
• Groups (), (?:), (?<name>)
• Lookahead (?=), (?!)
• Lookbehind (?<=), (?<!)
• Unicode properties \p{...}, \P{...}
• Anchors ^, $, \b, \B
• Alternation |

#TextMate Grammar Support

#See Also

• Original oniguruma-to-es
• oniguruma-parser