@enjoys/context-engine 1.2.0 → 1.4.1

package/data/references/nextjs.json

@@ -0,0 +1,178 @@
+{
+  "language": "nextjs",
+  "referencePatterns": [
+    {
+      "symbol": "useRouter",
+      "patterns": [
+        "useRouter\\s*\\(",
+        "import\\s*\\{[^}]*useRouter[^}]*\\}\\s*from\\s*['\"]next/navigation['\"]",
+        "const\\s+\\w+\\s*=\\s*useRouter\\s*\\("
+      ],
+      "includeDeclaration": true,
+      "description": "References to the useRouter hook from next/navigation"
+    },
+    {
+      "symbol": "usePathname",
+      "patterns": [
+        "usePathname\\s*\\(",
+        "import\\s*\\{[^}]*usePathname[^}]*\\}\\s*from\\s*['\"]next/navigation['\"]",
+        "const\\s+\\w+\\s*=\\s*usePathname\\s*\\("
+      ],
+      "includeDeclaration": true,
+      "description": "References to the usePathname hook from next/navigation"
+    },
+    {
+      "symbol": "useSearchParams",
+      "patterns": [
+        "useSearchParams\\s*\\(",
+        "import\\s*\\{[^}]*useSearchParams[^}]*\\}\\s*from\\s*['\"]next/navigation['\"]",
+        "const\\s+\\w+\\s*=\\s*useSearchParams\\s*\\("
+      ],
+      "includeDeclaration": true,
+      "description": "References to the useSearchParams hook from next/navigation"
+    },
+    {
+      "symbol": "useParams",
+      "patterns": [
+        "useParams\\s*\\(",
+        "import\\s*\\{[^}]*useParams[^}]*\\}\\s*from\\s*['\"]next/navigation['\"]"
+      ],
+      "includeDeclaration": true,
+      "description": "References to the useParams hook from next/navigation"
+    },
+    {
+      "symbol": "Image",
+      "patterns": [
+        "import\\s+Image\\s+from\\s*['\"]next/image['\"]",
+        "<Image\\s",
+        "<Image\\s[^>]*/>"
+      ],
+      "includeDeclaration": true,
+      "description": "References to the next/image Image component"
+    },
+    {
+      "symbol": "Link",
+      "patterns": [
+        "import\\s+Link\\s+from\\s*['\"]next/link['\"]",
+        "<Link\\s",
+        "<Link\\s[^>]*>"
+      ],
+      "includeDeclaration": true,
+      "description": "References to the next/link Link component"
+    },
+    {
+      "symbol": "redirect",
+      "patterns": [
+        "redirect\\s*\\(",
+        "import\\s*\\{[^}]*redirect[^}]*\\}\\s*from\\s*['\"]next/navigation['\"]"
+      ],
+      "includeDeclaration": true,
+      "description": "References to the redirect function from next/navigation"
+    },
+    {
+      "symbol": "notFound",
+      "patterns": [
+        "notFound\\s*\\(",
+        "import\\s*\\{[^}]*notFound[^}]*\\}\\s*from\\s*['\"]next/navigation['\"]"
+      ],
+      "includeDeclaration": true,
+      "description": "References to the notFound function from next/navigation"
+    },
+    {
+      "symbol": "cookies",
+      "patterns": [
+        "cookies\\s*\\(",
+        "import\\s*\\{[^}]*cookies[^}]*\\}\\s*from\\s*['\"]next/headers['\"]"
+      ],
+      "includeDeclaration": true,
+      "description": "References to the cookies function from next/headers"
+    },
+    {
+      "symbol": "headers",
+      "patterns": [
+        "headers\\s*\\(",
+        "import\\s*\\{[^}]*headers[^}]*\\}\\s*from\\s*['\"]next/headers['\"]"
+      ],
+      "includeDeclaration": true,
+      "description": "References to the headers function from next/headers"
+    },
+    {
+      "symbol": "NextResponse",
+      "patterns": [
+        "NextResponse\\.",
+        "import\\s*\\{[^}]*NextResponse[^}]*\\}\\s*from\\s*['\"]next/server['\"]",
+        "new\\s+NextResponse\\s*\\(",
+        ":\\s*NextResponse"
+      ],
+      "includeDeclaration": true,
+      "description": "References to NextResponse from next/server"
+    },
+    {
+      "symbol": "NextRequest",
+      "patterns": [
+        "NextRequest",
+        "import\\s*\\{[^}]*NextRequest[^}]*\\}\\s*from\\s*['\"]next/server['\"]",
+        ":\\s*NextRequest"
+      ],
+      "includeDeclaration": true,
+      "description": "References to NextRequest from next/server"
+    },
+    {
+      "symbol": "revalidatePath",
+      "patterns": [
+        "revalidatePath\\s*\\(",
+        "import\\s*\\{[^}]*revalidatePath[^}]*\\}\\s*from\\s*['\"]next/cache['\"]"
+      ],
+      "includeDeclaration": true,
+      "description": "References to revalidatePath from next/cache"
+    },
+    {
+      "symbol": "revalidateTag",
+      "patterns": [
+        "revalidateTag\\s*\\(",
+        "import\\s*\\{[^}]*revalidateTag[^}]*\\}\\s*from\\s*['\"]next/cache['\"]"
+      ],
+      "includeDeclaration": true,
+      "description": "References to revalidateTag from next/cache"
+    },
+    {
+      "symbol": "generateMetadata",
+      "patterns": [
+        "export\\s+async\\s+function\\s+generateMetadata",
+        "generateMetadata\\s*\\(",
+        "type.*generateMetadata"
+      ],
+      "includeDeclaration": true,
+      "description": "References to the generateMetadata function"
+    },
+    {
+      "symbol": "generateStaticParams",
+      "patterns": [
+        "export\\s+async\\s+function\\s+generateStaticParams",
+        "generateStaticParams\\s*\\("
+      ],
+      "includeDeclaration": true,
+      "description": "References to the generateStaticParams function"
+    },
+    {
+      "symbol": "metadata",
+      "patterns": [
+        "export\\s+const\\s+metadata",
+        ":\\s*Metadata\\b",
+        "import\\s+type\\s*\\{[^}]*Metadata[^}]*\\}\\s*from\\s*['\"]next['\"]"
+      ],
+      "includeDeclaration": true,
+      "description": "References to metadata exports and Metadata type"
+    },
+    {
+      "symbol": "dynamic",
+      "patterns": [
+        "import\\s+dynamic\\s+from\\s*['\"]next/dynamic['\"]",
+        "const\\s+\\w+\\s*=\\s*dynamic\\s*\\("
+      ],
+      "includeDeclaration": true,
+      "description": "References to the dynamic import function from next/dynamic"
+    }
+  ],
+  "identifierPattern": "[a-zA-Z_$][a-zA-Z0-9_$]*"
+}

package/data/references/react.json

@@ -0,0 +1,192 @@
+{
+  "language": "react",
+  "referencePatterns": [
+    {
+      "symbol": "useState",
+      "patterns": ["\\buseState\\b", "\\buseState\\s*<", "\\buseState\\s*\\("],
+      "includeDeclaration": true,
+      "description": "References to React useState hook"
+    },
+    {
+      "symbol": "useEffect",
+      "patterns": ["\\buseEffect\\b", "\\buseEffect\\s*\\("],
+      "includeDeclaration": true,
+      "description": "References to React useEffect hook"
+    },
+    {
+      "symbol": "useContext",
+      "patterns": ["\\buseContext\\b", "\\buseContext\\s*\\(", "\\buseContext\\s*<"],
+      "includeDeclaration": true,
+      "description": "References to React useContext hook"
+    },
+    {
+      "symbol": "useReducer",
+      "patterns": ["\\buseReducer\\b", "\\buseReducer\\s*<", "\\buseReducer\\s*\\("],
+      "includeDeclaration": true,
+      "description": "References to React useReducer hook"
+    },
+    {
+      "symbol": "useMemo",
+      "patterns": ["\\buseMemo\\b", "\\buseMemo\\s*\\(", "\\buseMemo\\s*<"],
+      "includeDeclaration": true,
+      "description": "References to React useMemo hook"
+    },
+    {
+      "symbol": "useCallback",
+      "patterns": ["\\buseCallback\\b", "\\buseCallback\\s*\\(", "\\buseCallback\\s*<"],
+      "includeDeclaration": true,
+      "description": "References to React useCallback hook"
+    },
+    {
+      "symbol": "useRef",
+      "patterns": ["\\buseRef\\b", "\\buseRef\\s*<", "\\buseRef\\s*\\("],
+      "includeDeclaration": true,
+      "description": "References to React useRef hook"
+    },
+    {
+      "symbol": "useLayoutEffect",
+      "patterns": ["\\buseLayoutEffect\\b", "\\buseLayoutEffect\\s*\\("],
+      "includeDeclaration": true,
+      "description": "References to React useLayoutEffect hook"
+    },
+    {
+      "symbol": "useId",
+      "patterns": ["\\buseId\\b", "\\buseId\\s*\\("],
+      "includeDeclaration": true,
+      "description": "References to React useId hook"
+    },
+    {
+      "symbol": "useTransition",
+      "patterns": ["\\buseTransition\\b", "\\buseTransition\\s*\\("],
+      "includeDeclaration": true,
+      "description": "References to React useTransition hook"
+    },
+    {
+      "symbol": "useDeferredValue",
+      "patterns": ["\\buseDeferredValue\\b", "\\buseDeferredValue\\s*\\("],
+      "includeDeclaration": true,
+      "description": "References to React useDeferredValue hook"
+    },
+    {
+      "symbol": "useSyncExternalStore",
+      "patterns": ["\\buseSyncExternalStore\\b", "\\buseSyncExternalStore\\s*\\("],
+      "includeDeclaration": true,
+      "description": "References to React useSyncExternalStore hook"
+    },
+    {
+      "symbol": "useImperativeHandle",
+      "patterns": ["\\buseImperativeHandle\\b", "\\buseImperativeHandle\\s*\\("],
+      "includeDeclaration": true,
+      "description": "References to React useImperativeHandle hook"
+    },
+    {
+      "symbol": "useDebugValue",
+      "patterns": ["\\buseDebugValue\\b", "\\buseDebugValue\\s*\\("],
+      "includeDeclaration": true,
+      "description": "References to React useDebugValue hook"
+    },
+    {
+      "symbol": "createElement",
+      "patterns": ["\\bcreateElement\\b", "React\\.createElement\\b"],
+      "includeDeclaration": true,
+      "description": "References to React.createElement"
+    },
+    {
+      "symbol": "createContext",
+      "patterns": ["\\bcreateContext\\b", "React\\.createContext\\b"],
+      "includeDeclaration": true,
+      "description": "References to React.createContext"
+    },
+    {
+      "symbol": "createPortal",
+      "patterns": ["\\bcreatePortal\\b", "ReactDOM\\.createPortal\\b"],
+      "includeDeclaration": true,
+      "description": "References to ReactDOM.createPortal"
+    },
+    {
+      "symbol": "createRoot",
+      "patterns": ["\\bcreateRoot\\b", "ReactDOM\\.createRoot\\b"],
+      "includeDeclaration": true,
+      "description": "References to ReactDOM.createRoot"
+    },
+    {
+      "symbol": "forwardRef",
+      "patterns": ["\\bforwardRef\\b", "React\\.forwardRef\\b"],
+      "includeDeclaration": true,
+      "description": "References to React.forwardRef"
+    },
+    {
+      "symbol": "memo",
+      "patterns": ["\\bmemo\\b(?!r)", "React\\.memo\\b"],
+      "includeDeclaration": true,
+      "description": "References to React.memo"
+    },
+    {
+      "symbol": "lazy",
+      "patterns": ["\\blazy\\b", "React\\.lazy\\b"],
+      "includeDeclaration": true,
+      "description": "References to React.lazy"
+    },
+    {
+      "symbol": "Fragment",
+      "patterns": ["\\bFragment\\b", "React\\.Fragment\\b", "<>", "</>"],
+      "includeDeclaration": true,
+      "description": "References to React.Fragment"
+    },
+    {
+      "symbol": "Suspense",
+      "patterns": ["\\bSuspense\\b", "<Suspense", "</Suspense>"],
+      "includeDeclaration": true,
+      "description": "References to React.Suspense"
+    },
+    {
+      "symbol": "StrictMode",
+      "patterns": ["\\bStrictMode\\b", "<StrictMode", "</StrictMode>"],
+      "includeDeclaration": true,
+      "description": "References to React.StrictMode"
+    },
+    {
+      "symbol": "ComponentReference",
+      "patterns": ["<[A-Z][a-zA-Z0-9]*", "</[A-Z][a-zA-Z0-9]*>", "<[A-Z][a-zA-Z0-9]*/?>"],
+      "includeDeclaration": false,
+      "description": "References to React component usage in JSX"
+    },
+    {
+      "symbol": "startTransition",
+      "patterns": ["\\bstartTransition\\b", "\\bstartTransition\\s*\\("],
+      "includeDeclaration": true,
+      "description": "References to React.startTransition"
+    },
+    {
+      "symbol": "flushSync",
+      "patterns": ["\\bflushSync\\b", "\\bflushSync\\s*\\("],
+      "includeDeclaration": true,
+      "description": "References to ReactDOM.flushSync"
+    },
+    {
+      "symbol": "hydrateRoot",
+      "patterns": ["\\bhydrateRoot\\b", "\\bhydrateRoot\\s*\\("],
+      "includeDeclaration": true,
+      "description": "References to ReactDOM.hydrateRoot"
+    },
+    {
+      "symbol": "cloneElement",
+      "patterns": ["\\bcloneElement\\b", "React\\.cloneElement\\b"],
+      "includeDeclaration": true,
+      "description": "References to React.cloneElement"
+    },
+    {
+      "symbol": "isValidElement",
+      "patterns": ["\\bisValidElement\\b", "React\\.isValidElement\\b"],
+      "includeDeclaration": true,
+      "description": "References to React.isValidElement"
+    },
+    {
+      "symbol": "Children",
+      "patterns": ["React\\.Children\\b", "\\bChildren\\.map\\b", "\\bChildren\\.forEach\\b", "\\bChildren\\.count\\b"],
+      "includeDeclaration": true,
+      "description": "References to React.Children utilities"
+    }
+  ],
+  "identifierPattern": "[a-zA-Z_$][a-zA-Z0-9_$]*"
+}

package/data/references/shadcn.json

@@ -0,0 +1,101 @@
+{
+  "language": "shadcn",
+  "referencePatterns": [
+    {
+      "name": "UI Component Import",
+      "pattern": "from\\s+[\"']@/components/ui/(\\w+)[\"']",
+      "captureGroup": 1,
+      "description": "Import of a shadcn/ui component from the ui directory"
+    },
+    {
+      "name": "cn() Usage",
+      "pattern": "\\bcn\\(([^)]+)\\)",
+      "captureGroup": 1,
+      "description": "Usage of the cn() utility for conditional class merging"
+    },
+    {
+      "name": "cva() Variant Definition",
+      "pattern": "\\bcva\\(\\s*[\"']([^\"']+)[\"']",
+      "captureGroup": 1,
+      "description": "Class-variance-authority variant base class definition"
+    },
+    {
+      "name": "Radix UI Primitive",
+      "pattern": "from\\s+[\"']@radix-ui/react-(\\w[\\w-]*)[\"']",
+      "captureGroup": 1,
+      "description": "Reference to a Radix UI primitive package"
+    },
+    {
+      "name": "CSS Variable Reference",
+      "pattern": "var\\(--([\\w-]+)\\)",
+      "captureGroup": 1,
+      "description": "CSS custom property variable reference (e.g. --primary, --background)"
+    },
+    {
+      "name": "Form Field Reference",
+      "pattern": "<FormField[^>]*name=[\"'](\\w+)[\"']",
+      "captureGroup": 1,
+      "description": "Reference to a form field by name in a shadcn Form"
+    },
+    {
+      "name": "Toast Reference",
+      "pattern": "\\btoast\\(\\{[^}]*title:\\s*[\"']([^\"']+)[\"']",
+      "captureGroup": 1,
+      "description": "Toast notification invocation with title"
+    },
+    {
+      "name": "useFormField Hook",
+      "pattern": "\\buseFormField\\(\\)",
+      "captureGroup": 0,
+      "description": "Usage of the useFormField hook for form context access"
+    },
+    {
+      "name": "Variant Prop Usage",
+      "pattern": "\\bvariant=[\"'](\\w+)[\"']",
+      "captureGroup": 1,
+      "description": "Variant prop applied to a shadcn component"
+    },
+    {
+      "name": "className Prop",
+      "pattern": "\\bclassName=\\{([^}]+)\\}",
+      "captureGroup": 1,
+      "description": "Dynamic className prop using expression"
+    },
+    {
+      "name": "Ref Forwarding",
+      "pattern": "React\\.forwardRef<(\\w+)",
+      "captureGroup": 1,
+      "description": "Ref forwarding with typed element reference"
+    },
+    {
+      "name": "Component Composition",
+      "pattern": "<(\\w+)\\.Root",
+      "captureGroup": 1,
+      "description": "Radix-style component composition using dot notation"
+    },
+    {
+      "name": "Zod Schema Reference",
+      "pattern": "\\b(\\w+Schema)\\b",
+      "captureGroup": 1,
+      "description": "Reference to a zod validation schema"
+    },
+    {
+      "name": "Column Definition Reference",
+      "pattern": "accessorKey:\\s*[\"'](\\w+)[\"']",
+      "captureGroup": 1,
+      "description": "DataTable column accessor key reference"
+    },
+    {
+      "name": "Hook Usage",
+      "pattern": "\\b(use\\w+)\\(",
+      "captureGroup": 1,
+      "description": "Usage of a React or shadcn custom hook"
+    },
+    {
+      "name": "Tailwind Theme Color",
+      "pattern": "(?:text|bg|border|ring|accent)-(primary|secondary|muted|destructive|accent|popover|card)",
+      "captureGroup": 1,
+      "description": "Tailwind utility referencing a shadcn theme color"
+    }
+  ]
+}