@enjoys/context-engine 1.2.0 → 1.4.1

package/data/inlayHints/css.json

@@ -0,0 +1,87 @@
+{
+  "language": "css",
+  "inlayHintPatterns": [
+    {
+      "pattern": "([.#]?[a-zA-Z_][a-zA-Z0-9_-]*(?:\\s*[>+~]\\s*[.#]?[a-zA-Z_][a-zA-Z0-9_-]*)*)\\s*\\{",
+      "kind": "type",
+      "label": "specificity: (${id}, ${class}, ${type})",
+      "position": "after",
+      "description": "Displays the computed specificity of a CSS selector as an (ID, Class, Type) tuple. Helps understand cascade priority."
+    },
+    {
+      "pattern": "#([0-9a-fA-F]{3,8})\\b",
+      "kind": "type",
+      "label": "■ ${color}",
+      "position": "after",
+      "description": "Shows a color swatch preview inline after hex color values for visual identification."
+    },
+    {
+      "pattern": ":\\s*(-?\\d+(\\.\\d+)?)px\\b",
+      "kind": "type",
+      "label": "${rem}rem",
+      "position": "after",
+      "description": "Displays the rem equivalent of pixel values (assumes 16px base). Example: 24px → 1.5rem."
+    },
+    {
+      "pattern": ":\\s*(-?\\d+(\\.\\d+)?)rem\\b",
+      "kind": "type",
+      "label": "${px}px",
+      "position": "after",
+      "description": "Displays the pixel equivalent of rem values (assumes 16px base). Example: 1.5rem → 24px."
+    },
+    {
+      "pattern": "margin:\\s*([^;]+);",
+      "kind": "type",
+      "label": "↑${top} →${right} ↓${bottom} ←${left}",
+      "position": "after",
+      "description": "Expands margin shorthand to show computed values for each side (top, right, bottom, left)."
+    },
+    {
+      "pattern": "padding:\\s*([^;]+);",
+      "kind": "type",
+      "label": "↑${top} →${right} ↓${bottom} ←${left}",
+      "position": "after",
+      "description": "Expands padding shorthand to show computed values for each side (top, right, bottom, left)."
+    },
+    {
+      "pattern": "z-index:\\s*(-?\\d+)",
+      "kind": "type",
+      "label": "stacking layer: ${level}",
+      "position": "after",
+      "description": "Indicates the relative stacking layer of the z-index value within the current stacking context."
+    },
+    {
+      "pattern": "transition:\\s*([^;]+);",
+      "kind": "type",
+      "label": "⏱ ${totalDuration}",
+      "position": "after",
+      "description": "Shows the total transition duration including delay for quick reference."
+    },
+    {
+      "pattern": "animation:\\s*([^;]+);",
+      "kind": "type",
+      "label": "⏱ ${duration} × ${iterations}",
+      "position": "after",
+      "description": "Shows animation duration and iteration count for quick reference."
+    },
+    {
+      "pattern": "grid-template-columns:\\s*repeat\\((\\d+|auto-fill|auto-fit),\\s*([^)]+)\\)",
+      "kind": "type",
+      "label": "${count} columns",
+      "position": "after",
+      "description": "Shows the number of grid columns generated by repeat() for easier visualization."
+    },
+    {
+      "pattern": "font-size:\\s*clamp\\(([^,]+),\\s*([^,]+),\\s*([^)]+)\\)",
+      "kind": "type",
+      "label": "min: ${1}, preferred: ${2}, max: ${3}",
+      "position": "after",
+      "description": "Breaks down clamp() function parameters for fluid font-size declarations."
+    }
+  ],
+  "typeInferenceRules": {
+    "specificity": "Computed as (count of #id selectors, count of .class/:pseudo-class/[attribute] selectors, count of element/::pseudo-element selectors)",
+    "pxToRem": "Divide pixel value by 16 (default browser font-size)",
+    "shorthandExpansion": "1 value = all sides; 2 values = vertical|horizontal; 3 values = top|horizontal|bottom; 4 values = top|right|bottom|left"
+  }
+}

package/data/inlayHints/nestjs.json

@@ -0,0 +1,24 @@
+{
+  "language": "nestjs",
+  "inlayHintPatterns": [
+    { "pattern": "constructor\\((?:private|protected|public)\\s+(?:readonly\\s+)?(\\w+):\\s*(\\w+)", "kind": 1, "label": ": {type}", "position": "after_capture_1", "paddingLeft": true, "description": "Show injected service types" },
+    { "pattern": "@(Body|Param|Query|Headers)\\((?:['\"]([^'\"]+)['\"])?\\)\\s+(\\w+)", "kind": 2, "label": "{param_name}:", "position": "before_capture_3", "paddingRight": true, "description": "Show decorator parameter source" },
+    { "pattern": "(\\w+)\\s*=\\s*(?:await\\s+)?this\\.(\\w+Service)\\.(\\w+)\\(", "kind": 1, "label": ": {inferred_type}", "position": "after_capture_1", "paddingLeft": true, "description": "Infer service method return type" },
+    { "pattern": "(?:const|let)\\s+(\\w+)\\s*=\\s*(?:await\\s+)?this\\.configService\\.get(?:<[^>]+>)?\\(['\"]([^'\"]+)['\"]\\)", "kind": 1, "label": ": {config_type}", "position": "after_capture_1", "paddingLeft": true, "description": "Config value type hint" },
+    { "pattern": "@HttpCode\\((\\d+)\\)", "kind": 2, "label": "HTTP {status}", "position": "after_capture_1", "paddingLeft": true, "description": "HTTP status code meaning" },
+    { "pattern": "@(Get|Post|Put|Patch|Delete)\\(['\"]([^'\"]*)['\"]\\)", "kind": 2, "label": "{method} {path}", "position": "after_capture_0", "paddingLeft": true, "description": "Full route path hint" },
+    { "pattern": "\\bnew\\s+(\\w+Exception)\\(", "kind": 1, "label": "extends HttpException", "position": "after_capture_1", "paddingLeft": true, "description": "Exception class hierarchy" },
+    { "pattern": "module\\.get<(\\w+)>\\((\\w+)\\)", "kind": 1, "label": ": {type}", "position": "after_capture_0", "paddingLeft": true, "description": "Testing module.get return type" },
+    { "pattern": "(\\w+)\\s*=\\s*(.+)", "kind": 1, "label": ": {inferred_type}", "position": "after_capture_1", "paddingLeft": true, "description": "Variable type inference" }
+  ],
+  "typeInferenceRules": {
+    "string_literal": { "pattern": "['\"].*['\"]", "type": "string" },
+    "number_literal": { "pattern": "\\d+(\\.\\d+)?", "type": "number" },
+    "boolean_literal": { "pattern": "\\b(true|false)\\b", "type": "boolean" },
+    "array_literal": { "pattern": "\\[.*\\]", "type": "array" },
+    "object_literal": { "pattern": "\\{.*\\}", "type": "object" },
+    "null_literal": { "pattern": "\\b(null|undefined)\\b", "type": "null" },
+    "new_instance": { "pattern": "new\\s+(\\w+)\\(", "type": "{capture_1}" },
+    "await_expression": { "pattern": "await\\s+", "type": "Promise<unknown>" }
+  }
+}

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"
+    }
+  ]
+}