List TextMate engines

Author: RedCMD

documentation/README.md

@@ -7,30 +7,58 @@ Supported by [VSCode](https://code.visualstudio.com/), [Github](https://github.c
 TextMate has a lot of incomplete and fragmented [documentation](https://macromates.com/manual/en/).  
 Hopefully this can be a comprehensive guide for VSCode's JSON TextMate.  
 
-VSCode supports TextMate in [JSON](https://www.json.org/json-en.html) (`.tmLanguage.json`) and [XML](https://en.wikipedia.org/wiki/XML) (`.tmLanguage`) formats.  
-[TextMate](https://macromates.com/manual/en/appendix#property-list-format) uses the [old-style property list format](http://developer.apple.com/documentation/Cocoa/Conceptual/PropertyLists/Articles/OldStylePListsConcept.html) (Which Apple has kindly removed the link for us).  
-Sublime supports [YAML](https://yaml.org/).  
-Atom supports [CSON](https://github.com/lifthrasiir/cson).  
+Supported formats:
+* VSCode
+  * [JSON](https://www.json.org/json-en.html) `.tmLanguage.json`
+  * [XML](https://en.wikipedia.org/wiki/XML) `.tmLanguage`
+* [TextMate](https://macromates.com/manual/en/appendix#property-list-format)
+  * [Ascii Plist](https://developer.apple.com/library/archive/documentation/Cocoa/Conceptual/PropertyLists/OldStylePlists/OldStylePLists.html) `.tmLanguage` Old-style property list format [parser](https://github.com/textmate/textmate/blob/master/Frameworks/plist/src/ascii.rl)
+* Sublime
+  * [YAML](https://yaml.org/) `.yaml`
+* Atom
+  * [CSON](https://github.com/lifthrasiir/cson) `.cson`
+* [Github-Linguist](https://github.com/github-linguist/linguist)
+  * JSON `.json`
+  * XML `.plist`, `.tmlanguage`
+  * YAML `.yaml-tmlanguage`
+  * CSON `.cson`
 
 TextMate is a top down line based lexer. This was done for performance reasons.  
-Meaning you cant match new lines `\n`.  
+Meaning you can't match past/over new lines `\n`.  
 
-The rest of this file will be in the context of VSCode's JSON TextMate.  
-
-* Todo: Improve layout of this file. Split each section into its own separate file?  
 
 ## Package.json
-VSCode TextMate syntax files use the file extension `.tmLanguage.json` and are located in `./extensions/publisher.extension_name.version/syntaxes/*`.  
+VSCode's TextMate grammar files use the file extension `.tmLanguage.json` & `.tmLanguage` and are located in `./extensions/publisher.extension_name.version/syntaxes/*`.  
 Todo: Explain basics of the `Package.json` in relation to TextMate syntaxes.  
 
 ## [Rules](rules.md)
 
 ## [Injections](injections.md)
 
 ## Regex
-VSCode TextMate uses the [oniguruma](https://github.com/kkos/oniguruma) dialect.  
-It used to use Ruby.  
-Here is a list of all valid regex [expressions](https://github.com/kkos/oniguruma/blob/v6.9.8/doc/RE).  
+List of TextMate engines and their regex engines:
+* [VSCode](https://github.com/microsoft/vscode)
+  * [vscode-textmate](https://github.com/microsoft/vscode-textmate/tree/v9.2.0) v9.2.0
+    * [vscode-oniguruma](https://github.com/microsoft/vscode-oniguruma/tree/v1.7.0) v1.7.0
+      * [oniguruma](https://github.com/kkos/oniguruma/blob/v6.9.8/doc/RE) v6.9.8
+* [TextMate](https://macromates.com/) 2.0
+  * [textmate/Onigmo](https://github.com/textmate/Onigmo/blob/Onigmo-5.13.5/doc/RE) v5.13.5
+    * [k-takata/Onigmo](https://github.com/k-takata/Onigmo)
+      * [oniguruma](https://github.com/kkos/oniguruma)
+* [GitHub](https://github.com/)
+  * [Linguist](https://github.com/github-linguist)
+  * PrettyLights
+    * [PCRE](https://www.pcre.org/) v8.45
+  * Pygments
+* [NovaLightshow](https://github.com/Nixinova/NovaLightshow)
+  * [starry-night](https://github.com/wooorm/starry-night) 
+    * [vscode-textmate](https://github.com/microsoft/vscode-textmate)
+      * [vscode-oniguruma](https://github.com/microsoft/vscode-oniguruma)
+        * [oniguruma](https://github.com/kkos/oniguruma/blob/v6.9.8/doc/RE) v6.9.8
+* [ShikiJS](https://github.com/shikijs/shiki)
+  * [vscode-oniguruma](https://github.com/microsoft/vscode-oniguruma)
+    * [oniguruma](https://github.com/kkos/oniguruma/blob/v6.9.8/doc/RE) v6.9.8
+
 [regex.tmLanguage.json](https://github.com/RedCMD/TmLanguage-Syntax-Highlighter/blob/main/syntaxes/regex.tmLanguage.json).  
 `\\K` [Keep](https://github.com/kkos/oniguruma/blob/v6.9.8/doc/RE#L183) effectively moves the start position of the captured text.  
 `\\G` [MatchAnchor](https://github.com/kkos/oniguruma/blob/v6.9.8/doc/RE#L182) matches against the end of a [begin](./rules.md#begin) rule.  
@@ -54,6 +82,7 @@ Todo:
 - https://markdown-all-in-one.github.io/docs/contributing/textmate-language-grammar.html
 - https://gist.github.com/Aerijo/b8c82d647db783187804e86fa0a604a1
 - https://gist.github.com/DamnedScholar/622926bcd222eb1ddc483d12103fd315
+- https://github.com/Alhadis/language-etc/blob/master/samples/lists/scope-previews.nanorc
 - https://github.com/mjbvz/vscode-fenced-code-block-grammar-injection-example
 - https://github.com/kkos/oniguruma/blob/v6.9.8/doc/RE
 - https://github.com/chbk/flight-manual.atom.io/blob/scopes/content/hacking-atom/sections/syntax-naming-conventions.md

documentation/rules.md

@@ -18,14 +18,14 @@ Valid VSCode TextMate rules:
 * [patterns](#patterns)
 * [repository](#repository)
 
-Valid official TextMate rules: (ignored by VSCode TextMate)
+Valid TextMate 2.0 rules: (ignored by VSCode TextMate)
 * [name](#name_display)
 * [fileTypes](#filetypes)
 * [firstLineMatch](#firstlinematch)
 * [foldingStartMarker](#foldingstartmarker)
 * [foldingStopMarker](#foldingstopmarker)
 
-Other supported rules: (ignored by VSCode/official TextMate)
+Other rules: (ignored by VSCode/TextMate)
 * [information_for_contributors](#information_for_contributors)
 * [version](#version)
 * [$schema](#schema)
@@ -44,7 +44,7 @@ The [scopeName](https://github.com/microsoft/vscode-textmate/blob/main/src/rawGr
 It is the same value as `"scopeName"` under `"grammars"` in your `package.json` file.  
 It should be globally unique.  
 You should use the recommended format of `source.languageId` or `text.languageId`.  
-Or if you are extending another language via injections etc, use `source`/`text.theirLanguageId.yourScope`.  
+If you are extending another language, you should add your language on the end of their scopeName `source.theirLanguageId.yourLanguageId`.  
 For example [HTML (Derivative)](https://github.com/textmate/html.tmbundle/blob/master/Syntaxes/HTML.plist) `text.html.derivative` extending [HTML](https://github.com/textmate/html.tmbundle/blob/master/Syntaxes/HTML%20(Derivative).tmLanguage) `text.html.basic`  
 
 ## patterns