@enjoys/context-engine 1.3.1 → 1.4.2

package/data/definition/shell.json

@@ -90,6 +90,826 @@
       "description": "Declares variables with specific attributes such as -i for integer, -a for indexed array, -A for associative array, -r for readonly, and -x for export in bash scripts.",
       "type": "function",
       "module": "Builtins"
+    },
+    "cd": {
+      "signature": "cd [-L|-P] [directory]",
+      "description": "Change the shell working directory. With no arguments, changes to $HOME. `-L` follows symbolic links (default), `-P` uses the physical directory structure.",
+      "type": "builtin",
+      "module": "builtins"
+    },
+    "pwd": {
+      "signature": "pwd [-LP]",
+      "description": "Print the absolute pathname of the current working directory. `-L` shows the logical path (default), `-P` resolves symlinks.",
+      "type": "builtin",
+      "module": "builtins"
+    },
+    "alias": {
+      "signature": "alias [-p] [name[=value] ...]",
+      "description": "Define or display aliases. Without arguments, prints all aliases. With a name, prints that alias. With name=value, creates an alias.",
+      "type": "builtin",
+      "module": "builtins"
+    },
+    "unalias": {
+      "signature": "unalias [-a] name [name ...]",
+      "description": "Remove alias definitions. `-a` removes all aliases.",
+      "type": "builtin",
+      "module": "builtins"
+    },
+    "type": {
+      "signature": "type [-afptP] name [name ...]",
+      "description": "Indicate how each name would be interpreted if used as a command. `-t` prints a single word (alias, keyword, function, builtin, file). `-a` shows all matches.",
+      "type": "builtin",
+      "module": "builtins"
+    },
+    "exit": {
+      "signature": "exit [n]",
+      "description": "Exit the shell with status n. If n is omitted, the exit status is that of the last command executed. Values are modulo 256.",
+      "type": "builtin",
+      "module": "builtins"
+    },
+    "return": {
+      "signature": "return [n]",
+      "description": "Return from a shell function with return value n. If n is not supplied, the return value is the exit status of the last command executed in the function.",
+      "type": "builtin",
+      "module": "builtins"
+    },
+    "unset": {
+      "signature": "unset [-fv] [name ...]",
+      "description": "Remove variable or function definitions. `-v` removes variables (default), `-f` removes functions. If neither is given, tries variable first, then function.",
+      "type": "builtin",
+      "module": "builtins"
+    },
+    "readonly": {
+      "signature": "readonly [-aAf] [-p] [name[=value] ...]",
+      "description": "Mark variables as readonly, preventing reassignment or unsetting. `-a` for arrays, `-A` for associative arrays, `-f` for functions. `-p` displays all readonly variables.",
+      "type": "builtin",
+      "module": "builtins"
+    },
+    "[[": {
+      "signature": "[[ expression ]]",
+      "description": "Extended conditional command. Supports all test operators plus pattern matching (==, =~), logical operators (&&, ||, !), and grouping with parentheses. Word splitting and pathname expansion are not performed.",
+      "type": "keyword",
+      "module": "builtins"
+    },
+    "jobs": {
+      "signature": "jobs [-lnprs] [jobspec ...]",
+      "description": "Display status of background jobs. `-l` includes PIDs, `-p` shows PIDs only, `-r` shows running only, `-s` shows stopped only.",
+      "type": "builtin",
+      "module": "builtins"
+    },
+    "kill": {
+      "signature": "kill [-s sigspec] [-n signum] [-sigspec] pid|jobspec ...",
+      "description": "Send a signal to a process or job. Default signal is TERM. Common signals: HUP (1), INT (2), KILL (9), TERM (15), CONT (18), STOP (19).",
+      "type": "builtin",
+      "module": "builtins"
+    },
+    "bg": {
+      "signature": "bg [jobspec ...]",
+      "description": "Resume a suspended job in the background, as if it had been started with &.",
+      "type": "builtin",
+      "module": "builtins"
+    },
+    "fg": {
+      "signature": "fg [jobspec]",
+      "description": "Move a job to the foreground, making it the current job. The shell waits for the job to complete.",
+      "type": "builtin",
+      "module": "builtins"
+    },
+    "pushd": {
+      "signature": "pushd [-n] [+n|-n|dir]",
+      "description": "Add a directory to the top of the directory stack and change to it. `-n` suppresses the directory change.",
+      "type": "builtin",
+      "module": "builtins"
+    },
+    "popd": {
+      "signature": "popd [-n] [+n|-n]",
+      "description": "Remove the top entry from the directory stack and change to the new top. `-n` suppresses the directory change.",
+      "type": "builtin",
+      "module": "builtins"
+    },
+    "mapfile": {
+      "signature": "mapfile [-d delim] [-n count] [-O origin] [-s count] [-t] [-u fd] [-C callback] [-c quantum] [array]",
+      "description": "Read lines from stdin into an indexed array variable. `-t` removes trailing delimiter. `-n count` reads at most count lines. Default array is MAPFILE.",
+      "type": "builtin",
+      "module": "builtins"
+    },
+    "let": {
+      "signature": "let expression [expression ...]",
+      "description": "Evaluate arithmetic expressions. Returns 0 if the last expression evaluates to non-zero, 1 otherwise. Equivalent to ((expression)).",
+      "type": "builtin",
+      "module": "builtins"
+    },
+    "history": {
+      "signature": "history [-c] [-d offset] [n]  or  history -anrw [filename]",
+      "description": "Display or manipulate the command history list. `-c` clears history, `-d n` deletes entry at offset n, `-a` appends new entries to history file, `-r` reads history file.",
+      "type": "builtin",
+      "module": "builtins"
+    },
+    "complete": {
+      "signature": "complete [-abcdefgjksuv] [-o option] [-A action] [-G globpat] [-W wordlist] [-F function] [-C command] [-X filterpat] [-P prefix] [-S suffix] name [name ...]",
+      "description": "Specify programmable completion for a command. Defines how arguments to a specific command are completed when the user presses Tab.",
+      "type": "builtin",
+      "module": "builtins"
+    },
+    "compgen": {
+      "signature": "compgen [-abcdefgjksuv] [-o option] [-A action] [-G globpat] [-W wordlist] [-F function] [-C command] [-X filterpat] [-P prefix] [-S suffix] [word]",
+      "description": "Generate possible completion matches for word according to the specified options. Used within programmable completion functions.",
+      "type": "builtin",
+      "module": "builtins"
+    },
+    "enable": {
+      "signature": "enable [-a] [-dnps] [-f filename] [name ...]",
+      "description": "Enable or disable shell builtin commands. `-n` disables a builtin. `-a` lists all builtins showing enabled/disabled status.",
+      "type": "builtin",
+      "module": "builtins"
+    },
+    "shopt": {
+      "signature": "shopt [-pqsu] [-o] [optname ...]",
+      "description": "Set and unset shell optional behavior. `-s` enables, `-u` disables an option. Common options: extglob, globstar, nullglob, dotglob, nocasematch.",
+      "type": "builtin",
+      "module": "builtins"
+    },
+    "ulimit": {
+      "signature": "ulimit [-HSabcdefiklmnpqrstuvxPRT] [limit]",
+      "description": "Get or set user-level resource limits. `-n` for open files, `-u` for max processes, `-v` for virtual memory, `-s` for stack size.",
+      "type": "builtin",
+      "module": "builtins"
+    },
+    "umask": {
+      "signature": "umask [-p] [-S] [mode]",
+      "description": "Set the file creation mask. The mask is subtracted from the default permissions (777 for dirs, 666 for files). Common: `umask 022` (owner full, others read/execute).",
+      "type": "builtin",
+      "module": "builtins"
+    },
+    "$?": {
+      "signature": "$?",
+      "description": "The exit status of the most recently executed foreground pipeline. 0 typically indicates success, non-zero indicates failure.",
+      "type": "special_variable",
+      "module": "parameters"
+    },
+    "$#": {
+      "signature": "$#",
+      "description": "The number of positional parameters (arguments) passed to the script or function.",
+      "type": "special_variable",
+      "module": "parameters"
+    },
+    "$@": {
+      "signature": "$@",
+      "description": "All positional parameters as separate words. When double-quoted (\"$@\"), each parameter expands as a separate word, preserving whitespace.",
+      "type": "special_variable",
+      "module": "parameters"
+    },
+    "$*": {
+      "signature": "$*",
+      "description": "All positional parameters as a single word. When double-quoted (\"$*\"), expands to a single string with parameters separated by the first character of $IFS.",
+      "type": "special_variable",
+      "module": "parameters"
+    },
+    "$$": {
+      "signature": "$$",
+      "description": "The process ID (PID) of the current shell. In a subshell, it expands to the PID of the parent shell, not the subshell.",
+      "type": "special_variable",
+      "module": "parameters"
+    },
+    "$!": {
+      "signature": "$!",
+      "description": "The process ID of the most recently executed background (asynchronous) command or pipeline.",
+      "type": "special_variable",
+      "module": "parameters"
+    },
+    "$0": {
+      "signature": "$0",
+      "description": "The name of the shell or shell script. Set at shell startup. In a script, it is the filename used to invoke the script.",
+      "type": "special_variable",
+      "module": "parameters"
+    },
+    "$_": {
+      "signature": "$_",
+      "description": "The last argument of the previous command. At shell startup, set to the absolute pathname used to invoke the shell.",
+      "type": "special_variable",
+      "module": "parameters"
+    },
+    "$-": {
+      "signature": "$-",
+      "description": "The current option flags as specified on invocation, by the set builtin, or those set by the shell itself (e.g., -i for interactive).",
+      "type": "special_variable",
+      "module": "parameters"
+    },
+    "IFS": {
+      "signature": "IFS",
+      "description": "Internal Field Separator. Used for word splitting after expansion and by read to split lines into fields. Default value is space, tab, newline (<space><tab><newline>).",
+      "type": "variable",
+      "module": "parameters"
+    },
+    "PATH": {
+      "signature": "PATH",
+      "description": "A colon-separated list of directories in which the shell looks for commands. Searched left to right. Modifying PATH affects which programs the shell can find.",
+      "type": "variable",
+      "module": "parameters"
+    },
+    "HOME": {
+      "signature": "HOME",
+      "description": "The home directory of the current user. Set automatically at login. Used as the default argument for the cd builtin and for tilde (~) expansion.",
+      "type": "variable",
+      "module": "parameters"
+    },
+    "PWD": {
+      "signature": "PWD",
+      "description": "The current working directory as set by cd. Updated automatically when the directory changes.",
+      "type": "variable",
+      "module": "parameters"
+    },
+    "OLDPWD": {
+      "signature": "OLDPWD",
+      "description": "The previous working directory as set by cd. `cd -` changes to $OLDPWD.",
+      "type": "variable",
+      "module": "parameters"
+    },
+    "SHELL": {
+      "signature": "SHELL",
+      "description": "The pathname of the current user's login shell.",
+      "type": "variable",
+      "module": "parameters"
+    },
+    "USER": {
+      "signature": "USER",
+      "description": "The name of the current user. Typically set at login.",
+      "type": "variable",
+      "module": "parameters"
+    },
+    "HOSTNAME": {
+      "signature": "HOSTNAME",
+      "description": "The name of the current host. Set automatically at shell startup.",
+      "type": "variable",
+      "module": "parameters"
+    },
+    "RANDOM": {
+      "signature": "RANDOM",
+      "description": "Each time this parameter is referenced, it expands to a random integer between 0 and 32767. Assigning a value seeds the random number generator.",
+      "type": "variable",
+      "module": "parameters"
+    },
+    "SECONDS": {
+      "signature": "SECONDS",
+      "description": "The number of seconds since the shell was started. If assigned a value, returns the assigned value plus the number of seconds since the assignment.",
+      "type": "variable",
+      "module": "parameters"
+    },
+    "LINENO": {
+      "signature": "LINENO",
+      "description": "The line number in the script or shell function currently executing. Useful for debugging and error messages.",
+      "type": "variable",
+      "module": "parameters"
+    },
+    "FUNCNAME": {
+      "signature": "FUNCNAME",
+      "description": "An array variable containing the names of all shell functions currently in the execution call stack. ${FUNCNAME[0]} is the currently executing function.",
+      "type": "variable",
+      "module": "parameters"
+    },
+    "BASH_SOURCE": {
+      "signature": "BASH_SOURCE",
+      "description": "An array variable whose members are the source filenames corresponding to the elements in the FUNCNAME array. ${BASH_SOURCE[0]} is the current file.",
+      "type": "variable",
+      "module": "parameters"
+    },
+    "BASH_LINENO": {
+      "signature": "BASH_LINENO",
+      "description": "An array of line numbers corresponding to calls in FUNCNAME. ${BASH_LINENO[$i]} is the line number in ${BASH_SOURCE[$i+1]} where ${FUNCNAME[$i]} was called.",
+      "type": "variable",
+      "module": "parameters"
+    },
+    "PIPESTATUS": {
+      "signature": "PIPESTATUS",
+      "description": "An array containing the exit statuses of the processes in the most recently executed foreground pipeline. ${PIPESTATUS[0]} is the first command's exit status.",
+      "type": "variable",
+      "module": "parameters"
+    },
+    "OPTARG": {
+      "signature": "OPTARG",
+      "description": "Set by getopts to the value of the last option argument processed. Contains the argument when the option requires one.",
+      "type": "variable",
+      "module": "parameters"
+    },
+    "OPTIND": {
+      "signature": "OPTIND",
+      "description": "The index of the next argument to be processed by getopts. Initialized to 1 each time the shell or a script is invoked.",
+      "type": "variable",
+      "module": "parameters"
+    },
+    "REPLY": {
+      "signature": "REPLY",
+      "description": "Set by read when no variable names are supplied. Also set by select to the user's input.",
+      "type": "variable",
+      "module": "parameters"
+    },
+    "BASH_REMATCH": {
+      "signature": "BASH_REMATCH",
+      "description": "An array variable whose members are assigned by the =~ binary operator in [[ ]]. Element 0 is the entire match, elements 1+ are capture group matches.",
+      "type": "variable",
+      "module": "parameters"
+    },
+    "BASH_VERSION": {
+      "signature": "BASH_VERSION",
+      "description": "The version number of the current instance of Bash.",
+      "type": "variable",
+      "module": "parameters"
+    },
+    "EUID": {
+      "signature": "EUID",
+      "description": "The effective user ID of the current user. Read-only. 0 indicates root.",
+      "type": "variable",
+      "module": "parameters"
+    },
+    "UID": {
+      "signature": "UID",
+      "description": "The real user ID of the current user. Read-only.",
+      "type": "variable",
+      "module": "parameters"
+    },
+    "array": {
+      "signature": "name=(value1 value2 ...) or name[index]=value",
+      "description": "Indexed arrays hold ordered lists of values. Elements are accessed by integer index starting at 0. Supports ${arr[@]} (all elements), ${#arr[@]} (length), ${!arr[@]} (indices).",
+      "type": "datatype",
+      "module": "builtins",
+      "members": {
+        "[@]": {
+          "signature": "${array[@]}",
+          "description": "Expand to all elements of the array as separate words.",
+          "type": "expansion"
+        },
+        "[*]": {
+          "signature": "${array[*]}",
+          "description": "Expand to all elements as a single word joined by the first character of IFS.",
+          "type": "expansion"
+        },
+        "#": {
+          "signature": "${#array[@]}",
+          "description": "Return the number of elements in the array.",
+          "type": "expansion"
+        },
+        "!": {
+          "signature": "${!array[@]}",
+          "description": "Return all indices (keys) of the array.",
+          "type": "expansion"
+        },
+        "append": {
+          "signature": "array+=(value)",
+          "description": "Append one or more elements to the end of an indexed array.",
+          "type": "operation"
+        },
+        "slice": {
+          "signature": "${array[@]:offset:length}",
+          "description": "Extract a slice of the array starting at offset for length elements.",
+          "type": "expansion"
+        },
+        "unset_element": {
+          "signature": "unset 'array[index]'",
+          "description": "Remove a specific element from the array.",
+          "type": "operation"
+        }
+      }
+    },
+    "associative_array": {
+      "signature": "declare -A name=([key1]=value1 [key2]=value2 ...)",
+      "description": "Associative arrays use arbitrary strings as keys. Must be declared with `declare -A`. Supports ${map[@]}, ${!map[@]} (keys), ${#map[@]} (size).",
+      "type": "datatype",
+      "module": "builtins",
+      "members": {
+        "[@]": {
+          "signature": "${assoc[@]}",
+          "description": "Expand to all values.",
+          "type": "expansion"
+        },
+        "!keys": {
+          "signature": "${!assoc[@]}",
+          "description": "Expand to all keys of the associative array.",
+          "type": "expansion"
+        },
+        "#size": {
+          "signature": "${#assoc[@]}",
+          "description": "Return the number of key-value pairs.",
+          "type": "expansion"
+        },
+        "set": {
+          "signature": "assoc[key]=value",
+          "description": "Set or update a value for a given key.",
+          "type": "operation"
+        },
+        "unset_key": {
+          "signature": "unset 'assoc[key]'",
+          "description": "Remove a key-value pair.",
+          "type": "operation"
+        }
+      }
+    },
+    "string_operations": {
+      "signature": "${parameter...}",
+      "description": "Bash provides extensive string manipulation via parameter expansion. Includes substitution, default values, substring extraction, pattern removal, case modification, and length.",
+      "type": "datatype",
+      "module": "builtins",
+      "members": {
+        "length": {
+          "signature": "${#var}",
+          "description": "Length of the string stored in var.",
+          "type": "expansion"
+        },
+        "substring": {
+          "signature": "${var:offset:length}",
+          "description": "Extract substring starting at offset for length characters.",
+          "type": "expansion"
+        },
+        "default": {
+          "signature": "${var:-default}",
+          "description": "Use default if var is unset or null.",
+          "type": "expansion"
+        },
+        "assign_default": {
+          "signature": "${var:=default}",
+          "description": "Assign default to var if var is unset or null.",
+          "type": "expansion"
+        },
+        "alternate": {
+          "signature": "${var:+alternate}",
+          "description": "Use alternate if var IS set and non-null.",
+          "type": "expansion"
+        },
+        "error": {
+          "signature": "${var:?message}",
+          "description": "Display error message and exit if var is unset or null.",
+          "type": "expansion"
+        },
+        "prefix_short": {
+          "signature": "${var#pattern}",
+          "description": "Remove shortest leading match of pattern.",
+          "type": "expansion"
+        },
+        "prefix_long": {
+          "signature": "${var##pattern}",
+          "description": "Remove longest leading match of pattern.",
+          "type": "expansion"
+        },
+        "suffix_short": {
+          "signature": "${var%pattern}",
+          "description": "Remove shortest trailing match of pattern.",
+          "type": "expansion"
+        },
+        "suffix_long": {
+          "signature": "${var%%pattern}",
+          "description": "Remove longest trailing match of pattern.",
+          "type": "expansion"
+        },
+        "replace_first": {
+          "signature": "${var/pattern/replacement}",
+          "description": "Replace the first match of pattern with replacement.",
+          "type": "expansion"
+        },
+        "replace_all": {
+          "signature": "${var//pattern/replacement}",
+          "description": "Replace all matches of pattern with replacement.",
+          "type": "expansion"
+        },
+        "uppercase_first": {
+          "signature": "${var^}",
+          "description": "Convert first character to uppercase.",
+          "type": "expansion"
+        },
+        "uppercase_all": {
+          "signature": "${var^^}",
+          "description": "Convert all characters to uppercase.",
+          "type": "expansion"
+        },
+        "lowercase_first": {
+          "signature": "${var,}",
+          "description": "Convert first character to lowercase.",
+          "type": "expansion"
+        },
+        "lowercase_all": {
+          "signature": "${var,,}",
+          "description": "Convert all characters to lowercase.",
+          "type": "expansion"
+        }
+      }
+    },
+    "arithmetic": {
+      "signature": "$(( expression ))  or  (( expression ))  or  let expression",
+      "description": "Bash supports integer arithmetic using C-style expressions. Operators: + - * / % ** (power), ++ --, << >> & | ^ ~ (bitwise), && || ! (logical), ternary (?:), comma, and assignment operators (= += -= *= /= %= etc.).",
+      "type": "datatype",
+      "module": "builtins",
+      "members": {
+        "addition": {
+          "signature": "$((a + b))",
+          "description": "Addition of integers.",
+          "type": "operator"
+        },
+        "subtraction": {
+          "signature": "$((a - b))",
+          "description": "Subtraction of integers.",
+          "type": "operator"
+        },
+        "multiplication": {
+          "signature": "$((a * b))",
+          "description": "Multiplication of integers.",
+          "type": "operator"
+        },
+        "division": {
+          "signature": "$((a / b))",
+          "description": "Integer division (truncates toward zero).",
+          "type": "operator"
+        },
+        "modulo": {
+          "signature": "$((a % b))",
+          "description": "Remainder after integer division.",
+          "type": "operator"
+        },
+        "power": {
+          "signature": "$((a ** b))",
+          "description": "Exponentiation (a to the power of b).",
+          "type": "operator"
+        },
+        "increment": {
+          "signature": "$((a++))",
+          "description": "Post-increment a by 1.",
+          "type": "operator"
+        },
+        "decrement": {
+          "signature": "$((a--))",
+          "description": "Post-decrement a by 1.",
+          "type": "operator"
+        },
+        "ternary": {
+          "signature": "$((condition ? val1 : val2))",
+          "description": "Ternary conditional: return val1 if condition is non-zero, else val2.",
+          "type": "operator"
+        },
+        "bitwise_and": {
+          "signature": "$((a & b))",
+          "description": "Bitwise AND.",
+          "type": "operator"
+        },
+        "bitwise_or": {
+          "signature": "$((a | b))",
+          "description": "Bitwise OR.",
+          "type": "operator"
+        },
+        "bitwise_xor": {
+          "signature": "$((a ^ b))",
+          "description": "Bitwise XOR.",
+          "type": "operator"
+        },
+        "left_shift": {
+          "signature": "$((a << n))",
+          "description": "Left shift a by n bits.",
+          "type": "operator"
+        },
+        "right_shift": {
+          "signature": "$((a >> n))",
+          "description": "Right shift a by n bits.",
+          "type": "operator"
+        }
+      }
+    },
+    "if": {
+      "signature": "if list; then list; [elif list; then list;] ... [else list;] fi",
+      "description": "Execute commands conditionally. The if list is executed; if its exit status is zero, the then list is executed. Otherwise, each elif list is tested in turn.",
+      "type": "keyword",
+      "module": "control_flow"
+    },
+    "for": {
+      "signature": "for name [in words ...]; do list; done   or   for (( expr1; expr2; expr3 )); do list; done",
+      "description": "Execute commands for each member in a list. The for-in form iterates over words. The arithmetic form works like C for loops.",
+      "type": "keyword",
+      "module": "control_flow"
+    },
+    "while": {
+      "signature": "while list-1; do list-2; done",
+      "description": "Execute commands repeatedly while a condition is true. The exit status of the while command is the exit status of the last command in list-2, or zero if none executed.",
+      "type": "keyword",
+      "module": "control_flow"
+    },
+    "until": {
+      "signature": "until list-1; do list-2; done",
+      "description": "Execute commands repeatedly until a condition becomes true. Equivalent to `while ! condition; do ... done`.",
+      "type": "keyword",
+      "module": "control_flow"
+    },
+    "case": {
+      "signature": "case word in [[(] pattern [| pattern] ...) list ;;] ... esac",
+      "description": "Execute commands matching a pattern. Each pattern is tested in order. `;;` terminates, `;&` falls through, `;;&` tests next pattern.",
+      "type": "keyword",
+      "module": "control_flow"
+    },
+    "select": {
+      "signature": "select name [in words ...]; do list; done",
+      "description": "Generate a numbered menu from words. The user's choice is stored in name, the input line in REPLY. Loops until break or EOF.",
+      "type": "keyword",
+      "module": "control_flow"
+    },
+    "function": {
+      "signature": "name () compound-command [redirections]   or   function name [()] compound-command [redirections]",
+      "description": "Define a function. Parameters are accessed via $1, $2, etc. Local variables with `local`. Return value via `return n`.",
+      "type": "keyword",
+      "module": "control_flow"
+    },
+    "autoload": {
+      "signature": "autoload [-UXz] function ...",
+      "description": "Mark function for autoloading from fpath. -U: suppress alias expansion. -z: zsh-style loading. Functions loaded on first call.",
+      "type": "builtin"
+    },
+    "bindkey": {
+      "signature": "bindkey [-evaMsR] [key] [widget]",
+      "description": "Bind keys to ZLE widgets. -e: emacs keymap. -v: vi keymap. -M: specify keymap. -l: list keymaps.",
+      "type": "builtin"
+    },
+    "builtin": {
+      "signature": "builtin name [args]",
+      "description": "Execute a builtin command, ignoring functions and aliases with the same name.",
+      "type": "builtin"
+    },
+    "compdef": {
+      "signature": "compdef function command ...",
+      "description": "Associate a completion function with commands. Part of the completion system.",
+      "type": "builtin"
+    },
+    "dirs": {
+      "signature": "dirs [-clpv]",
+      "description": "Display directory stack. -v: verbose listing with indices. -c: clear stack.",
+      "type": "builtin"
+    },
+    "emulate": {
+      "signature": "emulate [-lLR] mode",
+      "description": "Set shell emulation mode: zsh, sh, ksh, csh. -L: local to function. -R: reset all options.",
+      "type": "builtin"
+    },
+    "fc": {
+      "signature": "fc [-e editor] [-nlrdDfEim] [first [last]]",
+      "description": "Fix command — list, edit, or re-execute history entries.",
+      "type": "builtin"
+    },
+    "float": {
+      "signature": "float [-Hg] [-E n] [-F n] [name[=value] ...]",
+      "description": "Declare floating-point variables.",
+      "type": "builtin"
+    },
+    "functions": {
+      "signature": "functions [-mMtTuUz] [name ...]",
+      "description": "Display or set attributes on functions. Same as typeset -f.",
+      "type": "builtin"
+    },
+    "hash": {
+      "signature": "hash [-dfmrv] [name[=value] ...]",
+      "description": "Manage command hash table. Maps command names to paths for faster lookup.",
+      "type": "builtin"
+    },
+    "integer": {
+      "signature": "integer [-i base] [name[=value] ...]",
+      "description": "Declare integer variables. Arithmetic is performed on assignments.",
+      "type": "builtin"
+    },
+    "print": {
+      "signature": "print [-abcDilmnNoOpPrsz] [-u fd] [-f fmt] [args ...]",
+      "description": "Print arguments. More powerful than echo. -P: prompt expansion. -f: printf format. -l: one per line.",
+      "type": "builtin"
+    },
+    "rehash": {
+      "signature": "rehash",
+      "description": "Rebuild command hash table. Run after installing new programs.",
+      "type": "builtin"
+    },
+    "setopt": {
+      "signature": "setopt [option ...]",
+      "description": "Enable shell options. Options control shell behavior: globbing, history, cd, correction, etc.",
+      "type": "builtin"
+    },
+    "typeset": {
+      "signature": "typeset [-aAfFghilrtuxmHLRZE] [name[=value] ...]",
+      "description": "Declare and set attributes on variables. The most versatile variable declaration command.",
+      "type": "builtin"
+    },
+    "unfunction": {
+      "signature": "unfunction name ...",
+      "description": "Remove function definitions.",
+      "type": "builtin"
+    },
+    "unsetopt": {
+      "signature": "unsetopt [option ...]",
+      "description": "Disable shell options.",
+      "type": "builtin"
+    },
+    "whence": {
+      "signature": "whence [-acfmpsvw] name ...",
+      "description": "Show how each name would be interpreted. -p: search path only. -v: verbose.",
+      "type": "builtin"
+    },
+    "where": {
+      "signature": "where name ...",
+      "description": "Display all locations of a command.",
+      "type": "builtin"
+    },
+    "which": {
+      "signature": "which [-aps] name ...",
+      "description": "Show full path of command.",
+      "type": "builtin"
+    },
+    "zcompile": {
+      "signature": "zcompile [-cz] [-R|-M] file [name ...]",
+      "description": "Compile zsh scripts to wordcode for faster loading.",
+      "type": "builtin"
+    },
+    "zle": {
+      "signature": "zle [-aAcCDFgGIKlLmNRU] [widget]",
+      "description": "Zsh Line Editor — manage widgets. -N: create widget from function. -C: create completion widget.",
+      "type": "builtin"
+    },
+    "zmodload": {
+      "signature": "zmodload [-diLu] [module ...]",
+      "description": "Load or unload zsh modules. Common: zsh/datetime, zsh/stat, zsh/regex, zsh/net/tcp.",
+      "type": "builtin"
+    },
+    "zparseopts": {
+      "signature": "zparseopts [-DEKA] specs ...",
+      "description": "Parse command-line options. -D: remove parsed options. -E: don't stop at first non-option. -A assoc: store in associative array.",
+      "type": "builtin"
+    },
+    "zstyle": {
+      "signature": "zstyle pattern style value ...",
+      "description": "Define styles for the completion system and other subsystems. Pattern: ':completion:function:completer:command:argument:tag'.",
+      "type": "builtin"
+    },
+    "PROMPT": {
+      "signature": "PROMPT=string",
+      "description": "Primary prompt string. Supports: %n (user), %m (host), %~ (dir), %F{color}...%f (color), %B...%b (bold), %# (# for root, %% for user).",
+      "type": "variable"
+    },
+    "RPROMPT": {
+      "signature": "RPROMPT=string",
+      "description": "Right-side prompt string. Commonly shows time, git status, or exit code.",
+      "type": "variable"
+    },
+    "PS1": {
+      "signature": "PS1=string",
+      "description": "Same as PROMPT. Primary prompt.",
+      "type": "variable"
+    },
+    "PS2": {
+      "signature": "PS2=string",
+      "description": "Continuation prompt (shown for multi-line commands). Default: '%_> '.",
+      "type": "variable"
+    },
+    "HISTFILE": {
+      "signature": "HISTFILE=path",
+      "description": "Path to the history file. Default: ~/.zsh_history.",
+      "type": "variable"
+    },
+    "HISTSIZE": {
+      "signature": "HISTSIZE=number",
+      "description": "Maximum number of history entries in memory.",
+      "type": "variable"
+    },
+    "SAVEHIST": {
+      "signature": "SAVEHIST=number",
+      "description": "Number of history entries saved to HISTFILE.",
+      "type": "variable"
+    },
+    "FPATH": {
+      "signature": "FPATH=dirs",
+      "description": "Function search path (colon-separated). Directories where autoloaded functions are found.",
+      "type": "variable"
+    },
+    "fpath": {
+      "signature": "fpath=(dirs)",
+      "description": "Array form of FPATH. Tied to FPATH — changes to one affect the other.",
+      "type": "variable"
+    },
+    "path": {
+      "signature": "path=(dirs)",
+      "description": "Array form of PATH. Tied to PATH.",
+      "type": "variable"
+    },
+    "CDPATH": {
+      "signature": "CDPATH=dirs",
+      "description": "Directories searched by cd. cd target tries CDPATH entries as parents.",
+      "type": "variable"
+    },
+    "KEYTIMEOUT": {
+      "signature": "KEYTIMEOUT=n",
+      "description": "Timeout for key sequences (1/100th second). Default: 40 (0.4s). Set to 1 for fast vi-mode switch.",
+      "type": "variable"
+    },
+    "WORDCHARS": {
+      "signature": "WORDCHARS=chars",
+      "description": "Characters considered part of a word for word-based operations. Default includes many special chars.",
+      "type": "variable"
+    },
+    "ZSH_VERSION": {
+      "signature": "ZSH_VERSION",
+      "description": "Current zsh version string.",
+      "type": "variable"
+    },
+    "TERM": {
+      "signature": "TERM=string",
+      "description": "Terminal type for terminfo lookups.",
+      "type": "variable"
     }
   }
 }