Release 1.16.1

.vscodeignore

@@ -15,8 +15,11 @@ esbuild.js
 sonar-project.properties
 .snyk 
 eslint.config.cjs
+eslint.config.mjs
 release_process.md
 .github/
 out-test/
 .test-extensions/
 .test-folder/
+.README
+REFCARD.md 

CHANGELOG.md

@@ -2,6 +2,15 @@
 
 All notable changes to the **kdb VS Code extension** are documented in this file.
 
+# v1.16.1
+
+### Fixes
+
+- Updated Keycloak URL configuration to support Insights Enterprise 1.17
+- Resolved an issue with REPL system command path
+- Improved clarity and layout of the welcome page
+- Updated and refined documentation
+
 # v1.16.0
 
 ### Enhancements

REFCARD.md

@@ -0,0 +1,69 @@
+## Command Palette
+
+| Command                | Command                   | Command                             |
+| :--------------------- | :------------------------ | :---------------------------------- |
+| KX: Welcome to KDB-X   | KX: New Connection        | KX: Focus on Connections view       |
+| KX: Install KDB-X      | KX: New Notebook          | KX: Focus on Datasources view       |
+| KX: Start REPL         | KX: New Workbook (q)      | KX: Focus on Workbooks view         |
+| KX: Import Connections | KX: New Workbook (Python) | KX: Focus on Query History view     |
+| KX: Export Connections | KX: New Datasource        | KX: Focus on Help and Feedback view |
+
+## Keybindings
+
+| Command                       | When                  | Shortcut                     |
+| :---------------------------- | :-------------------- | :--------------------------- |
+| KX: Execute Entire File       | `q` `py` `sql`        | `ctrl`/`⌘` +`shift`+`d`      |
+| KX: Execute Current Selection | `q` `py` `sql`        | `ctrl`/`⌘`+`d`               |
+| KX: Execute Current Block     | `q`                   | `ctrl`/`⌘`+`shift`+`e`       |
+| KX: Populate Scratchpad       | `q` `py` `sql`        | `ctrl`/`⌘`+`shift`+`alt`+`p` |
+| KX: Reset Scratchpad          | `q` `py` `sql` `kxnb` | `ctrl`/`⌘`+`shift`+`delete`  |
+| KX: Choose Connection         | `q` `py` `sql` `kxnb` |                              |
+| KX: Choose Execution Target   | `q` `py` `sql`        | `ctrl`/`⌘`+`alt`+`t`         |
+| KX: Toggle Parameter Cache    | `q`                   | `ctrl`/`⌘`+`shift`+`y`       |
+
+### REPL
+
+| Shortcut    | Action                 | Shortcut       | Action                            |
+| :---------- | :--------------------- | :------------- | :-------------------------------- |
+| `RETURN`    | Execute command line   | `END`          | Move cursor to end                |
+| `BACKSPACE` | Delete left of cursor  | `shift`+`←`    | Move cursor left                  |
+| `DEL`       | Delete right of cursor | `shift`+`→`    | Move cursor right                 |
+| `←`         | Move cursor left       | `shift`+`↑`    | Move cursor up                    |
+| `→`         | Move cursor right      | `shift`+`↓`    | Move cursor down                  |
+| `↑`         | History                | `ctrl`/`⌘`+`v` | Paste code                        |
+| `↓`         | History                | `ctrl`+`c`     | Stop execution (Reset on Windows) |
+| `HOME`      | Move cursor to start   | `ctrl`+`d`     | Reset                             |
+
+## Settings
+
+| Setting                                                                                   | Scope    | Type      | Default       |
+| :---------------------------------------------------------------------------------------- | :------- | :-------- | :------------ |
+| [kdb.qHomeDirectory](https://github.com/KxSystems/kx-vscode/wiki/qHomeDirectory)          | machine  | `string`  | `""`          |
+| kdb.servers                                                                               | machine  | `object`  | `{}`          |
+| kdb.insightsEnterpriseConnections                                                         | machine  | `object`  | `{}`          |
+| kdb.connectionLabels                                                                      | machine  | `array`   | `[]`          |
+| kdb.labelsConnectionMap                                                                   | machine  | `array`   | `[]`          |
+| kdb.hideSurvey                                                                            | machine  | `boolean` | `false`       |
+| kdb.hideSourceExpressions                                                                 | machine  | `boolean` | `true`        |
+| kdb.hideSubscribeRegistrationNotification                                                 | machine  | `boolean` | `false`       |
+| kdb.neverShowQInstallAgain                                                                | machine  | `boolean` | `false`       |
+| kdb.autoFocusOutputOnEntry                                                                | machine  | `boolean` | `true`        |
+| [kdb.qHomeDirectoryWorkspace](https://github.com/KxSystems/kx-vscode/wiki/qHomeDirectory) | resource | `string`  | `""`          |
+| kdb.connectionMap                                                                         | resource | `object`  | `{}`          |
+| kdb.targetMap                                                                             | resource | `object`  | `{}`          |
+| kdb.linting                                                                               | resource | `boolean` | `false`       |
+| kdb.refactoring                                                                           | resource | `string`  | `"Workspace"` |
+
+## Execution
+
+| Type       | REPL | My q | IE SP | IE q/SQL | IE API | IE UDA | IE Populate SP |
+| :--------- | :--: | :--: | :---: | :------: | :----: | :----: | :------------: |
+| File `q`   |  ✓   |  ✓   |   ✓   |    ✓     |        |        |       ✓        |
+| File `py`  |  ✓   |  ✓   |   ✓   |    ✓     |        |        |       ✓        |
+| File `sql` |  ✓   |      |       |    ✓     |        |        |       ✓        |
+| Cell `q`   |  ✓   |  ✓   |   ✓   |    ✓     |        |        |       ✓        |
+| Cell `py`  |  ✓   |  ✓   |   ✓   |    ✓     |        |        |       ✓        |
+| Cell `sql` |  ✓   |      |       |    ✓     |        |        |       ✓        |
+| Datasource |      |      |       |    ✓     |   ✓    |   ✓    |       ✓        |
+
+`REPL` and `My q` requires [PyKX](https://github.com/KxSystems/kx-vscode/wiki/Use-PyKX-Within-REPL) for Python support.

package.json

@@ -3,7 +3,7 @@
   "displayName": "kdb",
   "description": "IDE support for kdb product suite including the q programming language",
   "publisher": "KX",
-  "version": "1.16.0",
+  "version": "1.16.1",
   "engines": {
     "vscode": "^1.96.0"
   },
@@ -107,7 +107,7 @@
         },
         "kdb.linting": {
           "type": "boolean",
-          "description": "Enable linting for q and quke files",
+          "description": "Enable linting",
           "default": false,
           "scope": "resource"
         },
@@ -167,7 +167,7 @@
       {
         "category": "KX",
         "command": "kdb.connections.export.all",
-        "title": "Export connections"
+        "title": "Export Connections"
       },
       {
         "category": "KX",
@@ -177,7 +177,7 @@
       {
         "category": "KX",
         "command": "kdb.connections.import",
-        "title": "Import connections"
+        "title": "Import Connections"
       },
       {
         "category": "KX",
@@ -188,7 +188,7 @@
       {
         "category": "KX",
         "command": "kdb.datasource.create",
-        "title": "New KX Datasource",
+        "title": "New Datasource",
         "icon": "$(add)"
       },
       {
@@ -201,7 +201,7 @@
       {
         "category": "KX",
         "command": "kdb.scratchpad.create",
-        "title": "New KX Workbook (q)",
+        "title": "New Workbook (q)",
         "icon": {
           "dark": "./resources/dark/add-scratchpad.svg",
           "light": "./resources/light/add-scratchpad.svg"
@@ -210,7 +210,7 @@
       {
         "category": "KX",
         "command": "kdb.scratchpad.python.create",
-        "title": "New KX Workbook (Python)",
+        "title": "New Workbook (Python)",
         "icon": {
           "dark": "./resources/dark/add-scratchpad-python.svg",
           "light": "./resources/light/add-scratchpad-python.svg"
@@ -235,14 +235,14 @@
       {
         "category": "KX",
         "command": "kdb.file.pickConnection",
-        "title": "Chooses Connection",
+        "title": "Choose Connection",
         "shortTitle": "Connection",
         "icon": "$(cloud)"
       },
       {
         "category": "KX",
         "command": "kdb.file.pickTarget",
-        "title": "Choose Target",
+        "title": "Choose Execution Target",
         "shortTitle": "Target",
         "icon": "$(target)"
       },
@@ -252,7 +252,6 @@
         "title": "Input Variable Name"
       },
       {
-        "category": "KX",
         "command": "kdb.file.populateScratchpad",
         "title": "KX: Populate Scratchpad",
         "icon": "$(debug-rerun)"
@@ -265,17 +264,17 @@
       {
         "category": "KX",
         "command": "kdb.scratchpad.reset",
-        "title": "Reset scratchpad"
+        "title": "Reset Scratchpad"
       },
       {
         "category": "KX",
         "command": "kdb.scratchpad.editor.reset",
-        "title": "Reset editor connection"
+        "title": "Reset Scratchpad"
       },
       {
         "category": "KX",
         "command": "kdb.connections.add",
-        "title": "New KX Connection",
+        "title": "New Connection",
         "icon": "$(add)"
       },
       {
@@ -316,7 +315,7 @@
       {
         "category": "KX",
         "command": "kdb.connections.addAuthentication",
-        "title": "Add Authentication",
+        "title": "Add authentication",
         "position": "end"
       },
       {
@@ -376,25 +375,21 @@
         "title": "Start REPL"
       },
       {
-        "category": "KX",
         "command": "kdb.execute.selectedQuery",
         "title": "KX: Execute Current Selection",
         "icon": "$(run-above)"
       },
       {
-        "category": "KX",
         "command": "kdb.execute.fileQuery",
         "title": "KX: Execute Entire File",
         "icon": "$(run)"
       },
       {
-        "category": "KX",
         "command": "kdb.scratchpad.python.run",
         "title": "KX: Execute Current Selection",
         "icon": "$(run-above)"
       },
       {
-        "category": "KX",
         "command": "kdb.scratchpad.python.run.file",
         "title": "KX: Execute Entire File",
         "icon": "$(run)"
@@ -415,7 +410,6 @@
         "title": "Delete"
       },
       {
-        "category": "KX",
         "command": "kdb.execute.block",
         "title": "KX: Execute Current Block",
         "icon": "$(run-below)"
@@ -463,7 +457,7 @@
       {
         "category": "KX",
         "command": "kdb.createNotebook",
-        "title": "New KX Notebook"
+        "title": "New Notebook"
       }
     ],
     "keybindings": [
@@ -495,7 +489,7 @@
         "command": "kdb.scratchpad.editor.reset",
         "key": "ctrl+shift+delete",
         "mac": "cmd+shift+delete",
-        "when": "resourceFilename =~ /\\.(?:q|py|sql)$/i"
+        "when": "resourceFilename =~ /\\.(?:q|py|sql|kxnb)$/i"
       },
       {
         "command": "kdb.file.populateScratchpad",
@@ -513,13 +507,13 @@
         "command": "kdb.toggleParameterCache",
         "key": "ctrl+shift+y",
         "mac": "cmd+shift+y",
-        "when": "resourceFilename =~ /\\.(?:q|quke)$/i"
+        "when": "resourceFilename =~ /\\.(?:q)$/i"
       },
       {
         "command": "kdb.file.pickTarget",
         "key": "ctrl+alt+t",
         "mac": "cmd+alt+t",
-        "when": "kdb.connected.active && resourceFilename =~ /\\.(?:q|py)$/i"
+        "when": "resourceFilename =~ /\\.(?:q|py|sql)$/i"
       }
     ],
     "snippets": [
@@ -703,19 +697,19 @@
         },
         {
           "command": "kdb.file.pickConnection",
-          "when": "false"
+          "when": "resourceFilename =~ /\\.(?:q|py|sql|kxnb)$/i"
         },
         {
           "command": "kdb.file.pickTarget",
-          "when": "false"
+          "when": "resourceFilename =~ /\\.(?:q|py|sql)$/i"
         },
         {
           "command": "kdb.file.inputVariable",
           "when": "false"
         },
         {
           "command": "kdb.file.populateScratchpad",
-          "when": "false"
+          "when": "resourceFilename =~ /\\.(?:q|py|sql)$/i"
         },
         {
           "command": "kdb.scratchpad.run",
@@ -727,7 +721,7 @@
         },
         {
           "command": "kdb.scratchpad.editor.reset",
-          "when": "false"
+          "when": "resourceFilename =~ /\\.(?:q|py|sql|kxnb)$/i"
         },
         {
           "command": "kdb.connections.add",
@@ -811,19 +805,19 @@
         },
         {
           "command": "kdb.execute.selectedQuery",
-          "when": "false"
+          "when": "resourceFilename =~ /\\.(?:q|sql)$/i"
         },
         {
           "command": "kdb.execute.fileQuery",
-          "when": "false"
+          "when": "resourceFilename =~ /\\.(?:q|sql)$/i"
         },
         {
           "command": "kdb.scratchpad.python.run",
-          "when": "false"
+          "when": "resourceFilename =~ /\\.(?:py)$/i"
         },
         {
           "command": "kdb.scratchpad.python.run.file",
-          "when": "false"
+          "when": "resourceFilename =~ /\\.(?:py)$/i"
         },
         {
           "command": "kdb.ls.q.lint",
@@ -839,11 +833,11 @@
         },
         {
           "command": "kdb.execute.block",
-          "when": "false"
+          "when": "resourceFilename =~ /\\.(?:q)$/i"
         },
         {
           "command": "kdb.toggleParameterCache",
-          "when": "true"
+          "when": "resourceFilename =~ /\\.(?:q)$/i"
         },
         {
           "command": "kdb.connections.labels.rename",
@@ -1073,7 +1067,7 @@
         {
           "command": "kdb.execute.block",
           "group": "q1@2",
-          "when": "resourceFilename =~ /\\.(?:q|sql)$/i"
+          "when": "resourceFilename =~ /\\.(?:q)$/i"
         },
         {
           "command": "kdb.file.populateScratchpad",
@@ -1095,7 +1089,7 @@
         {
           "command": "kdb.execute.block",
           "group": "q@2",
-          "when": "resourceFilename =~ /\\.(?:q|sql)$/i"
+          "when": "resourceFilename =~ /\\.(?:q)$/i"
         },
         {
           "command": "kdb.file.populateScratchpad",