[#9] Context-aware completions for various newer settings

Author: nk9

Completions/Settings.sublime-completions

@@ -3,22 +3,44 @@
     "completions": [
         {
             "trigger": "allow-duplicate-recipes",
-            "details": "Later recipes override earlier",
+            "details": "Later recipes override earlier ones",
+            "kind": ["keyword", "k", "setting"]
+        },
+        {
+            "trigger": "allow-duplicate-variables",
+            "details": "Later variables override earlier ones",
+            "kind": ["keyword", "k", "setting"]
+        },
+        {
+            "trigger": "dotenv-filename",
+            "contents": "dotenv-filename := \"$1\"",
+            "details": "Load .env file with a custom name, if present",
             "kind": ["keyword", "k", "setting"]
         },
         {
             "trigger": "dotenv-load",
-            "details": "Load .env file, if it exists",
+            "details": "Load .env file, if present",
+            "kind": ["keyword", "k", "setting"]
+        },
+        {
+            "trigger": "dotenv-path",
+            "contents": "dotenv-path := \"$1\"",
+            "details": "Load .env file at path. Overrides dotenv-filename",
+            "kind": ["keyword", "k", "setting"]
+        },
+        {
+            "trigger": "dotenv-required",
+            "details": "Error if a .env file isn't found",
             "kind": ["keyword", "k", "setting"]
         },
         {
             "trigger": "export",
-            "details": "Export all variables",
+            "details": "Export all variables to recipes",
             "kind": ["keyword", "k", "setting"]
         },
         {
             "trigger": "fallback",
-            "details": "Search up directory tree",
+            "details": "Search up directory tree for justfile",
             "kind": ["keyword", "k", "setting"]
         },
         {
@@ -31,19 +53,44 @@
             "details": "Pass positional arguments",
             "kind": ["keyword", "k", "setting"]
         },
+        {
+            "trigger": "quiet",
+            "details": "Disable line echoing by default",
+            "kind": ["keyword", "k", "setting"]
+        },
+        {
+            "trigger": "script-interpreter",
+            "contents": "script-interpreter := [\"${1:bash}\", \"${2:-uc}\"]",
+            "details": "Command for recipes with empty <code>[script]</code>",
+            "kind": ["keyword", "k", "setting"]
+        },
         {
             "trigger": "shell",
+            "contents": "shell := [\"${1:bash}\", \"${2:-uc}\"]",
             "details": "Command for recipes/backticks",
             "kind": ["keyword", "k", "setting"]
         },
         {
             "trigger": "tempdir",
+            "contents": "tempdir := \"$1\"",
             "details": "Path to create temp directories",
             "kind": ["keyword", "k", "setting"]
         },
+        {
+            "trigger": "unstable",
+            "details": "Enable unstable features",
+            "kind": ["keyword", "k", "setting"]
+        },
         {
             "trigger": "windows-shell",
-            "details": "Command for recipes/backticks",
+            "contents": "windows-shell := [\"${1:pwsh.exe}\", \"${2:-NoLogo}\", \"${3:-NoProfile}\"]",
+            "details": "Windows command for recipes/backticks",
+            "kind": ["keyword", "k", "setting"]
+        },
+        {
+            "trigger": "working-directory",
+            "contents": "working-directory := \"$1\"",
+            "details": "Working directory for recipes/backticks",
             "kind": ["keyword", "k", "setting"]
         },
     ]

Syntax/Just.sublime-syntax

@@ -108,12 +108,32 @@ variables:
     | without_extension
     )
   boolean_settings: |-
-    (?x: allow-duplicate-recipes | dotenv-load | export | fallback | ignore-comments
-    | positional-arguments | windows-powershell )
+    (?x:
+      allow-duplicate-recipes
+    | allow-duplicate-variables
+    | dotenv-load
+    | export
+    | fallback
+    | ignore-comments
+    | positional-arguments
+    | quiet
+    | unstable
+    )
   string_settings: |-
-    (?x: tempdir )
+    (?x:
+      dotenv-filename
+    | dotenv-path
+    | tempdir
+    | working-directory
+    )
   shell_settings: |-
-    (?x: shell | windows-shell )
+    (?x:
+      script-interpreter
+    | shell
+    | windows-shell
+    )
+  deprecated_settings: |-
+    (?x: windows-powershell )
   recipe_attributes: |-
     (?x: linux | macos | no-cd | no-exit-message | private | unix | windows )
 
@@ -614,6 +634,7 @@ contexts:
     - include: settings-boolean-name
     - include: settings-shell-name
     - include: settings-string-name
+    - include: settings-deprecated-name
     - include: settings-invalid-name
     - include: else-pop
 
@@ -631,6 +652,12 @@ contexts:
     - include: else-pop
     - include: eol-pop
 
+  settings-deprecated-name:
+    - match: ({{deprecated_settings}})\b
+      captures:
+        1: invalid.deprecated.just
+      push: eol-pop
+
   settings-invalid-name:
     - match: ({{valid_name}})\b\s*:=
       captures:

Syntax/tests/syntax_test_just.settings.just

@@ -40,7 +40,7 @@ set tempdir := '/tmp/just'
 #              ^^^^^^^^^^^ string.quoted.single.just
 
 set windows-powershell
-#   ^^^^^^^^^^^^^^^^^^ entity.name.definition.just
+#   ^^^^^^^^^^^^^^^^^^ invalid.deprecated.just
 
 
 #
@@ -63,9 +63,8 @@ set windows-shell := ["powershell.exe", "-NoLogo", "-Command#nocomment"]
 
 set windows-powershell := true
 #^^ storage.modifier.definition.just
-#   ^^^^^^^^^^^^^^^^^^ entity.name.definition.just
-#                      ^^ keyword.operator.assignment.just
-#                         ^^^^ constant.language.boolean.just
+#   ^^^^^^^^^^^^^^^^^^ invalid.deprecated.just
+#                      ^^^^^^^ source.just
 
 
 #