@enjoys/context-engine 1.1.1 → 1.2.0

package/data/semanticTokens/zsh.json

@@ -0,0 +1,71 @@
+{
+  "language": "zsh",
+  "tokenTypes": ["namespace", "type", "class", "enum", "interface", "struct", "typeParameter", "parameter", "variable", "property", "enumMember", "event", "function", "method", "macro", "keyword", "modifier", "comment", "string", "number", "regexp", "operator", "decorator"],
+  "tokenModifiers": ["declaration", "definition", "readonly", "static", "deprecated", "abstract", "async", "modification", "documentation", "defaultLibrary"],
+  "tokenLegend": {
+    "tokenTypes": ["variable", "parameter", "function", "keyword", "comment", "string", "number", "operator"],
+    "tokenModifiers": ["declaration", "definition", "readonly", "defaultLibrary"]
+  },
+  "semanticRules": [
+    {
+      "type": "function",
+      "pattern": "\\bfunction\\s+([a-zA-Z_][a-zA-Z0-9_]*)\\b|([a-zA-Z_][a-zA-Z0-9_]*)\\s*\\(\\s*\\)\\s*\\{",
+      "modifiers": ["declaration"],
+      "description": "Function declarations"
+    },
+    {
+      "type": "variable",
+      "pattern": "\\$\\{([a-zA-Z_][a-zA-Z0-9_]*)([:#%/=^,@][^}]*)?\\}",
+      "modifiers": [],
+      "description": "Variable expansion with parameter substitution"
+    },
+    {
+      "type": "variable",
+      "pattern": "\\$([a-zA-Z_][a-zA-Z0-9_]*)",
+      "modifiers": [],
+      "description": "Simple variable references"
+    },
+    {
+      "type": "function",
+      "pattern": "\\b(autoload|zmodload|zstyle|zle|bindkey|compdef|compadd|compctl|zformat|zparseopts|zstat)\\b",
+      "modifiers": ["defaultLibrary"],
+      "description": "Zsh-specific builtins including autoload and zstyle"
+    },
+    {
+      "type": "function",
+      "pattern": "\\b(echo|print|printf|cd|pushd|popd|export|source|eval|exec|trap|wait|kill|exit|return|shift|unset|set|setopt|unsetopt|typeset|local|integer|float|declare|readonly|hash|unhash|whence|where|which)\\b",
+      "modifiers": ["defaultLibrary"],
+      "description": "Shell builtins and zsh extensions"
+    },
+    {
+      "type": "keyword",
+      "pattern": "\\b(if|then|else|elif|fi|for|while|until|do|done|case|esac|in|select|repeat|foreach|end|coproc)\\b",
+      "modifiers": [],
+      "description": "Control flow keywords including zsh-specific ones"
+    },
+    {
+      "type": "variable",
+      "pattern": "\\$(\\?|\\$|!|#|@|\\*|-|0|[1-9]|REPLY|reply|MATCH|match|MBEGIN|MEND|ZSH_VERSION|HISTFILE|HISTSIZE|SAVEHIST|ZDOTDIR|FPATH|fpath|path|PATH)",
+      "modifiers": ["readonly", "defaultLibrary"],
+      "description": "Special variables including zsh-specific ones"
+    },
+    {
+      "type": "operator",
+      "pattern": "(\\(\\#|\\(\\(|\\)\\)|\\[\\[|\\]\\]|\\|\\||&&|;;|;\\||&!|&\\||>>|<<|<>|>!|>&|<&)",
+      "modifiers": [],
+      "description": "Zsh operators and redirections"
+    },
+    {
+      "type": "keyword",
+      "pattern": "\\(\\*\\)|\\(@\\)|\\(\\.|\\(\\^|\\(/|\\(f|\\(\\+|\\(-|\\(r|\\(w|\\(x|\\(L|\\(N|\\(D|\\(om|\\(on",
+      "modifiers": [],
+      "description": "Glob qualifiers for filename generation"
+    },
+    {
+      "type": "comment",
+      "pattern": "#[^\\n]*",
+      "modifiers": [],
+      "description": "Line comments starting with #"
+    }
+  ]
+}

package/data/signatureHelp/abap.json

@@ -0,0 +1,98 @@
+{
+  "language": "abap",
+  "triggerCharacters": ["(", ","],
+  "retriggerCharacters": [","],
+  "signatures": [
+    {
+      "label": "WRITE output TO destination",
+      "documentation": { "value": "Writes data to the list output.\n```abap\nWRITE: / 'Hello World'.\nWRITE lv_variable TO lv_string.\n```" },
+      "parameters": [
+        { "label": "output", "documentation": { "value": "The data object or literal to be written to the output list." } },
+        { "label": "destination", "documentation": { "value": "Optional target variable to write formatted output into." } }
+      ]
+    },
+    {
+      "label": "READ TABLE itab INTO wa WITH KEY key = value",
+      "documentation": { "value": "Reads a single entry from an internal table.\n```abap\nREAD TABLE lt_data INTO ls_data WITH KEY id = 1.\nREAD TABLE lt_data INTO ls_data INDEX 1.\n```" },
+      "parameters": [
+        { "label": "itab", "documentation": { "value": "The internal table to read from." } },
+        { "label": "wa", "documentation": { "value": "The work area (structure) receiving the read entry." } },
+        { "label": "key = value", "documentation": { "value": "The key field and value used to find the entry." } }
+      ]
+    },
+    {
+      "label": "APPEND wa TO itab",
+      "documentation": { "value": "Appends a line to the end of an internal table.\n```abap\nAPPEND ls_line TO lt_table.\nAPPEND INITIAL LINE TO lt_table.\n```" },
+      "parameters": [
+        { "label": "wa", "documentation": { "value": "The work area (structure) to append." } },
+        { "label": "itab", "documentation": { "value": "The target internal table." } }
+      ]
+    },
+    {
+      "label": "CALL FUNCTION func EXPORTING p1 = v1 IMPORTING p2 = v2 TABLES t1 = it1 EXCEPTIONS ex1 = 1",
+      "documentation": { "value": "Calls a remote or local function module.\n```abap\nCALL FUNCTION 'BAPI_USER_GET_DETAIL'\n  EXPORTING username = lv_user\n  IMPORTING address = ls_address.\n```" },
+      "parameters": [
+        { "label": "func", "documentation": { "value": "Name of the function module to call (string literal or variable)." } },
+        { "label": "p1 = v1", "documentation": { "value": "EXPORTING parameters passed to the function module." } },
+        { "label": "p2 = v2", "documentation": { "value": "IMPORTING parameters received from the function module." } },
+        { "label": "t1 = it1", "documentation": { "value": "TABLES parameters for internal table exchange." } },
+        { "label": "ex1 = 1", "documentation": { "value": "EXCEPTIONS mapping for error handling." } }
+      ]
+    },
+    {
+      "label": "SELECT fields FROM dbtab INTO target WHERE condition",
+      "documentation": { "value": "Reads data from a database table using Open SQL.\n```abap\nSELECT * FROM mara INTO TABLE lt_mara WHERE matnr = lv_matnr.\nSELECT SINGLE * FROM mara INTO ls_mara WHERE matnr = lv_matnr.\n```" },
+      "parameters": [
+        { "label": "fields", "documentation": { "value": "Fields to select (* for all, or a comma-separated list)." } },
+        { "label": "dbtab", "documentation": { "value": "The database table or view to read from." } },
+        { "label": "target", "documentation": { "value": "Target variable, structure, or internal table for results." } },
+        { "label": "condition", "documentation": { "value": "WHERE clause filtering conditions." } }
+      ]
+    },
+    {
+      "label": "LOOP AT itab INTO wa WHERE condition",
+      "documentation": { "value": "Iterates over the lines of an internal table.\n```abap\nLOOP AT lt_data INTO ls_data WHERE status = 'A'.\n  \" process ls_data\nENDLOOP.\n```" },
+      "parameters": [
+        { "label": "itab", "documentation": { "value": "The internal table to iterate over." } },
+        { "label": "wa", "documentation": { "value": "Work area receiving each table line." } },
+        { "label": "condition", "documentation": { "value": "Optional WHERE condition to filter rows during iteration." } }
+      ]
+    },
+    {
+      "label": "CLEAR variable",
+      "documentation": { "value": "Resets a data object to its type-specific initial value.\n```abap\nCLEAR lv_string.\nCLEAR lt_table.\nCLEAR ls_structure.\n```" },
+      "parameters": [
+        { "label": "variable", "documentation": { "value": "The data object to reset (variable, structure, or internal table)." } }
+      ]
+    },
+    {
+      "label": "CONDENSE string NO-GAPS",
+      "documentation": { "value": "Removes leading/trailing spaces and compresses sequences of spaces.\n```abap\nCONDENSE lv_text.\nCONDENSE lv_text NO-GAPS.\n```" },
+      "parameters": [
+        { "label": "string", "documentation": { "value": "The character-type variable to condense." } },
+        { "label": "NO-GAPS", "documentation": { "value": "Optional addition to remove all spaces, not just leading/trailing." } }
+      ]
+    },
+    {
+      "label": "SUM",
+      "documentation": { "value": "Calculates the sum of numeric fields in the current control level during LOOP AT with AT.\n```abap\nLOOP AT lt_data INTO ls_data.\n  AT END OF group.\n    SUM.\n    WRITE: / ls_data-amount.\n  ENDAT.\nENDLOOP.\n```" },
+      "parameters": []
+    },
+    {
+      "label": "STRLEN( string ): integer",
+      "documentation": { "value": "Returns the length of a string (number of characters).\n```abap\nDATA(lv_len) = strlen( lv_text ).\n```" },
+      "parameters": [
+        { "label": "string", "documentation": { "value": "The character-type data object whose length is returned." } }
+      ]
+    },
+    {
+      "label": "CONCATENATE s1 s2 ... INTO result SEPARATED BY sep",
+      "documentation": { "value": "Concatenates multiple character strings into one.\n```abap\nCONCATENATE lv_first lv_last INTO lv_name SEPARATED BY ' '.\n```" },
+      "parameters": [
+        { "label": "s1 s2 ...", "documentation": { "value": "Two or more source strings to join." } },
+        { "label": "result", "documentation": { "value": "Target variable receiving the concatenated result." } },
+        { "label": "sep", "documentation": { "value": "Optional separator inserted between each source string." } }
+      ]
+    }
+  ]
+}

package/data/signatureHelp/apex.json

@@ -0,0 +1,84 @@
+{
+  "language": "apex",
+  "triggerCharacters": ["(", ","],
+  "retriggerCharacters": [","],
+  "signatures": [
+    {
+      "label": "System.debug(logLevel, msg): void",
+      "documentation": { "value": "Writes a message to the debug log.\n```apex\nSystem.debug('Hello');\nSystem.debug(LoggingLevel.ERROR, 'Error occurred');\n```" },
+      "parameters": [
+        { "label": "logLevel", "documentation": { "value": "Optional `LoggingLevel` enum value (ERROR, WARN, INFO, DEBUG, FINE, FINER, FINEST)." } },
+        { "label": "msg", "documentation": { "value": "The object or string to write to the debug log." } }
+      ]
+    },
+    {
+      "label": "String.valueOf(obj): String",
+      "documentation": { "value": "Returns the string representation of the specified object.\n```apex\nString s = String.valueOf(42);\nString s2 = String.valueOf(Date.today());\n```" },
+      "parameters": [
+        { "label": "obj", "documentation": { "value": "The object to convert to a String." } }
+      ]
+    },
+    {
+      "label": "Date.newInstance(year, month, day): Date",
+      "documentation": { "value": "Constructs a Date from integer year, month, and day values.\n```apex\nDate d = Date.newInstance(2024, 1, 15);\n```" },
+      "parameters": [
+        { "label": "year", "documentation": { "value": "The year component (Integer)." } },
+        { "label": "month", "documentation": { "value": "The month component, 1-12 (Integer)." } },
+        { "label": "day", "documentation": { "value": "The day component (Integer)." } }
+      ]
+    },
+    {
+      "label": "Math.max(a, b): Decimal",
+      "documentation": { "value": "Returns the larger of two values.\n```apex\nDecimal result = Math.max(10, 20); // 20\n```" },
+      "parameters": [
+        { "label": "a", "documentation": { "value": "First numeric value (Decimal, Double, Integer, or Long)." } },
+        { "label": "b", "documentation": { "value": "Second numeric value." } }
+      ]
+    },
+    {
+      "label": "List.add(element): Boolean",
+      "documentation": { "value": "Adds an element to the end of the list.\n```apex\nList<String> names = new List<String>();\nnames.add('Alice');\n```" },
+      "parameters": [
+        { "label": "element", "documentation": { "value": "The element to add to the list." } }
+      ]
+    },
+    {
+      "label": "Map.put(key, value): Object",
+      "documentation": { "value": "Associates the specified value with the specified key in the map.\n```apex\nMap<String, Integer> m = new Map<String, Integer>();\nm.put('count', 5);\n```" },
+      "parameters": [
+        { "label": "key", "documentation": { "value": "The key with which the value is to be associated." } },
+        { "label": "value", "documentation": { "value": "The value to be associated with the key." } }
+      ]
+    },
+    {
+      "label": "Database.query(queryString): List<sObject>",
+      "documentation": { "value": "Executes a dynamic SOQL query and returns a list of sObjects.\n```apex\nList<Account> accts = Database.query('SELECT Id, Name FROM Account LIMIT 10');\n```" },
+      "parameters": [
+        { "label": "queryString", "documentation": { "value": "A valid SOQL query string." } }
+      ]
+    },
+    {
+      "label": "String.format(template, args): String",
+      "documentation": { "value": "Returns a string with the arguments substituted into the template.\n```apex\nString msg = String.format('Hello {0}, you have {1} items', new List<String>{'Alice', '5'});\n```" },
+      "parameters": [
+        { "label": "template", "documentation": { "value": "A template string with `{0}`, `{1}`, etc. placeholders." } },
+        { "label": "args", "documentation": { "value": "A `List<String>` of substitution values." } }
+      ]
+    },
+    {
+      "label": "JSON.serialize(obj): String",
+      "documentation": { "value": "Serializes an Apex object into a JSON string.\n```apex\nAccount a = new Account(Name='Acme');\nString jsonStr = JSON.serialize(a);\n```" },
+      "parameters": [
+        { "label": "obj", "documentation": { "value": "The Apex object to serialize." } }
+      ]
+    },
+    {
+      "label": "JSON.deserialize(jsonString, apexType): Object",
+      "documentation": { "value": "Deserializes a JSON string into an Apex object of the specified type.\n```apex\nAccount a = (Account) JSON.deserialize(jsonStr, Account.class);\n```" },
+      "parameters": [
+        { "label": "jsonString", "documentation": { "value": "The JSON string to deserialize." } },
+        { "label": "apexType", "documentation": { "value": "The Apex type to deserialize into (e.g. `Account.class`)." } }
+      ]
+    }
+  ]
+}

package/data/signatureHelp/awk.json

@@ -0,0 +1,102 @@
+{
+  "language": "awk",
+  "triggerCharacters": ["(", ","],
+  "retriggerCharacters": [","],
+  "signatures": [
+    {
+      "label": "print expr1, expr2, ...",
+      "documentation": { "value": "Prints one or more expressions to standard output, separated by OFS, terminated by ORS.\n```awk\nprint $1, $2\nprint \"Total:\", sum\n```" },
+      "parameters": [
+        { "label": "expr1, expr2, ...", "documentation": { "value": "One or more expressions to print, separated by commas (OFS)." } }
+      ]
+    },
+    {
+      "label": "split(string, array, separator): int",
+      "documentation": { "value": "Splits `string` into pieces separated by `separator` and stores in `array`. Returns the number of pieces.\n```awk\nn = split(\"a:b:c\", arr, \":\")\n# arr[1]=\"a\", arr[2]=\"b\", arr[3]=\"c\", n=3\n```" },
+      "parameters": [
+        { "label": "string", "documentation": { "value": "The input string to split." } },
+        { "label": "array", "documentation": { "value": "The array to store the resulting pieces." } },
+        { "label": "separator", "documentation": { "value": "The field separator regex or string. Defaults to FS if omitted." } }
+      ]
+    },
+    {
+      "label": "sub(regexp, replacement, target): int",
+      "documentation": { "value": "Substitutes the first occurrence of `regexp` in `target` with `replacement`. Returns 1 if substitution made, 0 otherwise.\n```awk\nsub(/old/, \"new\", $0)\n```" },
+      "parameters": [
+        { "label": "regexp", "documentation": { "value": "The regular expression pattern to match." } },
+        { "label": "replacement", "documentation": { "value": "The replacement string. Use `&` to reference the matched text." } },
+        { "label": "target", "documentation": { "value": "The target string variable. Defaults to `$0` if omitted." } }
+      ]
+    },
+    {
+      "label": "gsub(regexp, replacement, target): int",
+      "documentation": { "value": "Globally substitutes all occurrences of `regexp` in `target` with `replacement`. Returns the number of substitutions.\n```awk\ngsub(/[[:space:]]/, \"_\", $0)\n```" },
+      "parameters": [
+        { "label": "regexp", "documentation": { "value": "The regular expression pattern to match." } },
+        { "label": "replacement", "documentation": { "value": "The replacement string. Use `&` to reference the matched text." } },
+        { "label": "target", "documentation": { "value": "The target string variable. Defaults to `$0` if omitted." } }
+      ]
+    },
+    {
+      "label": "length(s): int",
+      "documentation": { "value": "Returns the length of string `s`, or the number of elements in an array.\n```awk\nlen = length(\"hello\")  # 5\nlen = length(arr)       # number of elements\n```" },
+      "parameters": [
+        { "label": "s", "documentation": { "value": "A string or array. If omitted, uses `$0`." } }
+      ]
+    },
+    {
+      "label": "tolower(string): string",
+      "documentation": { "value": "Returns a copy of `string` with all uppercase characters converted to lowercase.\n```awk\nprint tolower(\"HELLO\")  # \"hello\"\n```" },
+      "parameters": [
+        { "label": "string", "documentation": { "value": "The input string to convert." } }
+      ]
+    },
+    {
+      "label": "toupper(string): string",
+      "documentation": { "value": "Returns a copy of `string` with all lowercase characters converted to uppercase.\n```awk\nprint toupper(\"hello\")  # \"HELLO\"\n```" },
+      "parameters": [
+        { "label": "string", "documentation": { "value": "The input string to convert." } }
+      ]
+    },
+    {
+      "label": "index(string, target): int",
+      "documentation": { "value": "Returns the position of the first occurrence of `target` in `string`, or 0 if not found.\n```awk\npos = index(\"hello world\", \"world\")  # 7\n```" },
+      "parameters": [
+        { "label": "string", "documentation": { "value": "The string to search in." } },
+        { "label": "target", "documentation": { "value": "The substring to search for." } }
+      ]
+    },
+    {
+      "label": "match(string, regexp): int",
+      "documentation": { "value": "Searches `string` for the longest leftmost match of `regexp`. Sets RSTART and RLENGTH. Returns RSTART or 0.\n```awk\nif (match($0, /[0-9]+/)) print substr($0, RSTART, RLENGTH)\n```" },
+      "parameters": [
+        { "label": "string", "documentation": { "value": "The string to search in." } },
+        { "label": "regexp", "documentation": { "value": "The regular expression pattern to match." } }
+      ]
+    },
+    {
+      "label": "sprintf(format, expr1, expr2, ...): string",
+      "documentation": { "value": "Returns a string formatted according to `format` (printf-style), without printing.\n```awk\ns = sprintf(\"%05d\", 42)       # \"00042\"\ns = sprintf(\"%-10s %d\", name, age)\n```" },
+      "parameters": [
+        { "label": "format", "documentation": { "value": "A printf-style format string (`%d`, `%s`, `%f`, etc.)." } },
+        { "label": "expr1, expr2, ...", "documentation": { "value": "Values to substitute into the format string." } }
+      ]
+    },
+    {
+      "label": "substr(string, start, length): string",
+      "documentation": { "value": "Returns a substring of `string` starting at position `start` (1-based) with optional `length`.\n```awk\ns = substr(\"hello\", 2, 3)  # \"ell\"\ns = substr(\"hello\", 2)     # \"ello\"\n```" },
+      "parameters": [
+        { "label": "string", "documentation": { "value": "The source string." } },
+        { "label": "start", "documentation": { "value": "Starting position (1-based)." } },
+        { "label": "length", "documentation": { "value": "Optional number of characters to extract. If omitted, returns to end of string." } }
+      ]
+    },
+    {
+      "label": "system(command): int",
+      "documentation": { "value": "Executes `command` as a shell command and returns its exit status.\n```awk\nsystem(\"ls -la\")\nret = system(\"mkdir -p output\")\n```" },
+      "parameters": [
+        { "label": "command", "documentation": { "value": "The shell command string to execute." } }
+      ]
+    }
+  ]
+}

package/data/signatureHelp/azcli.json

@@ -0,0 +1,88 @@
+{
+  "language": "azcli",
+  "triggerCharacters": [" ", "-"],
+  "retriggerCharacters": [" "],
+  "signatures": [
+    {
+      "label": "az group create --name <name> --location <location> [--tags]",
+      "documentation": { "value": "Creates a new resource group.\n```bash\naz group create --name myRG --location eastus\naz group create --name myRG --location westus2 --tags env=dev\n```" },
+      "parameters": [
+        { "label": "--name", "documentation": { "value": "Name of the new resource group." } },
+        { "label": "--location", "documentation": { "value": "Azure region (e.g. `eastus`, `westus2`, `northeurope`)." } },
+        { "label": "--tags", "documentation": { "value": "Optional space-separated tags in `key=value` format." } }
+      ]
+    },
+    {
+      "label": "az vm create --resource-group <rg> --name <name> --image <image> [--size] [--admin-username] [--generate-ssh-keys]",
+      "documentation": { "value": "Creates a new virtual machine.\n```bash\naz vm create --resource-group myRG --name myVM --image Ubuntu2204 --size Standard_B1s --admin-username azureuser --generate-ssh-keys\n```" },
+      "parameters": [
+        { "label": "--resource-group", "documentation": { "value": "Name of the resource group." } },
+        { "label": "--name", "documentation": { "value": "Name of the virtual machine." } },
+        { "label": "--image", "documentation": { "value": "OS image URN or alias (e.g. `Ubuntu2204`, `Win2019Datacenter`)." } },
+        { "label": "--size", "documentation": { "value": "Optional VM size (e.g. `Standard_B1s`, `Standard_D2s_v3`)." } },
+        { "label": "--admin-username", "documentation": { "value": "Administrator username for the VM." } },
+        { "label": "--generate-ssh-keys", "documentation": { "value": "Generate SSH public and private key files if they don't exist." } }
+      ]
+    },
+    {
+      "label": "az storage account create --name <name> --resource-group <rg> --location <location> --sku <sku>",
+      "documentation": { "value": "Creates a new storage account.\n```bash\naz storage account create --name mystorageacct --resource-group myRG --location eastus --sku Standard_LRS\n```" },
+      "parameters": [
+        { "label": "--name", "documentation": { "value": "Globally unique storage account name (3-24 lowercase letters/digits)." } },
+        { "label": "--resource-group", "documentation": { "value": "Name of the resource group." } },
+        { "label": "--location", "documentation": { "value": "Azure region." } },
+        { "label": "--sku", "documentation": { "value": "Storage SKU: `Standard_LRS`, `Standard_GRS`, `Standard_ZRS`, `Premium_LRS`." } }
+      ]
+    },
+    {
+      "label": "az webapp create --resource-group <rg> --plan <plan> --name <name> [--runtime]",
+      "documentation": { "value": "Creates a new web app.\n```bash\naz webapp create --resource-group myRG --plan myPlan --name myApp --runtime \"NODE:18-lts\"\n```" },
+      "parameters": [
+        { "label": "--resource-group", "documentation": { "value": "Name of the resource group." } },
+        { "label": "--plan", "documentation": { "value": "Name of the App Service plan." } },
+        { "label": "--name", "documentation": { "value": "Globally unique name for the web app." } },
+        { "label": "--runtime", "documentation": { "value": "Optional runtime stack (e.g. `\"NODE:18-lts\"`, `\"PYTHON:3.11\"`)." } }
+      ]
+    },
+    {
+      "label": "az keyvault create --name <name> --resource-group <rg> --location <location> [--sku]",
+      "documentation": { "value": "Creates a new Azure Key Vault.\n```bash\naz keyvault create --name myVault --resource-group myRG --location eastus\n```" },
+      "parameters": [
+        { "label": "--name", "documentation": { "value": "Globally unique name for the key vault." } },
+        { "label": "--resource-group", "documentation": { "value": "Name of the resource group." } },
+        { "label": "--location", "documentation": { "value": "Azure region." } },
+        { "label": "--sku", "documentation": { "value": "Optional SKU: `standard` (default) or `premium`." } }
+      ]
+    },
+    {
+      "label": "az account set --subscription <subscription>",
+      "documentation": { "value": "Sets the current active subscription.\n```bash\naz account set --subscription \"My Subscription\"\naz account set --subscription 12345678-abcd-efgh-ijkl-123456789012\n```" },
+      "parameters": [
+        { "label": "--subscription", "documentation": { "value": "Subscription name or ID to set as active." } }
+      ]
+    },
+    {
+      "label": "az login [--use-device-code] [--tenant]",
+      "documentation": { "value": "Logs in to Azure.\n```bash\naz login\naz login --use-device-code\naz login --tenant myorg.onmicrosoft.com\n```" },
+      "parameters": [
+        { "label": "--use-device-code", "documentation": { "value": "Use device code flow for environments without a browser." } },
+        { "label": "--tenant", "documentation": { "value": "Optional Azure AD tenant domain or ID." } }
+      ]
+    },
+    {
+      "label": "az logout [--username]",
+      "documentation": { "value": "Logs out and removes access to Azure subscriptions.\n```bash\naz logout\naz logout --username user@example.com\n```" },
+      "parameters": [
+        { "label": "--username", "documentation": { "value": "Optional specific account to log out." } }
+      ]
+    },
+    {
+      "label": "az configure [--defaults] [--scope]",
+      "documentation": { "value": "Manages Azure CLI configuration including default values.\n```bash\naz configure --defaults group=myRG location=eastus\naz configure --defaults web=myApp\n```" },
+      "parameters": [
+        { "label": "--defaults", "documentation": { "value": "Space-separated defaults in `key=value` format (e.g. `group=myRG`)." } },
+        { "label": "--scope", "documentation": { "value": "Scope of defaults: `global` (default) or `local`." } }
+      ]
+    }
+  ]
+}

package/data/signatureHelp/bash.json

@@ -0,0 +1,111 @@
+{
+  "language": "bash",
+  "triggerCharacters": ["(", ",", " "],
+  "retriggerCharacters": [" "],
+  "signatures": [
+    {
+      "label": "echo [-n] [-e] [string ...]",
+      "documentation": { "value": "Outputs the given strings to standard output.\n```bash\necho \"Hello World\"\necho -n \"No newline\"\necho -e \"Line1\\nLine2\"\n```" },
+      "parameters": [
+        { "label": "-n", "documentation": { "value": "Do not output the trailing newline." } },
+        { "label": "-e", "documentation": { "value": "Enable interpretation of backslash escapes (`\\n`, `\\t`, etc.)." } },
+        { "label": "string ...", "documentation": { "value": "One or more strings to output." } }
+      ]
+    },
+    {
+      "label": "read [-r] [-p prompt] [-t timeout] [-d delim] [name ...]",
+      "documentation": { "value": "Reads a line of input and splits it into variables.\n```bash\nread -p \"Enter name: \" name\nread -r line < file.txt\nread -t 5 -p \"Quick! \" answer\n```" },
+      "parameters": [
+        { "label": "-r", "documentation": { "value": "Do not treat backslashes as escape characters." } },
+        { "label": "-p prompt", "documentation": { "value": "Display `prompt` before reading input (without trailing newline)." } },
+        { "label": "-t timeout", "documentation": { "value": "Time out and return failure after `timeout` seconds." } },
+        { "label": "-d delim", "documentation": { "value": "Use `delim` as the line delimiter instead of newline." } },
+        { "label": "name ...", "documentation": { "value": "Variable name(s) to assign input to. Defaults to `REPLY` if omitted." } }
+      ]
+    },
+    {
+      "label": "printf format [arguments ...]",
+      "documentation": { "value": "Formats and prints data according to a format string.\n```bash\nprintf \"%s is %d years old\\n\" \"Alice\" 30\nprintf \"%05d\\n\" 42\n```" },
+      "parameters": [
+        { "label": "format", "documentation": { "value": "A format string using `%s` (string), `%d` (integer), `%f` (float), `%x` (hex), etc." } },
+        { "label": "arguments ...", "documentation": { "value": "Arguments to substitute into the format string." } }
+      ]
+    },
+    {
+      "label": "test expression / [ expression ]",
+      "documentation": { "value": "Evaluates a conditional expression and returns 0 (true) or 1 (false).\n```bash\ntest -f /etc/passwd && echo \"File exists\"\n[ -d /tmp ] && echo \"Directory exists\"\n[ \"$a\" = \"$b\" ] && echo \"Equal\"\n```" },
+      "parameters": [
+        { "label": "expression", "documentation": { "value": "A conditional expression: `-f file`, `-d dir`, `-z string`, `-n string`, `s1 = s2`, `n1 -eq n2`, etc." } }
+      ]
+    },
+    {
+      "label": "declare [-a] [-A] [-i] [-r] [-x] [name[=value] ...]",
+      "documentation": { "value": "Declares variables and sets attributes.\n```bash\ndeclare -i num=42\ndeclare -a arr=(1 2 3)\ndeclare -A map=([key1]=val1 [key2]=val2)\ndeclare -r CONST=\"immutable\"\n```" },
+      "parameters": [
+        { "label": "-a", "documentation": { "value": "Declare an indexed array variable." } },
+        { "label": "-A", "documentation": { "value": "Declare an associative array variable." } },
+        { "label": "-i", "documentation": { "value": "Give the variable the integer attribute." } },
+        { "label": "-r", "documentation": { "value": "Make the variable readonly." } },
+        { "label": "-x", "documentation": { "value": "Mark the variable for export to child processes." } },
+        { "label": "name[=value]", "documentation": { "value": "Variable name with optional initial value." } }
+      ]
+    },
+    {
+      "label": "local [name[=value] ...]",
+      "documentation": { "value": "Creates a local variable within a function.\n```bash\nmy_func() {\n  local name=\"Alice\"\n  local -i count=0\n  echo \"$name\"\n}\n```" },
+      "parameters": [
+        { "label": "name[=value]", "documentation": { "value": "Variable name with optional initial value, scoped to the current function." } }
+      ]
+    },
+    {
+      "label": "export [-n] [name[=value] ...]",
+      "documentation": { "value": "Marks variables for export to child processes.\n```bash\nexport PATH=\"/usr/local/bin:$PATH\"\nexport MY_VAR=\"hello\"\nexport -n MY_VAR  # unexport\n```" },
+      "parameters": [
+        { "label": "-n", "documentation": { "value": "Remove the export property from the variable." } },
+        { "label": "name[=value]", "documentation": { "value": "Variable name with optional value to export." } }
+      ]
+    },
+    {
+      "label": "source filename [arguments]",
+      "documentation": { "value": "Reads and executes commands from `filename` in the current shell.\n```bash\nsource ~/.bashrc\nsource ./config.sh arg1 arg2\n. ./env.sh\n```" },
+      "parameters": [
+        { "label": "filename", "documentation": { "value": "The file to source (execute in current shell)." } },
+        { "label": "arguments", "documentation": { "value": "Optional positional parameters passed to the sourced script." } }
+      ]
+    },
+    {
+      "label": "trap [-l] [action] [signal ...]",
+      "documentation": { "value": "Defines actions to execute when the shell receives a signal.\n```bash\ntrap 'echo Interrupted; exit' INT TERM\ntrap 'rm -f /tmp/lockfile' EXIT\ntrap '' SIGINT  # ignore SIGINT\n```" },
+      "parameters": [
+        { "label": "action", "documentation": { "value": "Command string to execute when signal is received. Use `''` to ignore, `-` to reset." } },
+        { "label": "signal ...", "documentation": { "value": "One or more signal names or numbers: `EXIT`, `INT`, `TERM`, `HUP`, `ERR`, `DEBUG`, etc." } }
+      ]
+    },
+    {
+      "label": "set [-e] [-u] [-x] [-o option]",
+      "documentation": { "value": "Sets or unsets shell options and positional parameters.\n```bash\nset -euo pipefail\nset -x  # enable debug tracing\nset +x  # disable debug tracing\n```" },
+      "parameters": [
+        { "label": "-e", "documentation": { "value": "Exit immediately if a command exits with non-zero status." } },
+        { "label": "-u", "documentation": { "value": "Treat unset variables as an error." } },
+        { "label": "-x", "documentation": { "value": "Print each command before executing (debug mode)." } },
+        { "label": "-o option", "documentation": { "value": "Set option by name: `pipefail`, `noclobber`, `nounset`, etc." } }
+      ]
+    },
+    {
+      "label": "shift [n]",
+      "documentation": { "value": "Shifts positional parameters to the left by `n` (default 1).\n```bash\nwhile [ \"$#\" -gt 0 ]; do\n  echo \"$1\"\n  shift\ndone\n```" },
+      "parameters": [
+        { "label": "n", "documentation": { "value": "Number of positions to shift. Defaults to 1." } }
+      ]
+    },
+    {
+      "label": "getopts optstring name [args]",
+      "documentation": { "value": "Parses positional parameters as options.\n```bash\nwhile getopts \"hf:v\" opt; do\n  case $opt in\n    h) usage ;;\n    f) file=\"$OPTARG\" ;;\n    v) verbose=1 ;;\n  esac\ndone\n```" },
+      "parameters": [
+        { "label": "optstring", "documentation": { "value": "A string of option characters. A colon after a character means it takes an argument (e.g. `\"f:v\"`)." } },
+        { "label": "name", "documentation": { "value": "Variable name to store the current option character." } },
+        { "label": "args", "documentation": { "value": "Optional arguments to parse instead of positional parameters." } }
+      ]
+    }
+  ]
+}