pair-mode 0.3.0 → 0.3.3

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "pair-mode",
-  "version": "0.3.0",
+  "version": "0.3.3",
   "description": "Hold every proposed edit, annotate the diff line by line, and hand the notes back to the agent.",
   "author": {
     "name": "ofrusch",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "pair-mode",
-  "version": "0.3.0",
+  "version": "0.3.3",
   "description": "Hold every proposed edit, annotate the diff line by line, and hand the notes back to the agent.",
   "author": {
     "name": "ofrusch",

package/README.md

@@ -16,12 +16,10 @@ When enabled, your agent will push diffs to your editing interface of choice (yo
 
 ## Install
 
-```
-npm install -g pair-mode
-pair-mode setup
-```
+Pick one of two paths. A plugin covers one CLI and needs no setup step. The npm install
+covers every CLI on your machine and gives you the `pair-mode` command.
 
-### Or install it as a plugin
+### As a plugin
 
 A plugin resolves its own path at runtime, so it needs no global install and no setup step.
 
@@ -29,7 +27,7 @@ Claude Code:
 
 ```
 /plugin marketplace add oFrusch/pair-mode
-/plugin install pair-mode
+/plugin install pair-mode@pair-mode
 ```
 
 Codex:
@@ -39,9 +37,16 @@ codex plugin marketplace add oFrusch/pair-mode
 codex plugin add pair-mode@pair-mode
 ```
 
-The plugin registers the hook and the `/pair` command for that one CLI. Run
-`npm install -g pair-mode` as well if you want the `pair-mode` command on your PATH, which
-`pair-mode watch` and `pair-mode config` need.
+The plugin registers the hook and the `pair` command for that one CLI. Add the npm install
+below if you also want `pair-mode watch` or `pair-mode config`, because both need the
+`pair-mode` command on your PATH.
+
+### From npm
+
+```
+npm install -g pair-mode
+pair-mode setup
+```
 
 Install pair-mode globally before you run setup. Setup writes the install path into each CLI's config as an absolute path. `npx pair-mode setup` runs from a package cache that npm later prunes, which would leave every hook pointing at a deleted file. Setup detects that case and stops.
 
@@ -81,6 +86,14 @@ This is what will render your diff if you choose to use one of the CLI-based app
 | nvim           | Yes         | Yes. Same `matchadd()` overlay as vim.                                                                                                                                                                                           |
 | nano           | Yes         | No. nano has no syntax engine here, so a changed row gets the diff band only.                                                                                                                                                    |
 
+Pair mode names the language from the extension first, then the exact filename, then the
+shebang on the first line. So `Gemfile`, `Dockerfile`, `Makefile`, and an extensionless
+script all get colour. A brand new file has nothing on disk yet, so its first review reads
+no shebang.
+
+The pair pane and the web view colour every language Shiki bundles. micro colours the 54
+languages that ship a syntax asset.
+
 Keys:
 
 - pair: see [Keymap](#keymap) below.
@@ -119,6 +132,50 @@ If you want to do all your development in one terminal pane while using either C
 Session mode moves the review out of the agent's process. The hook posts to a Unix
 socket and waits. A client you start (another terminal tab or the web view) renders the review and allows you to provide your annotations.
 
+### One socket per agent session
+
+`pair-mode on` inside an agent session reads that session's id, turns pair mode on for that
+session alone, and prints the session id. It mints no socket. Run `pair-mode watch <id>`
+with the id it printed, and that watcher mints the socket. Another session in the same
+checkout gets its own socket and never sees the first session's diffs.
+
+`pair-mode on <dir>` from a plain terminal keeps the old behaviour. It writes a directory
+flag, and its socket catches every session that has no socket of its own.
+
+A bare `pair-mode off` inside a session turns pair mode off for that session only. It never
+clears a directory flag, so it never silences another session. `pair-mode off <dir>` names
+its target and clears the directory flag.
+
+### Finding a session
+
+```
+pair-mode sessions
+```
+
+That prints every live session with its id, its label, how many watchers are attached, and
+how many reviews are queued. It also removes any socket whose watcher has died.
+
+```
+pair-mode connect
+```
+
+That opens the same list, interactive. `j`, `k`, and the arrow keys move the cursor. `Enter`
+watches the session under the cursor. `q` quits.
+
+`pair-mode watch <id>` attaches directly when you already know the id. It mints the socket
+when nothing owns it yet, which is how a session first gets a watcher. An id that is not
+`s-` followed by eight hex characters is rejected as a typo.
+
+A session flag outlives the agent that wrote it. `pair-mode sessions` removes a session flag
+and a session opt-out once the session has had no socket for fourteen days, and it says how
+many it removed.
+
+Several watchers can watch one session at once, in a terminal or in a browser. The first one
+to watch a session owns its socket. Every later one attaches to that socket as a viewer. Each
+attached client receives every diff, and the first answer wins. The others see the review
+withdraw. A browser tab therefore joins a session a terminal pane already owns, and closing
+the tab leaves that pane serving.
+
 ### Session mode config
 
 Set `transport` to `"session"`, then pick a client.

package/assets/syntax/clojure.yaml

@@ -0,0 +1,36 @@
+filetype: clojure
+
+detect:
+  filename: "\\.(clj[sc]?|edn)$"
+
+rules:
+  # Constants
+  - constant.bool: "\\b(true|false)\\b"
+  - constant.macro: "\\b(nil)\\b"
+    # Valid numbers
+  - constant.number: "[\\-]?[0-9]+?\\b"
+  - constant.number: "0x[0-9][A-Fa-f]+?\\b"
+  - constant.number: "[\\-]?(3[0-6]|2[0-9]|1[0-9]|[2-9])r[0-9A-Z]+?\\b"
+    # Invalid numbers
+  - error: "[\\-]?([4-9][0-9]|3[7-9]|1|0)r[0-9A-Z]+?\\b"
+
+    # Symbols
+  - symbol.operator: "[=>+\\-*/'?]"
+
+    # Types/casting
+  - type: "\\b(byte|short|(big)?int(eger)?|long|float|num|bigdec|rationalize)\\b"
+
+    # String highlighting
+  - constant.string:
+      start: '"'
+      end: '"'
+      skip: "\\\\."
+      rules:
+        - constant.specialChar: "(\\\\u[0-9A-fa-f]{4,4}|\\\\newline|\\\\space|\\\\tab|\\\\formfeed|\\\\backspace|\\\\return|\\\\.)"
+
+    # Comments
+  - comment:
+      start: ";"
+      end: "$"
+      rules:
+        - todo: "(TODO|XXX|FIXME):?"

package/assets/syntax/cmake.yaml

@@ -0,0 +1,41 @@
+filetype: cmake
+
+detect:
+  filename: "(CMakeLists\\.txt|\\.cmake)$"
+
+rules:
+  - identifier.var: "^[[:space:]]*[A-Z0-9_]+"
+  - preproc: "^[[:space:]]*(include|include_directories|include_external_msproject)\\b"
+
+  - statement: "^[[:space:]]*\\b((else|end)?if|else|(end)?while|(end)?foreach|break)\\b"
+  - statement: "\\b(COPY|NOT|COMMAND|PROPERTY|POLICY|TARGET|EXISTS|IS_(DIRECTORY|ABSOLUTE)|DEFINED)\\b[[:space:]]"
+  - statement: "[[:space:]]\\b(OR|AND|IS_NEWER_THAN|MATCHES|(STR|VERSION_)?(LESS|GREATER|EQUAL))\\b[[:space:]]"
+
+  - special: "^[[:space:]]*\\b((end)?(function|macro)|return)"
+
+  - constant.string:
+      start: '"'
+      end: '"'
+      skip: "\\\\."
+      rules:
+        - constant.specialChar: "\\\\."
+
+  - constant.string:
+      start: "'"
+      end: "'"
+      skip: "\\\\."
+      rules:
+        - constant.specialChar: "\\\\."
+
+  - preproc:
+      start: "\\$(\\{|ENV\\{)"
+      end: "\\}"
+      rules: []
+
+  - identifier.macro: "\\b(APPLE|UNIX|WIN32|CYGWIN|BORLAND|MINGW|MSVC(_IDE|60|71|80|90)?)\\b"
+
+  - comment:
+      start: "#"
+      end: "$"
+      rules:
+        - todo: "(TODO|XXX|FIXME):?"

package/assets/syntax/crystal.yaml

@@ -0,0 +1,71 @@
+filetype: crystal
+
+detect:
+  filename: "\\.cr$"
+
+rules:
+  # Asciibetical list of reserved words
+  - statement: "\\b(abstract|alias|as|asm|begin|break|case|class|def|do|else|elsif|end|ensure|enum|extend|for|fun|if|in|include|instance_sizeof|lib|loop|macro|module|next|of|out|pointerof|private|protected|raise|require|rescue|return|select|self|sizeof|spawn|struct|super|then|type|typeof|uninitialized|union|unless|until|verbatim|when|while|with|yield)\\b"
+    # Constants
+  - constant: "\\b(true|false|nil)\\b"
+  - constant.number: "\\b[0-9]+\\b"
+    # Ones that can't be in the same regex because they include non-words.
+    # The nil? one has to be after the constants.
+  - statement: "\\b(nil\\?|as(\\?|\\b)|is_a\\?|responds_to\\?)"
+  - type: "(\\$|@|@@)?\\b[A-Z]+[0-9A-Z_a-z]*"
+    # Crystal "symbols"
+  - constant: "([ 	]|^):[0-9A-Z_]+\\b"
+    # Some unique things we want to stand out
+  - constant: "\\b(__FILE__|__LINE__)\\b"
+    # Regular expressions
+  - constant: "/([^/]|(\\\\/))*/[iomx]*|%r\\{([^}]|(\\\\}))*\\}[iomx]*"
+
+    # Shell command expansion is in `backticks` or like %x{this}.  These are
+    # "double-quotish" (to use a perlism).
+  - constant.string: "`[^`]*`|%x\\{[^}]*\\}"
+
+  - constant.string:
+      start: "`"
+      end: "`"
+      rules: []
+
+  - constant.string:
+      start: "%x\\{"
+      end: "\\}"
+      rules: []
+
+  - constant.string:
+      start: '"'
+      end: '"'
+      skip: "\\\\."
+      rules:
+        - constant.specialChar: "\\\\."
+        - symbol.brackets:
+            start: "#\\{"
+            end: "\\}"
+            rules:
+              - default: ".*"
+
+  - constant.string:
+      start: "'"
+      end: "'"
+      skip: "\\\\."
+      rules:
+        - constant.specialChar: "\\\\."
+
+  - comment:
+      start: "#"
+      end: "$"
+      rules:
+        - todo: "(TODO|XXX|FIXME):?"
+
+  - comment.bright:
+      start: "##"
+      end: "$"
+      rules:
+        - todo: "(TODO|XXX|FIXME):?"
+
+  - constant:
+      start: "<<-?'?EOT'?"
+      end: "^EOT"
+      rules: []

package/assets/syntax/csharp.yaml

@@ -0,0 +1,51 @@
+filetype: csharp
+
+detect:
+  filename: "\\.cs$"
+
+rules:
+  # Class
+  - identifier.class: "class +[A-Za-z0-9]+ *((:) +[A-Za-z0-9.]+)?"
+
+    # Annotation
+  - identifier.var: "@[A-Za-z]+"
+
+  - preproc: "^[[:space:]]*#[[:space:]]*(define|elif|else|endif|endregion|error|if|line|nullable|pragma|region|undef|warning)"
+  - identifier: "([A-Za-z0-9_]*[[:space:]]*[()])"
+  - type: "\\b(bool|byte|sbyte|char|decimal|double|float|IntPtr|int|uint|long|ulong|managed|unmanaged|nint|nuint|object|short|ushort|string|base|this|var|void)\\b"
+  - statement: "\\b(alias|as|case|catch|checked|default|do|dynamic|else|finally|fixed|for|foreach|goto|if|is|lock|new|null|return|switch|throw|try|unchecked|when|while|with)\\b"
+  - statement: "\\b(abstract|add|and|args|async|await|class|const|delegate|enum|event|explicit|extern|file|get|global|implicit|in|init|internal|interface|nameof|namespace|not|notnull|operator|or|out|override|params|partial|private|protected|public|readonly|record|ref|remove|required|scoped|sealed|set|sizeof|stackalloc|static|struct|typeof|unsafe|using|value|virtual|volatile|yield)\\b"
+    # LINQ-only keywords (ones that cannot be used outside of a LINQ query - lots others can)
+  - statement: "\\b(from|where|select|group|info|orderby|join|let|in|on|equals|by|ascending|descending)\\b"
+  - special: "\\b(break|continue)\\b"
+  - constant.bool: "\\b(true|false)\\b"
+  - symbol.operator: "[\\-+/*=<>?:!~%&|]"
+  - constant.number: "\\b([0-9._]+|0x[A-Fa-f0-9_]+|0b[0-1_]+)[FL]?\\b"
+
+  - constant.string:
+      start: '"'
+      end: '"'
+      skip: "\\\\."
+      rules:
+        - constant.specialChar: "\\\\([btnfr]|'|\\\"|\\\\)"
+        - constant.specialChar: "\\\\u[A-Fa-f0-9]{4}"
+
+  - constant.string:
+      start: "'"
+      end: "'"
+      skip: "\\\\."
+      rules:
+        - constant.specialChar: "\\\\([btnfr]|'|\\\"|\\\\)"
+        - constant.specialChar: "\\\\u[A-Fa-f0-9]{4}"
+
+  - comment:
+      start: "//"
+      end: "$"
+      rules:
+        - todo: "(TODO|XXX|FIXME):?"
+
+  - comment:
+      start: "/\\*"
+      end: "\\*/"
+      rules:
+        - todo: "(TODO|XXX|FIXME):?"

package/assets/syntax/dart.yaml

@@ -0,0 +1,45 @@
+filetype: dart
+
+detect:
+  filename: "\\.dart$"
+
+rules:
+  - constant.number: "\\b[-+]?([1-9][0-9]*|0[0-7]*|0x[0-9a-fA-F]+)([uU][lL]?|[lL][uU]?)?\\b"
+  - constant.number: "\\b[-+]?([0-9]+\\.[0-9]*|[0-9]*\\.[0-9]+)([EePp][+-]?[0-9]+)?[fFlL]?"
+  - constant.number: "\\b[-+]?([0-9]+[EePp][+-]?[0-9]+)[fFlL]?"
+  - identifier: "[A-Za-z_][A-Za-z0-9_]*[[:space:]]*[(]"
+  - statement: "\\b(break|case|catch|continue|default|else|finally)\\b"
+  - statement: "\\b(for|function|get|if|in|as|is|new|return|set|switch|final|await|async|sync)\\b"
+  - statement: "\\b(switch|this|throw|try|var|void|while|with|import|library|part|const|export)\\b"
+  - constant: "\\b(true|false|null)\\b"
+  - type: "\\b(List|String)\\b"
+  - type: "\\b(int|num|double|bool)\\b"
+  - statement: "[-+/*=<>!~%?:&|]"
+  - constant: "/[^*]([^/]|(\\\\/))*[^\\\\]/[gim]*"
+  - constant: "\\\\[0-7][0-7]?[0-7]?|\\\\x[0-9a-fA-F]+|\\\\[bfnrt'\"\\?\\\\]"
+
+  - comment:
+      start: "//"
+      end: "$"
+      rules:
+        - todo: "TODO:?"
+
+  - comment:
+      start: "/\\*"
+      end: "\\*/"
+      rules:
+        - todo: "TODO:?"
+
+  - constant.string:
+      start: '"'
+      end: '"'
+      skip: "\\\\."
+      rules:
+        - constant.specialChar: "\\\\."
+
+  - constant.string:
+      start: "'"
+      end: "'"
+      skip: "\\\\."
+      rules:
+        - constant.specialChar: "\\\\."

package/assets/syntax/elm.yaml

@@ -0,0 +1,38 @@
+filetype: elm
+
+detect:
+  filename: "\\.elm$"
+
+rules:
+  - statement: "\\b(as|alias|case|else|exposing|if|import|in|let|module|of|port|then|type|)\\b"
+  - statement: "(\\=|\\:|\\->)"
+  - type: "\\b([A-Z][A-Za-z\\d]*)\\b"
+  - identifier: "^([a-z][A-Za-z\\d]*)\\b"
+  - constant.string:
+      start: '"""'
+      end: '"""'
+      skip: "\\\\."
+      rules:
+        - constant.specialChar: "\\\\."
+  - constant.string:
+      start: '"'
+      end: '"'
+      skip: "\\\\."
+      rules:
+        - constant.specialChar: "\\\\."
+  - constant.string:
+      start: "'"
+      end: "'"
+      skip: "\\\\."
+      rules:
+        - constant.specialChar: "\\\\."
+  - comment:
+      start: "--"
+      end: "$"
+      rules:
+        - todo: "(TODO|XXX|FIXME):?"
+  - comment:
+      start: "\\{-"
+      end: "-\\}"
+      rules:
+        - todo: "(TODO|XXX|FIXME):?"

package/assets/syntax/erb.yaml

@@ -0,0 +1,42 @@
+filetype: erb
+
+detect:
+  filename: "\\.erb$|\\.rhtml$"
+
+rules:
+  - error: "<[^!].*?>"
+  - symbol.tag: "(?i)<[/]?(a(bbr|cronym|ddress|pplet|rea|rticle|side|udio)?|b(ase(font)?|d(i|o)|ig|lockquote|r)?|ca(nvas|ption)|center|cite|co(de|l|lgroup)|d(ata(list)?|d|el|etails|fn|ialog|ir|l|t)|em(bed)?|fieldset|fig(caption|ure)|font|form|(i)?frame|frameset|h[1-6]|hr|i|img|in(put|s)|kbd|keygen|label|legend|li(nk)?|ma(in|p|rk)|menu(item)?|met(a|er)|nav|no(frames|script)|o(l|pt(group|ion)|utput)|p(aram|icture|re|rogress)?|q|r(p|t|uby)|s(trike)?|samp|se(ction|lect)|small|source|span|strong|su(b|p|mmary)|textarea|time|track|u(l)?|var|video|wbr)( .*|>)*?>"
+  - symbol.tag.extended: "(?i)<[/]?(body|div|html|head(er)?|footer|title|table|t(body|d|h(ead)?|r|foot))( .*|>)*?>"
+  - preproc: "(?i)<[/]?(script|style)( .*|>)*?>"
+  - special: "&[^;[[:space:]]]*;"
+  - symbol: "[:=]"
+  - identifier: "(alt|bgcolor|height|href|id|label|longdesc|name|onclick|onfocus|onload|onmouseover|size|span|src|style|target|type|value|width)="
+  - constant.string: '"[^"]*"'
+  - constant.number: "(?i)#[0-9a-fA-F]{6,6}"
+  - constant.string.url: "(ftp(s)?|http(s)?|git|chrome)://[^ 	]+"
+  - comment: "<!--.+?-->"
+  - preproc: "<!DOCTYPE.+?>"
+  - default:
+      start: "<%"
+      end: "%>"
+      rules: []
+
+  - preproc: "<%|%>"
+  - red: "&[^;[[:space:]]]*;"
+  - statement: "\\b(BEGIN|END|alias|and|begin|break|case|class|def|defined\\?|do|else|elsif|end|ensure|false|for|if|in|module|next|nil|not|or|redo|rescue|retry|return|self|super|then|true|undef|unless|until|when|while|yield)\\b"
+  - identifier.var: "(\\$|@|@@)?\\b[A-Z]+[0-9A-Z_a-z]*"
+  - magenta: "(?i)([  ]|^):[0-9A-Z_]+\\b"
+  - identifier.macro: "\\b(__FILE__|__LINE__)\\b"
+  - brightmagenta: "!/([^/]|(\\\\/))*/[iomx]*|%r\\{([^}]|(\\\\}))*\\}[iomx]*"
+  - brightblue: "`[^`]*`|%x\\{[^}]*\\}"
+  - constant.string: "\"([^\"]|(\\\\\"))*\"|%[QW]?\\{[^}]*\\}|%[QW]?\\([^)]*\\)|%[QW]?<[^>]*>|%[QW]?\\[[^]]*\\]|%[QW]?\\$[^$]*\\$|%[QW]?\\^[^^]*\\^|%[QW]?![^!]*!"
+  - brightgreen: "#\\{[^}]*\\}"
+  - green: "'([^']|(\\\\'))*'|%[qw]\\{[^}]*\\}|%[qw]\\([^)]*\\)|%[qw]<[^>]*>|%[qw]\\[[^]]*\\]|%[qw]\\$[^$]*\\$|%[qw]\\^[^^]*\\^|%[qw]![^!]*!"
+  - comment: "#[^{].*$|#$"
+  - comment.bright: "##[^{].*$|##$"
+  - identifier.macro:
+      start: "<<-?'?EOT'?"
+      end: "^EOT"
+      rules: []
+
+  - todo: "(XXX|TODO|FIXME|\\?\\?\\?)"

package/assets/syntax/erlang.yaml

@@ -0,0 +1,45 @@
+filetype: erlang
+
+detect:
+  filename: "\\.erl$"
+
+rules:
+  - identifier: "\\b[A-Z][0-9a-z_]*\\b"
+  # See: https://erlang.org/doc/reference_manual/data_types.html
+  - constant.number: "\\b[0-9]+(\\.[0-9]+)?(e-?[0-9]+)?\\b"
+  - constant.number: "\\b[0-9]{1,2}\\#[a-zA-Z0-9]+\\b"
+  - constant.bool: "\\b(true|false)\\b"
+  - constant.number: "\\$\\\\?\\S{1}"
+  # See: https://erlang.org/doc/reference_manual/introduction.html
+  - statement: "\\b(after|and|andalso|band|begin|bnot|bor|bsl|bsr|bxor|case|catch|cond|div|end|fun|if|let|not|of|or|orelse|receive|rem|try|when|xor)\\b"
+  # See: https://erlang.org/doc/reference_manual/macros.html
+  - preproc: "\\-(module|export|record|include|include_lib|define|undef|ifdef|ifndef|else|endif|if|elif|error|warning)\\b"
+  - identifier.macro: "\\?[A-Z0-9_]+\\b"
+  # See: https://erlang.org/doc/man/erlang.html
+  - special: "\\b(ext_binary|binary|iovec|message_queue_data|time(_unit|stamp)|abs|apply|atom(_to_binary|_to_list)|binary_(part|to_atom|to_existing_atom|to_float|to_integer|to_list|to_term)|bit(_size|string_to_list)|byte_size|ceil|check_(old_code|process_code)|date|delete_module|demonitor|disconnect_node|element|erase|error|exit|float(_to_binary|_to_list)?|floor|garbage_collect|get|group_leader|halt|integer(_to_binary|to_list)|iolist_(size|to_binary)|is_(alive|atom|binary|bitstring|boolean|float|function|integer|list|map|map_key|number|pid|port|process_alive|record|reference|tuple|length)|link|list_to_(atom|binary|bitstring|existing_atom|float|integer|pid|port|ref|tuple)|load_module|make_ref|map_(get|size)|max|min|module_loaded|monitor(_node)?|nodes?|now|open_port|pid_to_list|port(_close|command|connect|control|to_list)|pre_loaded|process(_flag|_info|es)|purge_module|put|register(ed)?|round|self|setelement|size|spawn(_link|_monitor|_opt|_binary)?|statistics|trunc|tuple_(size|to_list)|unlink|unregister|whereis)\\b"
+  # See: https://erlang.org/doc/reference_manual/data_types.html#atom
+  - symbol:
+      start: "'"
+      end: "'"
+      skip: "\\\\."
+      rules: []
+  #            - constant.specialChar: "%."
+  #            - constant.specialChar: "\\\\[abfnrtv'\\\"\\\\]"
+  #            - constant.specialChar: "\\\\([0-7]{3}|x[A-Fa-f0-9]{2}|u[A-Fa-f0-9]{4}|U[A-Fa-f0-9]{8})"
+  - constant.string:
+      start: '"'
+      end: '"'
+      skip: "\\\\."
+      rules:
+        - constant.specialChar: "%."
+        - constant.specialChar: "\\\\[abfnrtv'\\\"\\\\]"
+        - constant.specialChar: "\\\\([0-7]{3}|x[A-Fa-f0-9]{2}|u[A-Fa-f0-9]{4}|U[A-Fa-f0-9]{8})"
+  - comment:
+      start: "\\(\\*"
+      end: "\\*\\)"
+      rules:
+        - todo: "(TODO|FIXME|WONTFIX|NOTE|HACK):?"
+  - comment:
+      start: "%"
+      end: "$"
+      rules: []

package/assets/syntax/fsharp.yaml

@@ -0,0 +1,48 @@
+filetype: fsharp
+
+detect:
+  filename: "\\.fs?$"
+
+rules:
+  - identifier: "\\b[A-Z][0-9a-z_]{2,}\\b"
+    #declarations
+  - statement: "\\b(let|val|method|in|and|rec|private|virtual|constraint)\\b"
+    #structure items
+  - type: "\\b(type|open|class|module|exception|external)\\b"
+    #patterns
+  - statement: "\\b(fun|function|functor|match|try|with)\\b"
+    #patterns-modifiers
+  - statement: "\\b(as|when|of)\\b"
+    #conditions
+  - statement: "\\b(if|then|else)\\b"
+    #blocs
+  - type: "\\b(begin|end|object|struct|sig|for|while|do|done|to|downto)\\b"
+    #constantes
+  - constant.bool: "\\b(true|false)\\b"
+    #modules/classes
+  - special: "\\b(include|inherit|initializer)\\b"
+    #expr modifiers
+  - special: "\\b(new|ref|mutable|lazy|assert|raise)\\b"
+    #keywords which don't exist in ocaml
+  - type: "\\b(base|delegate|downcast|extern|finally|fixed|global|inline|interface|internal|let!|member|namespace|null|override|private|public)\\b"
+  - type: "\\b(return|return!|select|static|upcast|use|use!|void|yield|yield!)\\b"
+  - constant.string:
+      start: "'"
+      end: "'"
+      skip: "\\\\."
+      rules:
+        - constant.specialChar: "%."
+        - constant.specialChar: "\\\\[abfnrtv'\\\"\\\\]"
+        - constant.specialChar: "\\\\([0-7]{3}|x[A-Fa-f0-9]{2}|u[A-Fa-f0-9]{4}|U[A-Fa-f0-9]{8})"
+  - constant.string:
+      start: '"'
+      end: '"'
+      skip: "\\\\."
+      rules:
+        - constant.specialChar: "%."
+        - constant.specialChar: "\\\\[abfnrtv'\\\"\\\\]"
+        - constant.specialChar: "\\\\([0-7]{3}|x[A-Fa-f0-9]{2}|u[A-Fa-f0-9]{4}|U[A-Fa-f0-9]{8})"
+  - comment:
+      start: "\\(\\*"
+      end: "\\*\\)"
+      rules: []

package/assets/syntax/graphql.yaml

@@ -0,0 +1,47 @@
+filetype: graphql
+
+detect:
+  filename: "\\.(gql|graphql)$"
+
+rules:
+  - type: "\\b(?:(query|mutation|subscription|type|input|scalar|fragment|schema|union|on|extends?))\\b"
+
+  # scalar types
+  - statement: "\\b(ID|Int|Float|Boolean|String|Datetime|Null)\\b"
+
+  # introspection types
+  - statement: "(__\\w+)"
+
+  # parameters
+  - statement: "((\\w+)(?:\\:([\\s]*)?)(?:\\$))"
+
+  # directive locations
+  - statement: "\\b(QUERY|MUTATION|SUBSCRIPTION|FIELD|FRAGMENT_DEFINITION|FRAGMENT_SPREAD|INLINE_FRAGMENT|SCHEMA|SCALAR|OBJECT|FIELD_DEFINITION|ARGUMENT_DEFINITION|INTERFACE|UNION|ENUM|ENUM_VALUE|INPUT_OBJECT|INPUT_FIELD_DEFINITION)\\b"
+
+  # directives
+  - constant: "(@\\w+)"
+
+  # root types
+  - constant: "\\b(Query|Mutation|Subscription|Schema|Root)\\b"
+
+  # variables
+  - special: "(\\$\\w+)"
+
+  # required symbol
+  - special: "(!)"
+
+  - symbol: "(:|=|\\||\\(|\\)|\\{|\\}|\\[|\\])"
+
+  - constant.bool: "\\b(true|false)\\b"
+
+  - constant.string:
+      start: '"'
+      end: '"'
+      skip: "\\\\."
+      rules:
+        - constant.specialChar: "\\\\."
+
+  - comment:
+      start: "#"
+      end: "$"
+      rules: []