@nuraly/runtime 0.1.6 → 0.1.8

package/dist/{razor-BFH0wq9s.js → razor-D5ep1Doy.js}

@@ -1,7 +1,7 @@
-import { m } from "./CodeEditor-0GwD2UDB.js";
+import { m } from "./CodeEditor-Bf4L2rO_.js";
 /*!-----------------------------------------------------------------------------
  * Copyright (c) Microsoft Corporation. All rights reserved.
- * Version: 0.45.0(5e5af013f8d295555a7210df0d5f2cea0bf5dd56)
+ * Version: 0.52.2(404545bded1df6ffa41ea0af4e8ddb219018c6c1)
  * Released under the MIT license
  * https://github.com/microsoft/monaco-editor/blob/main/LICENSE.txt
  *-----------------------------------------------------------------------------*/
@@ -54,23 +54,32 @@ var i = [
   ],
   onEnterRules: [
     {
-      beforeText: new RegExp(`<(?!(?:${i.join("|")}))(\\w[\\w\\d]*)([^/>]*(?!/)>)[^<]*$`, "i"),
+      beforeText: new RegExp(
+        `<(?!(?:${i.join("|")}))(\\w[\\w\\d]*)([^/>]*(?!/)>)[^<]*$`,
+        "i"
+      ),
       afterText: /^<\/(\w[\w\d]*)\s*>$/i,
       action: {
         indentAction: a.languages.IndentAction.IndentOutdent
       }
     },
     {
-      beforeText: new RegExp(`<(?!(?:${i.join("|")}))(\\w[\\w\\d]*)([^/>]*(?!/)>)[^<]*$`, "i"),
+      beforeText: new RegExp(
+        `<(?!(?:${i.join("|")}))(\\w[\\w\\d]*)([^/>]*(?!/)>)[^<]*$`,
+        "i"
+      ),
       action: { indentAction: a.languages.IndentAction.Indent }
     }
   ]
 }, y = {
   defaultToken: "",
   tokenPostfix: "",
+  // ignoreCase: true,
+  // The main tokenizer for our languages
   tokenizer: {
     root: [
       [/@@@@/],
+      // text
       [/@[^@]/, { token: "@rematch", switchTo: "@razorInSimpleState.root" }],
       [/<!DOCTYPE/, "metatag.html", "@doctype"],
       [/<!--/, "comment.html", "@comment"],
@@ -81,7 +90,9 @@ var i = [
       [/(<\/)([\w\-]+)/, ["delimiter.html", { token: "tag.html", next: "@otherTag" }]],
       [/</, "delimiter.html"],
       [/[ \t\r\n]+/],
+      // whitespace
       [/[^<@]+/]
+      // text
     ],
     doctype: [
       [/@[^@]/, { token: "@rematch", switchTo: "@razorInSimpleState.comment" }],
@@ -102,7 +113,10 @@ var i = [
       [/[\w\-]+/, "attribute.name"],
       [/=/, "delimiter"],
       [/[ \t\r\n]+/]
+      // whitespace
     ],
+    // -- BEGIN <script> tags handling
+    // After <script
     script: [
       [/@[^@]/, { token: "@rematch", switchTo: "@razorInSimpleState.script" }],
       [/type/, "attribute.name", "@scriptAfterType"],
@@ -119,11 +133,13 @@ var i = [
         }
       ],
       [/[ \t\r\n]+/],
+      // whitespace
       [
         /(<\/)(script\s*)(>)/,
         ["delimiter.html", "tag.html", { token: "delimiter.html", next: "@pop" }]
       ]
     ],
+    // After <script ... type
     scriptAfterType: [
       [
         /@[^@]/,
@@ -141,9 +157,12 @@ var i = [
           nextEmbedded: "text/javascript"
         }
       ],
+      // cover invalid e.g. <script type>
       [/[ \t\r\n]+/],
+      // whitespace
       [/<\/script\s*>/, { token: "@rematch", next: "@pop" }]
     ],
+    // After <script ... type =
     scriptAfterTypeEquals: [
       [
         /@[^@]/,
@@ -174,9 +193,12 @@ var i = [
           nextEmbedded: "text/javascript"
         }
       ],
+      // cover invalid e.g. <script type=>
       [/[ \t\r\n]+/],
+      // whitespace
       [/<\/script\s*>/, { token: "@rematch", next: "@pop" }]
     ],
+    // After <script ... type = $S2
     scriptWithCustomType: [
       [
         /@[^@]/,
@@ -198,6 +220,7 @@ var i = [
       [/[\w\-]+/, "attribute.name"],
       [/=/, "delimiter"],
       [/[ \t\r\n]+/],
+      // whitespace
       [/<\/script\s*>/, { token: "@rematch", next: "@pop" }]
     ],
     scriptEmbedded: [
@@ -211,6 +234,9 @@ var i = [
       ],
       [/<\/script/, { token: "@rematch", next: "@pop", nextEmbedded: "@pop" }]
     ],
+    // -- END <script> tags handling
+    // -- BEGIN <style> tags handling
+    // After <style
     style: [
       [/@[^@]/, { token: "@rematch", switchTo: "@razorInSimpleState.style" }],
       [/type/, "attribute.name", "@styleAfterType"],
@@ -227,11 +253,13 @@ var i = [
         }
       ],
       [/[ \t\r\n]+/],
+      // whitespace
       [
         /(<\/)(style\s*)(>)/,
         ["delimiter.html", "tag.html", { token: "delimiter.html", next: "@pop" }]
       ]
     ],
+    // After <style ... type
     styleAfterType: [
       [
         /@[^@]/,
@@ -249,9 +277,12 @@ var i = [
           nextEmbedded: "text/css"
         }
       ],
+      // cover invalid e.g. <style type>
       [/[ \t\r\n]+/],
+      // whitespace
       [/<\/style\s*>/, { token: "@rematch", next: "@pop" }]
     ],
+    // After <style ... type =
     styleAfterTypeEquals: [
       [
         /@[^@]/,
@@ -282,9 +313,12 @@ var i = [
           nextEmbedded: "text/css"
         }
       ],
+      // cover invalid e.g. <style type=>
       [/[ \t\r\n]+/],
+      // whitespace
       [/<\/style\s*>/, { token: "@rematch", next: "@pop" }]
     ],
+    // After <style ... type = $S2
     styleWithCustomType: [
       [
         /@[^@]/,
@@ -306,6 +340,7 @@ var i = [
       [/[\w\-]+/, "attribute.name"],
       [/=/, "delimiter"],
       [/[ \t\r\n]+/],
+      // whitespace
       [/<\/style\s*>/, { token: "@rematch", next: "@pop" }]
     ],
     styleEmbedded: [
@@ -319,6 +354,7 @@ var i = [
       ],
       [/<\/style/, { token: "@rematch", next: "@pop", nextEmbedded: "@pop" }]
     ],
+    // -- END <style> tags handling
     razorInSimpleState: [
       [/@\*/, "comment.cs", "@razorBlockCommentTopLevel"],
       [/@[{(]/, "metatag.cs", "@razorRootTopLevel"],
@@ -390,16 +426,23 @@ var i = [
           }
         }
       ],
+      // brackets
       [/[\[\]]/, "delimiter.array.cs"],
+      // whitespace
       [/[ \t\r\n]+/],
+      // comments
       [/\/\/.*$/, "comment.cs"],
       [/@\*/, "comment.cs", "@razorBlockComment"],
+      // strings
       [/"([^"]*)"/, "string.cs"],
       [/'([^']*)'/, "string.cs"],
+      // simple html
       [/(<)([\w\-]+)(\/>)/, ["delimiter.html", "tag.html", "delimiter.html"]],
       [/(<)([\w\-]+)(>)/, ["delimiter.html", "tag.html", "delimiter.html"]],
       [/(<\/)([\w\-]+)(>)/, ["delimiter.html", "tag.html", "delimiter.html"]],
+      // delimiters
       [/[\+\-\*\%\&\|\^\~\!\=\<\>\/\?\;\:\.\,]/, "delimiter.cs"],
+      // numbers
       [/\d*\d+[eE]([\-+]?\d+)?/, "number.float.cs"],
       [/\d*\.\d+([eE][\-+]?\d+)?/, "number.float.cs"],
       [/0[xX][0-9a-fA-F']*[0-9a-fA-F]/, "number.hex.cs"],
@@ -503,6 +546,7 @@ var i = [
     "yield",
     "model",
     "inject"
+    // Razor specific
   ],
   escapes: /\\(?:[abfnrtv\\"']|x[0-9A-Fa-f]{1,4}|u[0-9A-Fa-f]{4}|U[0-9A-Fa-f]{8})/
 };

package/dist/{redis-B2fdL4Bg.js → redis-D9MFxvE8.js}

@@ -1,6 +1,6 @@
 /*!-----------------------------------------------------------------------------
  * Copyright (c) Microsoft Corporation. All rights reserved.
- * Version: 0.45.0(5e5af013f8d295555a7210df0d5f2cea0bf5dd56)
+ * Version: 0.52.2(404545bded1df6ffa41ea0af4e8ddb219018c6c1)
  * Released under the MIT license
  * https://github.com/microsoft/monaco-editor/blob/main/LICENSE.txt
  *-----------------------------------------------------------------------------*/
@@ -231,10 +231,18 @@ var E = {
     "HSCAN",
     "ZSCAN"
   ],
-  operators: [],
-  builtinFunctions: [],
-  builtinVariables: [],
-  pseudoColumns: [],
+  operators: [
+    // NOT SUPPORTED
+  ],
+  builtinFunctions: [
+    // NOT SUPPORTED
+  ],
+  builtinVariables: [
+    // NOT SUPPORTED
+  ],
+  pseudoColumns: [
+    // NOT SUPPORTED
+  ],
   tokenizer: {
     root: [
       { include: "@whitespace" },
@@ -289,7 +297,9 @@ var E = {
       [/""/, "string.double"],
       [/"/, { token: "string.double", next: "@pop" }]
     ],
-    scopes: []
+    scopes: [
+      // NOT SUPPORTED
+    ]
   }
 };
 export {

package/dist/{redshift-DoaeyCkH.js → redshift-CmCnsvL-.js}

@@ -1,6 +1,6 @@
 /*!-----------------------------------------------------------------------------
  * Copyright (c) Microsoft Corporation. All rights reserved.
- * Version: 0.45.0(5e5af013f8d295555a7210df0d5f2cea0bf5dd56)
+ * Version: 0.52.2(404545bded1df6ffa41ea0af4e8ddb219018c6c1)
  * Released under the MIT license
  * https://github.com/microsoft/monaco-editor/blob/main/LICENSE.txt
  *-----------------------------------------------------------------------------*/
@@ -732,8 +732,12 @@ var e = {
     "xpath",
     "xpath_exists"
   ],
-  builtinVariables: [],
-  pseudoColumns: [],
+  builtinVariables: [
+    // NOT SUPPORTED
+  ],
+  pseudoColumns: [
+    // NOT SUPPORTED
+  ],
   tokenizer: {
     root: [
       { include: "@comments" },
@@ -766,6 +770,9 @@ var e = {
     ],
     comment: [
       [/[^*/]+/, "comment"],
+      // Not supporting nested comments, as nested comments seem to not be standard?
+      // i.e. http://stackoverflow.com/questions/728172/are-there-multiline-comment-delimiters-in-sql-that-are-vendor-agnostic
+      // [/\/\*/, { token: 'comment.quote', next: '@push' }],    // nested comment not allowed :-(
       [/\*\//, { token: "comment.quote", next: "@pop" }],
       [/./, "comment"]
     ],
@@ -797,7 +804,9 @@ var e = {
       [/""/, "identifier"],
       [/"/, { token: "identifier.quote", next: "@pop" }]
     ],
-    scopes: []
+    scopes: [
+      // NOT SUPPORTED
+    ]
   }
 };
 export {

package/dist/{restructuredtext-D-6OFBY9.js → restructuredtext-CWy8J51t.js}

@@ -1,6 +1,6 @@
 /*!-----------------------------------------------------------------------------
  * Copyright (c) Microsoft Corporation. All rights reserved.
- * Version: 0.45.0(5e5af013f8d295555a7210df0d5f2cea0bf5dd56)
+ * Version: 0.52.2(404545bded1df6ffa41ea0af4e8ddb219018c6c1)
  * Released under the MIT license
  * https://github.com/microsoft/monaco-editor/blob/main/LICENSE.txt
  *-----------------------------------------------------------------------------*/
@@ -58,8 +58,13 @@ var e = {
   punctuation: /(=|-|~|`|#|"|\^|\+|\*|:|\.|'|_|\+)/,
   tokenizer: {
     root: [
+      //sections
       [/^(@punctuation{3,}$){1,1}?/, "keyword"],
+      //line-blocks
+      //No rules on it
+      //bullet-lists
       [/^\s*([\*\-+‣•]|[a-zA-Z0-9]+\.|\([a-zA-Z0-9]+\)|[a-zA-Z0-9]+\))\s/, "keyword"],
+      //literal-blocks
       [/([ ]::)\s*$/, "keyword", "@blankLineOfLiteralBlocks"],
       [/(::)\s*$/, "keyword", "@blankLineOfLiteralBlocks"],
       { include: "@tables" },
@@ -67,41 +72,54 @@ var e = {
       { include: "@inlineMarkup" }
     ],
     explicitMarkupBlocks: [
+      //citations
       { include: "@citations" },
+      //footnotes
       { include: "@footnotes" },
+      //directives
       [
         /^(\.\.\s)(@simpleRefName)(::\s)(.*)$/,
         [{ token: "", next: "subsequentLines" }, "keyword", "", ""]
       ],
+      //hyperlink-targets
       [
         /^(\.\.)(\s+)(_)(@simpleRefName)(:)(\s+)(.*)/,
         [{ token: "", next: "hyperlinks" }, "", "", "string.link", "", "", "string.link"]
       ],
+      //anonymous-hyperlinks
       [
         /^((?:(?:\.\.)(?:\s+))?)(__)(:)(\s+)(.*)/,
         [{ token: "", next: "subsequentLines" }, "", "", "", "string.link"]
       ],
       [/^(__\s+)(.+)/, ["", "string.link"]],
+      //substitution-definitions
       [
         /^(\.\.)( \|)([^| ]+[^|]*[^| ]*)(\| )(@simpleRefName)(:: .*)/,
         [{ token: "", next: "subsequentLines" }, "", "string.link", "", "keyword", ""],
         "@rawBlocks"
       ],
       [/(\|)([^| ]+[^|]*[^| ]*)(\|_{0,2})/, ["", "string.link", ""]],
+      //comments
       [/^(\.\.)([ ].*)$/, [{ token: "", next: "@comments" }, "comment"]]
     ],
     inlineMarkup: [
       { include: "@citationsReference" },
       { include: "@footnotesReference" },
+      //hyperlink-references
       [/(@simpleRefName)(_{1,2})/, ["string.link", ""]],
+      //embedded-uris-and-aliases
       [/(`)([^<`]+\s+)(<)(.*)(>)(`)(_)/, ["", "string.link", "", "string.link", "", "", ""]],
+      //emphasis
       [/\*\*([^\\*]|\*(?!\*))+\*\*/, "strong"],
       [/\*[^*]+\*/, "emphasis"],
+      //inline-literals
       [/(``)((?:[^`]|\`(?!`))+)(``)/, ["", "keyword", ""]],
       [/(__\s+)(.+)/, ["", "keyword"]],
+      //interpreted-text
       [/(:)((?:@simpleRefNameWithoutBq)?)(:`)([^`]+)(`)/, ["", "keyword", "", "", ""]],
       [/(`)([^`]+)(`:)((?:@simpleRefNameWithoutBq)?)(:)/, ["", "", "", "keyword", ""]],
       [/(`)([^`]+)(`)/, ""],
+      //inline-internal-targets
       [/(_`)(@phrase)(`)/, ["", "string.link", ""]]
     ],
     citations: [

package/dist/{ruby-D1DD6baV.js → ruby-WP-c36m5.js}

@@ -1,6 +1,6 @@
 /*!-----------------------------------------------------------------------------
  * Copyright (c) Microsoft Corporation. All rights reserved.
- * Version: 0.45.0(5e5af013f8d295555a7210df0d5f2cea0bf5dd56)
+ * Version: 0.52.2(404545bded1df6ffa41ea0af4e8ddb219018c6c1)
  * Released under the MIT license
  * https://github.com/microsoft/monaco-editor/blob/main/LICENSE.txt
  *-----------------------------------------------------------------------------*/
@@ -29,8 +29,12 @@ var e = {
     { open: "'", close: "'" }
   ],
   indentationRules: {
-    increaseIndentPattern: new RegExp(`^\\s*((begin|class|(private|protected)\\s+def|def|else|elsif|ensure|for|if|module|rescue|unless|until|when|while|case)|([^#]*\\sdo\\b)|([^#]*=\\s*(case|if|unless)))\\b([^#\\{;]|("|'|/).*\\4)*(#.*)?$`),
-    decreaseIndentPattern: new RegExp("^\\s*([}\\]]([,)]?\\s*(#|$)|\\.[a-zA-Z_]\\w*\\b)|(end|rescue|ensure|else|elsif|when)\\b)")
+    increaseIndentPattern: new RegExp(
+      `^\\s*((begin|class|(private|protected)\\s+def|def|else|elsif|ensure|for|if|module|rescue|unless|until|when|while|case)|([^#]*\\sdo\\b)|([^#]*=\\s*(case|if|unless)))\\b([^#\\{;]|("|'|/).*\\4)*(#.*)?$`
+    ),
+    decreaseIndentPattern: new RegExp(
+      "^\\s*([}\\]]([,)]?\\s*(#|$)|\\.[a-zA-Z_]\\w*\\b)|(end|rescue|ensure|else|elsif|when)\\b)"
+    )
   }
 }, t = {
   tokenPostfix: ".ruby",
@@ -90,6 +94,7 @@ var e = {
     "protected_class_method",
     "new"
   ],
+  // these are closed by 'end' (if, while and until are handled separately)
   declarations: [
     "module",
     "class",
@@ -150,7 +155,9 @@ var e = {
     { open: "{", close: "}", token: "delimiter.curly" },
     { open: "[", close: "]", token: "delimiter.square" }
   ],
+  // we include these common regular expressions
   symbols: /[=><!~?:&|+\-*\/\^%\.]+/,
+  // escape sequences
   escape: /(?:[abefnrstv\\"'\n\r]|[0-7]{1,3}|x[0-9A-Fa-f]{1,2}|u[0-9A-Fa-f]{4})/,
   escapes: /\\(?:C\-(@escape|.)|c(@escape|.)|@escape)/,
   decpart: /\d(_?\d)*/,
@@ -159,8 +166,14 @@ var e = {
   heredelim: /(?:\w+|'[^']*'|"[^"]*"|`[^`]*`)/,
   regexpctl: /[(){}\[\]\$\^|\-*+?\.]/,
   regexpesc: /\\(?:[AzZbBdDfnrstvwWn0\\\/]|@regexpctl|c[A-Z]|x[0-9a-fA-F]{2}|u[0-9a-fA-F]{4})?/,
+  // The main tokenizer for our languages
   tokenizer: {
+    // Main entry.
+    // root.<decl> where decl is the current opening declaration (like 'class')
     root: [
+      // identifiers and keywords
+      // most complexity here is due to matching 'end' correctly with declarations.
+      // We distinguish a declaration that comes first on a line, versus declarations further on a line (which are most likey modifiers)
       [
         /^(\s*)([a-z_]\w*[!?=]?)/,
         [
@@ -201,21 +214,32 @@ var e = {
         }
       ],
       [/[A-Z][\w]*[!?=]?/, "constructor.identifier"],
+      // constant
       [/\$[\w]*/, "global.constant"],
+      // global
       [/@[\w]*/, "namespace.instance.identifier"],
+      // instance
       [/@@@[\w]*/, "namespace.class.identifier"],
+      // class
+      // here document
       [/<<[-~](@heredelim).*/, { token: "string.heredoc.delimiter", next: "@heredoc.$1" }],
       [/[ \t\r\n]+<<(@heredelim).*/, { token: "string.heredoc.delimiter", next: "@heredoc.$1" }],
       [/^<<(@heredelim).*/, { token: "string.heredoc.delimiter", next: "@heredoc.$1" }],
+      // whitespace
       { include: "@whitespace" },
+      // strings
       [/"/, { token: "string.d.delim", next: '@dstring.d."' }],
       [/'/, { token: "string.sq.delim", next: "@sstring.sq" }],
+      // % literals. For efficiency, rematch in the 'pstring' state
       [/%([rsqxwW]|Q?)/, { token: "@rematch", next: "pstring" }],
+      // commands and symbols
       [/`/, { token: "string.x.delim", next: "@dstring.x.`" }],
       [/:(\w|[$@])\w*[!?=]?/, "string.s"],
       [/:"/, { token: "string.s.delim", next: '@dstring.s."' }],
       [/:'/, { token: "string.s.delim", next: "@sstring.s" }],
+      // regular expressions. Lookahead for a (not escaped) closing forwardslash on the same line
       [/\/(?=(\\\/|[^\/\n])+\/)/, { token: "regexp.delim", next: "@regexp" }],
+      // delimiters and operators
       [/[{}()\[\]]/, "@brackets"],
       [
         /@symbols/,
@@ -228,6 +252,7 @@ var e = {
         }
       ],
       [/[;,]/, "delimiter"],
+      // numbers
       [/0[xX][0-9a-fA-F](_?[0-9a-fA-F])*/, "number.hex"],
       [/0[_oO][0-7](_?[0-7])*/, "number.octal"],
       [/0[bB][01](_?[01])*/, "number.binary"],
@@ -242,18 +267,25 @@ var e = {
         }
       ]
     ],
+    // used to not treat a 'do' as a block opener if it occurs on the same
+    // line as a 'do' statement: 'while|until|for'
+    // dodecl.<decl> where decl is the declarations started, like 'while'
     dodecl: [
       [/^/, { token: "", switchTo: "@root.$S2" }],
+      // get out of do-skipping mode on a new line
       [
         /[a-z_]\w*[!?=]?/,
         {
           cases: {
             end: { token: "keyword.$S2", next: "@pop" },
+            // end on same line
             do: { token: "keyword", switchTo: "@root.$S2" },
+            // do on same line: not an open bracket here
             "@linedecls": {
               token: "@rematch",
               switchTo: "@root.$S2"
             },
+            // other declaration on same line: rematch
             "@keywords": "keyword",
             "@builtins": "predefined",
             "@default": "identifier"
@@ -262,21 +294,28 @@ var e = {
       ],
       { include: "@root" }
     ],
+    // used to prevent potential modifiers ('if|until|while|unless') to match
+    // with 'end' keywords.
+    // modifier.<decl>x where decl is the declaration starter, like 'if'
     modifier: [
       [/^/, "", "@pop"],
+      // it was a modifier: get out of modifier mode on a new line
       [
         /[a-z_]\w*[!?=]?/,
         {
           cases: {
             end: { token: "keyword.$S2", next: "@pop" },
+            // end on same line
             "then|else|elsif|do": {
               token: "keyword",
               switchTo: "@root.$S2"
             },
+            // real declaration and not a modifier
             "@linedecls": {
               token: "@rematch",
               switchTo: "@root.$S2"
             },
+            // other declaration => not a modifier
             "@keywords": "keyword",
             "@builtins": "predefined",
             "@default": "identifier"
@@ -285,12 +324,17 @@ var e = {
       ],
       { include: "@root" }
     ],
+    // single quote strings (also used for symbols)
+    // sstring.<kind>  where kind is 'sq' (single quote) or 's' (symbol)
     sstring: [
       [/[^\\']+/, "string.$S2"],
       [/\\\\|\\'|\\$/, "string.$S2.escape"],
       [/\\./, "string.$S2.invalid"],
       [/'/, { token: "string.$S2.delim", next: "@pop" }]
     ],
+    // double quoted "string".
+    // dstring.<kind>.<delim> where kind is 'd' (double quoted), 'x' (command), or 's' (symbol)
+    // and delim is the ending delimiter (" or `)
     dstring: [
       [/[^\\`"#]+/, "string.$S2"],
       [/#/, "string.$S2.escape", "@interpolated"],
@@ -307,6 +351,8 @@ var e = {
         }
       ]
     ],
+    // literal documents
+    // heredoc.<close> where close is the closing delimiter
     heredoc: [
       [
         /^(\s*)(@heredelim)$/,
@@ -319,6 +365,7 @@ var e = {
       ],
       [/.*/, "string.heredoc"]
     ],
+    // interpolated sequence
     interpolated: [
       [/\$\w*/, "global.constant", "@pop"],
       [/@\w*/, "namespace.class.identifier", "@pop"],
@@ -331,19 +378,27 @@ var e = {
         }
       ],
       ["", "", "@pop"]
+      // just a # is interpreted as a #
     ],
+    // any code
     interpolated_compound: [
       [/[}]/, { token: "string.escape.curly", next: "@pop" }],
       { include: "@root" }
     ],
+    // %r quoted regexp
+    // pregexp.<open>.<close> where open/close are the open/close delimiter
     pregexp: [
       { include: "@whitespace" },
+      // turns out that you can quote using regex control characters, aargh!
+      // for example; %r|kgjgaj| is ok (even though | is used for alternation)
+      // so, we need to match those first
       [
         /[^\(\{\[\\]/,
         {
           cases: {
             "$#==$S3": { token: "regexp.delim", next: "@pop" },
             "$#==$S2": { token: "regexp.delim", next: "@push" },
+            // nested delimiters are allowed..
             "~[)}\\]]": "@brackets.regexp.escape.control",
             "~@regexpctl": "regexp.escape.control",
             "@default": "regexp"
@@ -352,6 +407,7 @@ var e = {
       ],
       { include: "@regexcontrol" }
     ],
+    // We match regular expression quite precisely
     regexp: [
       { include: "@regexcontrol" },
       [/[^\\\/]/, "regexp"],
@@ -391,6 +447,8 @@ var e = {
       [/[^)]+/, "comment"],
       [/\)/, { token: "regexp.escape.control", next: "@pop" }]
     ],
+    // % quoted strings
+    // A bit repetitive since we need to often special case the kind of ending delimiter
     pstring: [
       [/%([qws])\(/, { token: "string.$1.delim", switchTo: "@qstring.$1.(.)" }],
       [/%([qws])\[/, { token: "string.$1.delim", switchTo: "@qstring.$1.[.]" }],
@@ -408,8 +466,15 @@ var e = {
       [/%(x|W|Q?)</, { token: "string.$1.delim", switchTo: "@qqstring.$1.<.>" }],
       [/%(x|W|Q?)(@delim)/, { token: "string.$1.delim", switchTo: "@qqstring.$1.$2.$2" }],
       [/%([rqwsxW]|Q?)./, { token: "invalid", next: "@pop" }],
+      // recover
       [/./, { token: "invalid", next: "@pop" }]
+      // recover
     ],
+    // non-expanded quoted string.
+    // qstring.<kind>.<open>.<close>
+    //  kind = q|w|s  (single quote, array, symbol)
+    //  open = open delimiter
+    //  close = close delimiter
     qstring: [
       [/\\$/, "string.$S2.escape"],
       [/\\./, "string.$S2.escape"],
@@ -419,12 +484,19 @@ var e = {
           cases: {
             "$#==$S4": { token: "string.$S2.delim", next: "@pop" },
             "$#==$S3": { token: "string.$S2.delim", next: "@push" },
+            // nested delimiters are allowed..
             "@default": "string.$S2"
           }
         }
       ]
     ],
+    // expanded quoted string.
+    // qqstring.<kind>.<open>.<close>
+    //  kind = Q|W|x  (double quote, array, command)
+    //  open = open delimiter
+    //  close = close delimiter
     qqstring: [[/#/, "string.$S2.escape", "@interpolated"], { include: "@qstring" }],
+    // whitespace & comments
     whitespace: [
       [/[ \t\r\n]+/, ""],
       [/^\s*=begin\b/, "comment", "@comment"],
@@ -433,6 +505,7 @@ var e = {
     comment: [
       [/[^=]+/, "comment"],
       [/^\s*=begin\b/, "comment.invalid"],
+      // nested comment
       [/^\s*=end\b.*/, "comment", "@pop"],
       [/[=]/, "comment"]
     ]