@enjoys/context-engine 1.3.1 → 1.4.1

package/data/inlayHints/nextjs.json

@@ -0,0 +1,143 @@
+{
+  "language": "nextjs",
+  "inlayHintPatterns": [
+    {
+      "pattern": "(?:const|let|var)\\s+(\\w+)\\s*=\\s*(?!\\{|\\[|\\(|function|class|new)(.+)",
+      "kind": 1,
+      "label": ": ${inferredType}",
+      "position": "afterIdentifier",
+      "paddingLeft": false,
+      "paddingRight": true,
+      "description": "Infer type for variable assignments"
+    },
+    {
+      "pattern": "const\\s+\\[(\\w+),\\s*set\\w+\\]\\s*=\\s*useState\\(([^)]*?)\\)",
+      "kind": 1,
+      "label": ": ${inferredType}",
+      "position": "afterIdentifier",
+      "paddingLeft": false,
+      "paddingRight": true,
+      "description": "Infer useState generic type from initial value"
+    },
+    {
+      "pattern": "const\\s+(router)\\s*=\\s*useRouter\\(\\)",
+      "kind": 1,
+      "label": ": AppRouterInstance",
+      "position": "afterIdentifier",
+      "paddingLeft": false,
+      "paddingRight": true,
+      "description": "Show useRouter return type"
+    },
+    {
+      "pattern": "const\\s+(pathname)\\s*=\\s*usePathname\\(\\)",
+      "kind": 1,
+      "label": ": string",
+      "position": "afterIdentifier",
+      "paddingLeft": false,
+      "paddingRight": true,
+      "description": "Show usePathname return type"
+    },
+    {
+      "pattern": "const\\s+(searchParams)\\s*=\\s*useSearchParams\\(\\)",
+      "kind": 1,
+      "label": ": ReadonlyURLSearchParams",
+      "position": "afterIdentifier",
+      "paddingLeft": false,
+      "paddingRight": true,
+      "description": "Show useSearchParams return type"
+    },
+    {
+      "pattern": "export\\s+default\\s+(?:async\\s+)?function\\s+\\w+\\(\\s*\\{\\s*(params)\\s*\\}",
+      "kind": 1,
+      "label": ": { [key: string]: string | string[] }",
+      "position": "afterIdentifier",
+      "paddingLeft": false,
+      "paddingRight": true,
+      "description": "Annotate params type in page components"
+    },
+    {
+      "pattern": "export\\s+default\\s+(?:async\\s+)?function\\s+\\w+\\(\\s*\\{[^}]*(searchParams)[^}]*\\}",
+      "kind": 1,
+      "label": ": { [key: string]: string | string[] | undefined }",
+      "position": "afterIdentifier",
+      "paddingLeft": false,
+      "paddingRight": true,
+      "description": "Annotate searchParams type in page components"
+    },
+    {
+      "pattern": "const\\s+(\\w+)\\s*=\\s*await\\s+fetch\\(",
+      "kind": 1,
+      "label": ": Response",
+      "position": "afterIdentifier",
+      "paddingLeft": false,
+      "paddingRight": true,
+      "description": "Show fetch response type"
+    },
+    {
+      "pattern": "async\\s+function\\s+\\w+Action\\([^)]*\\)\\s*(?::\\s*Promise<([^>]+)>)?",
+      "kind": 1,
+      "label": "=> Promise<void>",
+      "position": "afterParameters",
+      "paddingLeft": true,
+      "paddingRight": false,
+      "description": "Show server action return type"
+    },
+    {
+      "pattern": "\\b(?:redirect|notFound|revalidatePath|revalidateTag)\\(([^,)]+)",
+      "kind": 2,
+      "label": "url:",
+      "position": "beforeArgument",
+      "paddingLeft": false,
+      "paddingRight": true,
+      "description": "Parameter name hints at call sites"
+    },
+    {
+      "pattern": "export\\s+(?:async\\s+)?function\\s+(?:GET|POST|PUT|PATCH|DELETE)\\s*\\(\\s*(\\w+)",
+      "kind": 1,
+      "label": ": NextRequest",
+      "position": "afterIdentifier",
+      "paddingLeft": false,
+      "paddingRight": true,
+      "description": "Annotate route handler request parameter type"
+    },
+    {
+      "pattern": "export\\s+(?:async\\s+)?function\\s+(?:GET|POST|PUT|PATCH|DELETE)\\s*\\([^,]+,\\s*\\{\\s*(params)\\s*\\}",
+      "kind": 1,
+      "label": ": { [key: string]: string }",
+      "position": "afterIdentifier",
+      "paddingLeft": false,
+      "paddingRight": true,
+      "description": "Annotate route handler context params type"
+    }
+  ],
+  "typeInferenceRules": {
+    "string": {
+      "pattern": "^[\"'`]",
+      "type": "string"
+    },
+    "number": {
+      "pattern": "^\\d+\\.?\\d*$",
+      "type": "number"
+    },
+    "boolean": {
+      "pattern": "^(true|false)$",
+      "type": "boolean"
+    },
+    "array": {
+      "pattern": "^\\[",
+      "type": "Array<unknown>"
+    },
+    "null": {
+      "pattern": "^null$",
+      "type": "null"
+    },
+    "object": {
+      "pattern": "^\\{",
+      "type": "Record<string, unknown>"
+    },
+    "jsx": {
+      "pattern": "^<[A-Z]",
+      "type": "JSX.Element"
+    }
+  }
+}

package/data/inlayHints/react.json

@@ -0,0 +1,177 @@
+{
+  "language": "react",
+  "inlayHintPatterns": [
+    {
+      "pattern": "const\\s+\\[(\\w+),\\s*(\\w+)\\]\\s*=\\s*useState\\s*\\(([^)]*?)\\)",
+      "hints": [
+        {
+          "position": "after:captureGroup:1",
+          "label": ": S",
+          "description": "Inferred state type from initial value",
+          "kind": "type"
+        },
+        {
+          "position": "after:captureGroup:2",
+          "label": ": Dispatch<SetStateAction<S>>",
+          "description": "State setter function type",
+          "kind": "type"
+        }
+      ]
+    },
+    {
+      "pattern": "const\\s+(\\w+)\\s*=\\s*useRef\\s*\\(([^)]*?)\\)",
+      "hints": [
+        {
+          "position": "after:captureGroup:1",
+          "label": ": MutableRefObject<T>",
+          "description": "Ref object type inferred from initial value",
+          "kind": "type"
+        }
+      ]
+    },
+    {
+      "pattern": "const\\s+(\\w+)\\s*=\\s*useMemo\\s*\\(\\s*\\(\\)\\s*=>",
+      "hints": [
+        {
+          "position": "after:captureGroup:1",
+          "label": ": T",
+          "description": "Memoized value type inferred from factory return",
+          "kind": "type"
+        }
+      ]
+    },
+    {
+      "pattern": "const\\s+(\\w+)\\s*=\\s*useCallback\\s*\\(",
+      "hints": [
+        {
+          "position": "after:captureGroup:1",
+          "label": ": T",
+          "description": "Memoized callback type inferred from function",
+          "kind": "type"
+        }
+      ]
+    },
+    {
+      "pattern": "const\\s+(\\w+)\\s*=\\s*useContext\\s*\\((\\w+)\\)",
+      "hints": [
+        {
+          "position": "after:captureGroup:1",
+          "label": ": ContextType",
+          "description": "Context value type from provider",
+          "kind": "type"
+        }
+      ]
+    },
+    {
+      "pattern": "const\\s+\\[(\\w+),\\s*(\\w+)\\]\\s*=\\s*useReducer\\s*\\(",
+      "hints": [
+        {
+          "position": "after:captureGroup:1",
+          "label": ": State",
+          "description": "Reducer state type",
+          "kind": "type"
+        },
+        {
+          "position": "after:captureGroup:2",
+          "label": ": Dispatch<Action>",
+          "description": "Reducer dispatch function",
+          "kind": "type"
+        }
+      ]
+    },
+    {
+      "pattern": "const\\s+(\\w+)\\s*=\\s*useId\\s*\\(\\)",
+      "hints": [
+        {
+          "position": "after:captureGroup:1",
+          "label": ": string",
+          "description": "Unique ID string",
+          "kind": "type"
+        }
+      ]
+    },
+    {
+      "pattern": "const\\s+\\[(\\w+),\\s*(\\w+)\\]\\s*=\\s*useTransition\\s*\\(\\)",
+      "hints": [
+        {
+          "position": "after:captureGroup:1",
+          "label": ": boolean",
+          "description": "Pending transition state",
+          "kind": "type"
+        },
+        {
+          "position": "after:captureGroup:2",
+          "label": ": TransitionStartFunction",
+          "description": "Function to start a transition",
+          "kind": "type"
+        }
+      ]
+    },
+    {
+      "pattern": "const\\s+(\\w+)\\s*=\\s*useDeferredValue\\s*\\(([^)]+)\\)",
+      "hints": [
+        {
+          "position": "after:captureGroup:1",
+          "label": ": T",
+          "description": "Deferred value type, same as input",
+          "kind": "type"
+        }
+      ]
+    },
+    {
+      "pattern": "useEffect\\s*\\(\\s*\\(\\)\\s*=>\\s*\\{[^}]*\\}\\s*,\\s*\\[([^\\]]*)\\]",
+      "hints": [
+        {
+          "position": "before:captureGroup:1",
+          "label": "deps: ",
+          "description": "Dependency array for the effect",
+          "kind": "parameter"
+        }
+      ]
+    },
+    {
+      "pattern": "useMemo\\s*\\(\\s*\\(\\)\\s*=>[^,]*,\\s*\\[([^\\]]*)\\]",
+      "hints": [
+        {
+          "position": "before:captureGroup:1",
+          "label": "deps: ",
+          "description": "Dependency array for memoization",
+          "kind": "parameter"
+        }
+      ]
+    },
+    {
+      "pattern": "useCallback\\s*\\([^,]*,\\s*\\[([^\\]]*)\\]",
+      "hints": [
+        {
+          "position": "before:captureGroup:1",
+          "label": "deps: ",
+          "description": "Dependency array for callback memoization",
+          "kind": "parameter"
+        }
+      ]
+    },
+    {
+      "pattern": "(?:function|const)\\s+([A-Z][a-zA-Z0-9]*)\\s*(?::\\s*React\\.FC<(\\w+)>)?\\s*(?:=\\s*)?\\(([^)]*?)\\)",
+      "hints": [
+        {
+          "position": "before:captureGroup:3",
+          "label": "props: ",
+          "description": "Component props parameter",
+          "kind": "parameter"
+        }
+      ]
+    },
+    {
+      "pattern": "const\\s+(\\w+)\\s*=\\s*useSyncExternalStore\\s*\\(",
+      "hints": [
+        {
+          "position": "after:captureGroup:1",
+          "label": ": Snapshot",
+          "description": "External store snapshot type",
+          "kind": "type"
+        }
+      ]
+    }
+  ]
+}

package/data/inlayHints/shadcn.json

@@ -0,0 +1,109 @@
+{
+  "language": "shadcn",
+  "inlayHintPatterns": [
+    {
+      "pattern": "const\\s+(\\w+Variants?)\\s*=\\s*cva\\(",
+      "captureGroup": 1,
+      "label": ": (props?: VariantProps) => string",
+      "kind": 1,
+      "tooltip": "cva() returns a function that accepts variant props and returns a class string",
+      "position": "after"
+    },
+    {
+      "pattern": "\\bcn\\(([^)]+)\\)",
+      "captureGroup": 0,
+      "label": ": string",
+      "kind": 1,
+      "tooltip": "cn() returns a merged Tailwind CSS class string",
+      "position": "after"
+    },
+    {
+      "pattern": "const\\s+\\{\\s*(toast).*\\}\\s*=\\s*useToast\\(",
+      "captureGroup": 1,
+      "label": ": (props: ToastProps) => { id, dismiss, update }",
+      "kind": 1,
+      "tooltip": "toast() creates a new toast notification and returns control handles",
+      "position": "after"
+    },
+    {
+      "pattern": "const\\s+(\\w+)\\s*=\\s*useFormField\\(",
+      "captureGroup": 1,
+      "label": ": { id, name, formItemId, formDescriptionId, formMessageId, invalid, isDirty, isTouched, error }",
+      "kind": 1,
+      "tooltip": "useFormField() returns form field state and accessibility IDs",
+      "position": "after"
+    },
+    {
+      "pattern": "variant=[\"'](\\w+)[\"']",
+      "captureGroup": 1,
+      "label": ": VariantProps[\"variant\"]",
+      "kind": 1,
+      "tooltip": "Variant prop value from the component's cva definition",
+      "position": "after"
+    },
+    {
+      "pattern": "React\\.forwardRef<(\\w+),\\s*(\\w+)>",
+      "captureGroup": 1,
+      "label": ": React.Ref<$1>",
+      "kind": 1,
+      "tooltip": "Ref type forwarded to the underlying DOM element",
+      "position": "after"
+    },
+    {
+      "pattern": "<FormField[^>]*render=\\{\\(\\{\\s*field\\s*\\}\\)",
+      "captureGroup": 0,
+      "label": ": ControllerRenderProps<TFieldValues>",
+      "kind": 1,
+      "tooltip": "field object contains value, onChange, onBlur, name, and ref",
+      "position": "after"
+    },
+    {
+      "pattern": "z\\.infer<typeof\\s+(\\w+)>",
+      "captureGroup": 1,
+      "label": ": inferred type",
+      "kind": 1,
+      "tooltip": "Type inferred from the referenced zod schema",
+      "position": "after"
+    },
+    {
+      "pattern": "accessorKey:\\s*[\"'](\\w+)[\"']",
+      "captureGroup": 1,
+      "label": ": keyof TData",
+      "kind": 1,
+      "tooltip": "Column accessor key typed to a property of the row data",
+      "position": "after"
+    }
+  ],
+  "typeInferenceRules": [
+    {
+      "pattern": "const\\s+\\w+\\s*=\\s*cva\\(",
+      "inferredType": "(props?: VariantProps<typeof variants>) => string",
+      "description": "cva() call infers a variant function type based on the provided config"
+    },
+    {
+      "pattern": "useForm<z\\.infer<typeof\\s+(\\w+)>>",
+      "inferredType": "UseFormReturn<z.infer<typeof $1>>",
+      "description": "useForm infers form type from zod schema via z.infer"
+    },
+    {
+      "pattern": "useReactTable\\(\\{",
+      "inferredType": "Table<TData>",
+      "description": "useReactTable returns a Table instance typed to the data shape"
+    },
+    {
+      "pattern": "const\\s+\\{\\s*toast\\s*,?\\s*toasts\\s*\\}\\s*=\\s*useToast\\(",
+      "inferredType": "{ toast: ToastFunction; toasts: Toast[]; dismiss: (id?: string) => void }",
+      "description": "useToast hook returns toast action and current toasts array"
+    },
+    {
+      "pattern": "React\\.forwardRef<(\\w+),\\s*(\\w+)>",
+      "inferredType": "React.ForwardRefExoticComponent<$2 & React.RefAttributes<$1>>",
+      "description": "forwardRef infers an exotic component type from element and props generics"
+    },
+    {
+      "pattern": "const\\s+\\w+\\s*=\\s*useFormField\\(",
+      "inferredType": "{ id: string; name: string; formItemId: string; formDescriptionId: string; formMessageId: string; invalid: boolean; isDirty: boolean; isTouched: boolean; error?: FieldError }",
+      "description": "useFormField returns form field context with validation state"
+    }
+  ]
+}

package/data/inlayHints/shell.json

@@ -1,35 +1,223 @@
-{
-  "language": "shell",
-  "inlayHintPatterns": [
-    {
-      "pattern": "(\\w+)\\s*=\\s*",
-      "kind": 1,
-      "label": ": {type}",
-      "position": "after_value",
-      "paddingLeft": true,
-      "description": "Show inferred types for shell variable assignments"
-    }
-  ],
-  "typeInferenceRules": {
-    "string_literal": {
-      "pattern": "['\"].*['\"]",
-      "type": "string"
-    },
-    "number_literal": {
-      "pattern": "^\\d+$",
-      "type": "integer"
-    },
-    "array_literal": {
-      "pattern": "\\(.*\\)",
-      "type": "array"
-    },
-    "boolean_literal": {
-      "pattern": "\\b(true|false)\\b",
-      "type": "string"
-    },
-    "path_literal": {
-      "pattern": "(/[\\w.-]+)+",
-      "type": "path"
-    }
-  }
-}
+{
+  "language": "shell",
+  "inlayHintPatterns": [
+    {
+      "pattern": "(\\w+)\\s*=\\s*",
+      "kind": 1,
+      "label": ": {type}",
+      "position": "after_value",
+      "paddingLeft": true,
+      "description": "Show inferred types for shell variable assignments"
+    },
+    {
+      "pattern": "(?:local|declare)\\s+(?:-\\w+\\s+)*(\\w+)\\s*=\\s*(.+)",
+      "kind": 1,
+      "label": ": {inferred_type}",
+      "position": "after_capture_1",
+      "paddingLeft": true,
+      "description": "Show inferred type for variable assignments"
+    },
+    {
+      "pattern": "(\\w+)\\s+(\\$\\{?[^}\\s]+\\}?(?:\\s+\\$\\{?[^}\\s]+\\}?)*)",
+      "kind": 2,
+      "label": "{param_name}:",
+      "position": "before_each_arg",
+      "paddingRight": true,
+      "description": "Show parameter names at call sites for known functions"
+    },
+    {
+      "pattern": "declare\\s+-([aAilurnx]+)\\s+(\\w+)",
+      "kind": 1,
+      "label": ": {attribute_description}",
+      "position": "after_capture_2",
+      "paddingLeft": true,
+      "description": "Show attribute description for declare flags"
+    },
+    {
+      "pattern": "\\$\\{(\\w+):?[-+=?]",
+      "kind": 1,
+      "label": "expansion: {expansion_type}",
+      "position": "after_capture_1",
+      "paddingLeft": true,
+      "description": "Show parameter expansion type"
+    },
+    {
+      "pattern": "exit\\s+(\\d+)",
+      "kind": 1,
+      "label": ": {exit_meaning}",
+      "position": "after_capture_1",
+      "paddingLeft": true,
+      "description": "Show meaning of exit status code"
+    },
+    {
+      "pattern": "trap\\s+['\"][^'\"]+['\"]\\s+(\\w+)",
+      "kind": 1,
+      "label": ": signal {signal_number}",
+      "position": "after_capture_1",
+      "paddingLeft": true,
+      "description": "Show signal number for trap signal name"
+    },
+    {
+      "pattern": "\\$\\(\\((.+)\\)\\)",
+      "kind": 1,
+      "label": "= {result}",
+      "position": "after_match",
+      "paddingLeft": true,
+      "description": "Show arithmetic result for constant expressions"
+    },
+    {
+      "pattern": "chmod\\s+(\\d{3,4})\\s+",
+      "kind": 1,
+      "label": ": {permission_string}",
+      "position": "after_capture_1",
+      "paddingLeft": true,
+      "description": "Show symbolic permission for numeric chmod"
+    },
+    {
+      "pattern": "umask\\s+(\\d{3,4})",
+      "kind": 1,
+      "label": ": effective {effective_perms}",
+      "position": "after_capture_1",
+      "paddingLeft": true,
+      "description": "Show effective permissions for umask value"
+    },
+    {
+      "pattern": "\\breturn\\s+(\\d+)",
+      "kind": 1,
+      "label": ": {return_meaning}",
+      "position": "after_capture_1",
+      "paddingLeft": true,
+      "description": "Show meaning of return status code"
+    },
+    {
+      "pattern": "\\bkill\\s+-(?:s\\s+)?(\\d+|[A-Z]+)\\s+",
+      "kind": 1,
+      "label": ": {signal_description}",
+      "position": "after_capture_1",
+      "paddingLeft": true,
+      "description": "Show signal description"
+    },
+    {
+      "pattern": "\\btest\\s+(-[a-zA-Z])\\s+",
+      "kind": 1,
+      "label": ": {test_description}",
+      "position": "after_capture_1",
+      "paddingLeft": true,
+      "description": "Show test operator meaning"
+    }
+  ],
+  "typeInferenceRules": {
+    "string_literal": {
+      "pattern": "['\"].*['\"]",
+      "type": "string"
+    },
+    "number_literal": {
+      "pattern": "^\\d+$",
+      "type": "integer"
+    },
+    "array_literal": {
+      "pattern": "\\(.*\\)",
+      "type": "array"
+    },
+    "boolean_literal": {
+      "pattern": "\\b(true|false)\\b",
+      "type": "string"
+    },
+    "path_literal": {
+      "pattern": "(/[\\w.-]+)+",
+      "type": "path"
+    },
+    "command_substitution": {
+      "pattern": "^\\$\\(.*\\)$",
+      "type": "string (from command)"
+    },
+    "arithmetic": {
+      "pattern": "^\\$\\(\\(.*\\)\\)$",
+      "type": "integer"
+    },
+    "boolean_pattern": {
+      "pattern": "^(true|false|0|1)$",
+      "type": "boolean (exit status)"
+    },
+    "variable_reference": {
+      "pattern": "^\\$\\{?\\w+\\}?$",
+      "type": "string (variable)"
+    },
+    "process_substitution": {
+      "pattern": "^<\\(.*\\)$|^>\\(.*\\)$",
+      "type": "file descriptor"
+    },
+    "heredoc": {
+      "pattern": "^<<-?\\s*\\w+",
+      "type": "string (heredoc)"
+    },
+    "null_literal": {
+      "pattern": "\\\\b(null)\\\\b",
+      "type": "null"
+    }
+  },
+  "attributeDescriptions": {
+    "a": "indexed array",
+    "A": "associative array",
+    "i": "integer",
+    "l": "lowercase",
+    "u": "uppercase",
+    "r": "readonly",
+    "x": "exported",
+    "n": "nameref",
+    "t": "trace"
+  },
+  "exitStatusMeanings": {
+    "0": "success",
+    "1": "general error",
+    "2": "misuse of builtin",
+    "126": "not executable",
+    "127": "command not found",
+    "128": "invalid exit argument",
+    "130": "killed by SIGINT (Ctrl+C)",
+    "137": "killed by SIGKILL",
+    "143": "killed by SIGTERM"
+  },
+  "signalDescriptions": {
+    "1": "HUP - hangup / reload",
+    "2": "INT - interrupt (Ctrl+C)",
+    "3": "QUIT - core dump",
+    "9": "KILL - force kill (uncatchable)",
+    "13": "PIPE - broken pipe",
+    "15": "TERM - graceful termination",
+    "17": "CHLD - child status change",
+    "18": "CONT - continue stopped process",
+    "19": "STOP - stop (uncatchable)",
+    "20": "TSTP - terminal stop (Ctrl+Z)",
+    "SIGHUP": "hangup / reload",
+    "SIGINT": "interrupt (Ctrl+C)",
+    "SIGQUIT": "quit with core dump",
+    "SIGKILL": "force kill (uncatchable)",
+    "SIGTERM": "graceful termination",
+    "SIGSTOP": "stop (uncatchable)",
+    "SIGCONT": "continue stopped process",
+    "SIGTSTP": "terminal stop (Ctrl+Z)",
+    "EXIT": "shell exit (pseudo-signal)",
+    "ERR": "command failure (with set -e)",
+    "DEBUG": "before each command",
+    "RETURN": "after function/source return"
+  },
+  "testOperatorDescriptions": {
+    "-f": "is regular file",
+    "-d": "is directory",
+    "-e": "exists (any type)",
+    "-s": "exists and non-empty",
+    "-r": "is readable",
+    "-w": "is writable",
+    "-x": "is executable",
+    "-L": "is symlink",
+    "-h": "is symlink",
+    "-p": "is named pipe",
+    "-S": "is socket",
+    "-b": "is block device",
+    "-c": "is character device",
+    "-z": "string is empty",
+    "-n": "string is non-empty",
+    "-t": "fd is open terminal"
+  }
+}