Merge branch 'topic/colors' into 'master'

Add two color themes: GNAT Studio Light and Dark

See merge request eng/ide/ada_language_server!2223

Author: reznikmm

CHANGELOG.md

@@ -8,8 +8,9 @@ section below it for the last release. -->
 * Support `textDocument/definition` for source file references in GPR files
 * Display fully qualified names in the `labelDetails` and `detail` field of completion items
 * Do not propose completion after a `.` in Ada comments
-* Highlight `finally` keyword (from Ada extension) with semantic tokens.
+* Highlight `finally` keyword (from Ada extension) with semantic tokens
 * Prompt the user to restart the Ada Language Server when the workspace `.als.json` configuration file is modified
+* Two color themes **GNAT Studio Light** and **GNAT Studio Dark**
 
 ## 2026.1.202601121
 

doc/Custom-colors-in-VS-Code.md

@@ -1,4 +1,16 @@
-# Custom colors
+# Color Themes and Highlighting Customization
+
+The primary method for colorizing Ada code in the VS Code extension is
+selecting a color theme.
+Two custom color themes, **GNAT Studio Light** and **GNAT Studio Dark**,
+are available in the extension.
+These themes are designed to visually resemble the light and dark themes
+available in GNAT Studio.
+
+For extended customization and configuration, the extension leverages
+standard VS Code mechanisms for semantic and syntax highlighting:
+
+## Semantic Highlighting
 
 Since 23.0.6 Ada Language Server provides
 [Semantic token provider](https://code.visualstudio.com/api/language-extensions/semantic-highlight-guide).
@@ -9,6 +21,7 @@ But not all token types and modifier combination are visually distinguishable th
 
 Users are welcome to [customize colors](https://code.visualstudio.com/docs/getstarted/themes#_customizing-a-color-theme) to visualize more token types and modifier combinations. This guide provides more details for this and a customization example.
 
+## Syntax Highlighting
 In addition to semantic highlighting, users can customize syntax highlighting for keywords, strings, comments or numbers: syntax highlighting will be used for those when the corresponding tokens are not associated with any modifier. Syntax highlighting customization should be made via TextMate rules, which associate _scopes_ and a given style (color, font etc.). 
 
 You can use the [Developer: Inspect editor tokens and scopes](https://www.youtube.com/watch?v=mC_htrJ1QPg&ab_channel=Code2020) command to know the scope of a given token (see the screenshot below). 

integration/vscode/ada/package.json

@@ -129,7 +129,7 @@
                 "language": "ada",
                 "scopes": {
                     "namespace": [
-                        "entity.name.label.ada"
+                        "entity.name.namespace.ada"
                     ],
                     "type": [
                         "entity.name.type.ada"
@@ -147,7 +147,7 @@
                         "entity.name.type.struct.ada"
                     ],
                     "typeParameter": [
-                        "variable.other.constant.parameter.ada"
+                        "variable.other.constant.discriminant.ada"
                     ],
                     "parameter": [
                         "entity.name.variable.parameter.ada"
@@ -281,12 +281,39 @@
                     "variable.globalVariable": [
                         "variable.other.global.ada"
                     ],
+                    "variable.globalVariable.declaration": [
+                        "variable.other.global.ada"
+                    ],
+                    "variable.globalVariable.declaration.readonly": [
+                        "variable.other.constant.ada"
+                    ],
                     "variable.localVariable": [
                         "variable.other.local.ada"
+                    ],
+                    "variable.globalVariable.readonly": [
+                        "variable.other.constant.ada"
+                    ],
+                    "variable.declaration": [
+                        "variable.other.local.ada"
+                    ],
+                    "variable.declaration.readonly": [
+                        "variable.other.constant.ada"
                     ]
                 }
             }
         ],
+        "themes": [
+            {
+                "label": "GNAT Studio Light",
+                "uiTheme": "vs",
+                "path": "./themes/gnat-studio-light.json"
+            },
+            {
+                "label": "GNAT Studio Dark",
+                "uiTheme": "vs-dark",
+                "path": "./themes/gnat-studio-dark.json"
+            }
+        ],
         "snippets": [
             {
                 "language": "ada",