@enjoys/context-engine 1.3.1 → 1.4.1

package/data/foldingRange/shadcn.json

@@ -0,0 +1,93 @@
+{
+  "language": "shadcn",
+  "foldingPatterns": [
+    {
+      "startPattern": "^import\\s",
+      "endPattern": "(?=^(?!import\\s|\\s*$))",
+      "kind": "imports",
+      "description": "Fold contiguous import statement blocks"
+    },
+    {
+      "startPattern": "React\\.forwardRef\\s*(?:<[^>]*>)?\\s*\\(",
+      "endPattern": "^\\)\\s*;?\\s*$",
+      "kind": "region",
+      "description": "Fold React.forwardRef component wrapper"
+    },
+    {
+      "startPattern": "\\bcva\\s*\\(",
+      "endPattern": "^\\s*\\)\\s*;?\\s*$",
+      "kind": "region",
+      "description": "Fold cva() class-variance-authority definition"
+    },
+    {
+      "startPattern": "return\\s*\\(?\\s*$",
+      "endPattern": "^\\s*\\)\\s*;?\\s*$",
+      "kind": "region",
+      "description": "Fold JSX return block in component"
+    },
+    {
+      "startPattern": "(?:function|const)\\s+[A-Z][a-zA-Z0-9]*\\s*(?:=|\\()",
+      "endPattern": "^\\}\\s*;?\\s*$",
+      "kind": "region",
+      "description": "Fold function or const component body"
+    },
+    {
+      "startPattern": "(?:interface|type)\\s+[A-Z][a-zA-Z0-9]*(?:<[^>]*>)?\\s*(?:=\\s*)?\\{",
+      "endPattern": "^\\}\\s*;?\\s*$",
+      "kind": "region",
+      "description": "Fold interface or type definition block"
+    },
+    {
+      "startPattern": "(?:const\\s+\\w+Schema|z\\.object)\\s*(?:=\\s*)?\\(?\\s*\\{",
+      "endPattern": "^\\s*\\}\\s*\\)?\\s*;?\\s*$",
+      "kind": "region",
+      "description": "Fold Zod form schema definition"
+    },
+    {
+      "startPattern": "(?:const\\s+)?columns\\s*(?::\\s*ColumnDef[^=]*)?=\\s*\\[",
+      "endPattern": "^\\s*\\]\\s*;?\\s*$",
+      "kind": "region",
+      "description": "Fold column definitions array for DataTable"
+    },
+    {
+      "startPattern": "\\b(?:describe|it|test)\\s*\\(",
+      "endPattern": "^\\s*\\}\\s*\\)\\s*;?\\s*$",
+      "kind": "region",
+      "description": "Fold describe/it/test blocks"
+    },
+    {
+      "startPattern": "\\bswitch\\s*\\(",
+      "endPattern": "^\\s*\\}",
+      "kind": "region",
+      "description": "Fold switch/case statement blocks"
+    },
+    {
+      "startPattern": "(?:const|let|var)\\s+\\w+\\s*(?::[^=]*)?=\\s*\\{",
+      "endPattern": "^\\s*\\}\\s*;?\\s*$",
+      "kind": "region",
+      "description": "Fold object literal assignments"
+    },
+    {
+      "startPattern": "`",
+      "endPattern": "`",
+      "kind": "region",
+      "description": "Fold multi-line template literal strings"
+    },
+    {
+      "startPattern": "(?:const|let|var)\\s+\\w+\\s*(?::[^=]*)?=\\s*\\[",
+      "endPattern": "^\\s*\\]\\s*;?\\s*$",
+      "kind": "region",
+      "description": "Fold array literal assignments"
+    },
+    {
+      "startPattern": "/\\*\\*?",
+      "endPattern": "\\*/",
+      "kind": "comment",
+      "description": "Fold multi-line comment blocks"
+    }
+  ],
+  "regionMarkers": {
+    "start": "// #region",
+    "end": "// #endregion"
+  }
+}

package/data/foldingRange/shell.json

@@ -1,46 +1,106 @@
-{
-  "language": "shell",
-  "offSide": false,
-  "markers": {
-    "start": "^\\s*#\\s*#region\\b",
-    "end": "^\\s*#\\s*#endregion\\b"
-  },
-  "foldingRules": [
-    {
-      "kind": "region",
-      "startPattern": "\\{\\s*$",
-      "endPattern": "^\\s*\\}",
-      "description": "Curly brace blocks"
-    },
-    {
-      "kind": "region",
-      "startPattern": "\\bfunction\\b.*\\{\\s*$",
-      "endPattern": "^\\s*\\}",
-      "description": "Function definitions"
-    },
-    {
-      "kind": "region",
-      "startPattern": "\\bif\\b",
-      "endPattern": "\\bfi\\b",
-      "description": "If/fi conditionals"
-    },
-    {
-      "kind": "region",
-      "startPattern": "\\bcase\\b",
-      "endPattern": "\\besac\\b",
-      "description": "Case/esac blocks"
-    },
-    {
-      "kind": "region",
-      "startPattern": "\\bfor\\b",
-      "endPattern": "\\bdone\\b",
-      "description": "For/done loops"
-    },
-    {
-      "kind": "region",
-      "startPattern": "\\bwhile\\b",
-      "endPattern": "\\bdone\\b",
-      "description": "While/done loops"
-    }
-  ]
-}
+{
+  "language": "shell",
+  "offSide": false,
+  "markers": {
+    "start": "^\\s*#\\s*#region\\b",
+    "end": "^\\s*#\\s*#endregion\\b"
+  },
+  "foldingRules": [
+    {
+      "kind": "region",
+      "startPattern": "\\{\\s*$",
+      "endPattern": "^\\s*\\}",
+      "description": "Curly brace blocks"
+    },
+    {
+      "kind": "region",
+      "startPattern": "\\bfunction\\b.*\\{\\s*$",
+      "endPattern": "^\\s*\\}",
+      "description": "Function definitions"
+    },
+    {
+      "kind": "region",
+      "startPattern": "\\bif\\b",
+      "endPattern": "\\bfi\\b",
+      "description": "If/fi conditionals"
+    },
+    {
+      "kind": "region",
+      "startPattern": "\\bcase\\b",
+      "endPattern": "\\besac\\b",
+      "description": "Case/esac blocks"
+    },
+    {
+      "kind": "region",
+      "startPattern": "\\bfor\\b",
+      "endPattern": "\\bdone\\b",
+      "description": "For/done loops"
+    },
+    {
+      "kind": "region",
+      "startPattern": "\\bwhile\\b",
+      "endPattern": "\\bdone\\b",
+      "description": "While/done loops"
+    },
+    {
+      "kind": "region",
+      "startPattern": "^\\s*(function\\s+\\w+|\\w+\\s*\\(\\s*\\))\\s*\\{?",
+      "endPattern": "^\\s*\\}",
+      "description": "Function definition block"
+    },
+    {
+      "kind": "region",
+      "startPattern": "^\\s*if\\b",
+      "endPattern": "^\\s*fi\\b",
+      "description": "If/fi conditional block"
+    },
+    {
+      "kind": "region",
+      "startPattern": "^\\s*case\\b",
+      "endPattern": "^\\s*esac\\b",
+      "description": "Case/esac switch block"
+    },
+    {
+      "kind": "region",
+      "startPattern": "^\\s*for\\b",
+      "endPattern": "^\\s*done\\b",
+      "description": "For/done loop block"
+    },
+    {
+      "kind": "region",
+      "startPattern": "^\\s*while\\b",
+      "endPattern": "^\\s*done\\b",
+      "description": "While/done loop block"
+    },
+    {
+      "kind": "region",
+      "startPattern": "^\\s*until\\b",
+      "endPattern": "^\\s*done\\b",
+      "description": "Until/done loop block"
+    },
+    {
+      "kind": "region",
+      "startPattern": "^\\s*do\\b",
+      "endPattern": "^\\s*done\\b",
+      "description": "Do/done block"
+    },
+    {
+      "kind": "region",
+      "startPattern": "^\\s*select\\b",
+      "endPattern": "^\\s*done\\b",
+      "description": "Select/done block"
+    },
+    {
+      "kind": "comment",
+      "startPattern": "^\\s*#(?!\\s*region\\b|\\s*endregion\\b)",
+      "endPattern": "^(?!\\s*#)",
+      "description": "Consecutive comment lines"
+    },
+    {
+      "kind": "region",
+      "startPattern": "<<-?\\s*['\"]?(\\w+)['\"]?",
+      "endPattern": "^\\s*\\1\\s*$",
+      "description": "Here-document block"
+    }
+  ]
+}

package/data/formatting/angular.json

@@ -0,0 +1,21 @@
+{
+  "language": "angular",
+  "formattingRules": [
+    { "context": "decorator_placement", "rule": "Place each decorator on its own line directly above the class, method, or property it decorates, with no blank line between decorator and target.", "description": "Decorators like @Component, @Injectable, @Input must appear on the line immediately preceding their target" },
+    { "context": "template_string_formatting", "rule": "Inline templates using backtick strings should be indented one level deeper than the decorator property, with the closing backtick aligned to the property key.", "description": "Ensures consistent indentation for inline component templates" },
+    { "context": "import_sorting", "rule": "Sort imports in the following order: 1) @angular/* packages, 2) third-party packages, 3) local/relative imports. Separate each group with a blank line.", "description": "Consistent import ordering for Angular files" },
+    { "context": "class_member_ordering", "rule": "Order class members as: 1) static properties, 2) decorated properties (@Input, @Output), 3) signal declarations, 4) public properties, 5) private properties, 6) constructor, 7) lifecycle hooks in execution order, 8) public methods, 9) private methods.", "description": "Standardized member ordering within Angular component and service classes" },
+    { "context": "lifecycle_hooks_order", "rule": "Order lifecycle hooks by their execution sequence: ngOnChanges, ngOnInit, ngDoCheck, ngAfterContentInit, ngAfterContentChecked, ngAfterViewInit, ngAfterViewChecked, ngOnDestroy.", "description": "Lifecycle hooks should follow Angular's invocation order" },
+    { "context": "signal_declarations", "rule": "Group signal declarations together: signal() first, then computed(), then effect(). Each should be on its own line with type annotations when the type is not obvious.", "description": "Consistent grouping and ordering of signal-based reactive primitives" },
+    { "context": "constructor_injection", "rule": "List constructor parameters one per line when there are more than two. Use access modifiers (private, protected, public, readonly) consistently. Prefer inject() function over constructor injection for standalone components.", "description": "Readable formatting for dependency injection parameters" },
+    { "context": "array_alignment", "rule": "When arrays in decorators (imports, declarations, providers, exports) exceed three items, place each item on its own line with a trailing comma.", "description": "Multi-item arrays in NgModule or Component metadata should be vertically aligned" },
+    { "context": "method_spacing", "rule": "Separate methods with exactly one blank line. Do not add blank lines between a method's decorators and the method signature.", "description": "Consistent spacing between class methods" },
+    { "context": "component_metadata", "rule": "Order @Component metadata properties as: selector, standalone, imports, templateUrl/template, styleUrls/styles, changeDetection, encapsulation, providers.", "description": "Consistent ordering of component decorator metadata properties" }
+  ],
+  "indentation": {
+    "useTabs": false,
+    "tabSize": 2,
+    "trimTrailingWhitespace": true,
+    "insertFinalNewline": true
+  }
+}

package/data/formatting/nestjs.json

@@ -0,0 +1,23 @@
+{
+  "language": "nestjs",
+  "formatting": {
+    "defaultTabSize": 2,
+    "defaultInsertSpaces": true,
+    "rules": [
+      { "description": "Remove trailing whitespace", "pattern": "\\s+$", "replacement": "" },
+      { "description": "Space after keywords", "pattern": "\\b(if|for|while|switch|catch|return)\\(", "replacement": "$1 (" },
+      { "description": "Space before opening brace", "pattern": "\\)\\{", "replacement": ") {" },
+      { "description": "Consistent arrow spacing", "pattern": "=>\\{", "replacement": "=> {" },
+      { "description": "Space after decorator parenthesis", "pattern": "@(\\w+)\\( ", "replacement": "@$1(" },
+      { "description": "Remove multiple blank lines", "pattern": "\\n{3,}", "replacement": "\\n\\n" },
+      { "description": "Semicolon enforcement", "pattern": "(?<![;{}*/])\\s*$", "replacement": ";" },
+      { "description": "Trailing comma in multiline objects", "pattern": "(\\S)\\n(\\s*[}\\]])", "replacement": "$1,\\n$2" },
+      { "description": "Normalize line endings", "pattern": "\\r\\n", "replacement": "\\n" },
+      { "description": "Consistent inject spacing", "pattern": "private\\s+readonly\\s+", "replacement": "private readonly " }
+    ],
+    "indentation": {
+      "increasePattern": "(?:\\{[^}]*$|\\([^)]*$|=>\\s*$|@Module\\(\\{|@Controller\\(|class\\s+\\w+[^{]*\\{)",
+      "decreasePattern": "^\\s*[}\\)\\]]|^\\s*\\)\\s*;?\\s*$"
+    }
+  }
+}

package/data/formatting/nextjs.json

@@ -0,0 +1,23 @@
+{
+  "language": "nextjs",
+  "formatting": {
+    "defaultTabSize": 2,
+    "defaultInsertSpaces": true,
+    "rules": [
+      { "description": "Remove trailing whitespace", "pattern": "\\s+$", "replacement": "" },
+      { "description": "Space after keywords", "pattern": "\\b(if|for|while|switch|catch|return)\\(", "replacement": "$1 (" },
+      { "description": "Space before opening brace", "pattern": "\\)\\{", "replacement": ") {" },
+      { "description": "Consistent arrow function spacing", "pattern": "=>\\{", "replacement": "=> {" },
+      { "description": "Space after commas in JSX props", "pattern": "(\\w)=\\{", "replacement": "$1={" },
+      { "description": "Remove multiple blank lines", "pattern": "\\n{3,}", "replacement": "\\n\\n" },
+      { "description": "Normalize imports", "pattern": "import\\s+\\{\\s*(\\S+)\\s*\\}", "replacement": "import { $1 }" },
+      { "description": "Semicolon enforcement", "pattern": "(?<!;|\\{|\\}|\\*\\/)\\s*$", "replacement": ";" },
+      { "description": "JSX self-closing space", "pattern": "(\\w)\\/>", "replacement": "$1 />" },
+      { "description": "Normalize line endings", "pattern": "\\r\\n", "replacement": "\\n" }
+    ],
+    "indentation": {
+      "increasePattern": "(?:\\{[^}]*$|\\([^)]*$|<[^/][^>]*[^/]>\\s*$|=>\\s*$)",
+      "decreasePattern": "^\\s*[}\\)\\]]|^\\s*<\\/|^\\s*\\/>|^\\s*\\)\\s*;?\\s*$"
+    }
+  }
+}

package/data/formatting/react.json

@@ -0,0 +1,71 @@
+{
+  "language": "react",
+  "formatting": {
+    "defaultTabSize": 2,
+    "defaultInsertSpaces": true,
+    "rules": [
+      {
+        "description": "Self-closing JSX tags for void elements",
+        "pattern": "<(\\w+)([^>]*)><\\/\\1>",
+        "replacement": "<$1$2 />"
+      },
+      {
+        "description": "Consistent JSX expression spacing",
+        "pattern": "\\{\\s+([^}]+?)\\s+\\}",
+        "replacement": "{$1}"
+      },
+      {
+        "description": "Arrow function component spacing",
+        "pattern": "=\\s*\\(([^)]*?)\\)\\s*=>\\s*\\{",
+        "replacement": "= ($1) => {"
+      },
+      {
+        "description": "JSX prop alignment on multiple lines",
+        "pattern": "<(\\w+)\\s+([\\s\\S]*?)\\s*\\/?>",
+        "replacement": "<$1\n  $2\n/>"
+      },
+      {
+        "description": "Import statement sorting - React imports first",
+        "pattern": "import\\s+(?!React)(.*)\\s+from\\s+['\"]react['\"]",
+        "replacement": "import React, { $1 } from 'react'"
+      },
+      {
+        "description": "Normalize JSX boolean props",
+        "pattern": "(\\w+)=\\{true\\}",
+        "replacement": "$1"
+      },
+      {
+        "description": "Consistent hook dependency array formatting",
+        "pattern": "\\},\\s*\\[([^\\]]+)\\]\\s*\\)",
+        "replacement": "}, [$1])"
+      },
+      {
+        "description": "Normalize event handler naming",
+        "pattern": "on(\\w+)=\\{\\(\\)\\s*=>\\s*([^}]+)\\}",
+        "replacement": "on$1={() => $2}"
+      },
+      {
+        "description": "Trim trailing whitespace in JSX content",
+        "pattern": "(>)\\s+(\\S)",
+        "replacement": "$1$2"
+      },
+      {
+        "description": "Consistent return statement with JSX parentheses",
+        "pattern": "return\\s+(<[A-Z])",
+        "replacement": "return (\n    $1"
+      }
+    ],
+    "indentation": {
+      "component": 0,
+      "jsx": 2,
+      "jsxAttributes": 2,
+      "jsxChildren": 2,
+      "hookBody": 2,
+      "switchCase": 2,
+      "objectLiteral": 2,
+      "arrayLiteral": 2,
+      "functionBody": 2,
+      "conditionalExpression": 2
+    }
+  }
+}

package/data/formatting/shadcn.json

@@ -0,0 +1,61 @@
+{
+  "language": "shadcn",
+  "formattingRules": [
+    {
+      "context": "JSX props",
+      "rule": "Align props vertically when more than two props are present, one per line",
+      "description": "Multi-prop JSX elements should have each prop on its own line, aligned with the first prop"
+    },
+    {
+      "context": "className strings",
+      "rule": "Use template literals or cn() for dynamic class names; keep static strings as plain string literals",
+      "description": "Static class strings stay as double-quoted literals; dynamic classes use cn() calls"
+    },
+    {
+      "context": "cn() arguments",
+      "rule": "Place each argument on its own line when there are more than two arguments",
+      "description": "Multi-argument cn() calls should have each argument on a separate line for readability"
+    },
+    {
+      "context": "cva() variant objects",
+      "rule": "Format variant keys and values with each variant axis as a separate block, values indented within",
+      "description": "The variants object in cva() should clearly delineate each axis (variant, size) as indented blocks"
+    },
+    {
+      "context": "Import grouping",
+      "rule": "Group imports in order: React/Next → third-party (Radix, zod, react-hook-form) → @/components/ui/* → @/lib/utils → relative imports",
+      "description": "Imports should follow a consistent grouping order with blank lines between groups"
+    },
+    {
+      "context": "Component prop ordering",
+      "rule": "Order props: ref → key → variant/size → className → event handlers → spread props → children",
+      "description": "Maintain consistent prop ordering across shadcn components"
+    },
+    {
+      "context": "Variant definition alignment",
+      "rule": "Align variant class strings to the same indentation level within a cva() definition",
+      "description": "Variant value strings should be visually aligned for quick scanning"
+    },
+    {
+      "context": "Form field nesting",
+      "rule": "Nest FormItem > FormLabel > FormControl > FormDescription > FormMessage with consistent 2-space indentation",
+      "description": "Form field sub-components follow a strict nesting hierarchy"
+    },
+    {
+      "context": "Tailwind class ordering",
+      "rule": "Order Tailwind classes: layout (flex, grid) → sizing (w, h) → spacing (p, m) → typography → colors → borders → effects → states (hover, focus)",
+      "description": "Follow a consistent Tailwind utility class ordering convention"
+    },
+    {
+      "context": "Multi-line JSX",
+      "rule": "Indent JSX children by 2 spaces; closing tags align with opening tags",
+      "description": "JSX blocks use 2-space indentation with closing tags at the same level as their opening counterpart"
+    }
+  ],
+  "indentation": {
+    "useTabs": false,
+    "tabSize": 2,
+    "trimTrailingWhitespace": true,
+    "insertFinalNewline": true
+  }
+}

package/data/formatting/shell.json

@@ -1,19 +1,103 @@
-{
-  "language": "shell",
-  "formatting": {
-    "defaultTabSize": 4,
-    "defaultInsertSpaces": true,
-    "rules": [
-      {
-        "description": "Remove trailing whitespace",
-        "pattern": "\\s+$",
-        "replacement": ""
-      },
-      {
-        "description": "Normalize line endings",
-        "pattern": "\\r\\n",
-        "replacement": "\\n"
-      }
-    ]
-  }
-}
+{
+  "language": "shell",
+  "formatting": {
+    "defaultTabSize": 4,
+    "defaultInsertSpaces": true,
+    "rules": [
+      {
+        "description": "Remove trailing whitespace",
+        "pattern": "\\s+$",
+        "replacement": ""
+      },
+      {
+        "description": "Normalize line endings",
+        "pattern": "\\r\\n",
+        "replacement": "\\n"
+      },
+      {
+        "description": "Ensure single space after keywords",
+        "pattern": "\\b(if|elif|while|until|for|case|select)\\(",
+        "replacement": "$1 ("
+      },
+      {
+        "description": "Ensure space inside [[ ]] brackets",
+        "pattern": "\\[\\[(\\S)",
+        "replacement": "[[ $1"
+      },
+      {
+        "description": "Ensure space inside [[ ]] closing",
+        "pattern": "(\\S)\\]\\]",
+        "replacement": "$1 ]]"
+      },
+      {
+        "description": "Space after # in comments (except shebang)",
+        "pattern": "^(\\s*)#([^!\\s#])",
+        "replacement": "$1# $2"
+      },
+      {
+        "description": "Remove spaces around = in variable assignment",
+        "pattern": "(\\w+)\\s*=\\s*([^=])",
+        "replacement": "$1=$2"
+      },
+      {
+        "description": "Single blank line between functions",
+        "pattern": "\\}\\n{3,}(?=\\w+\\s*\\(\\)|function\\s)",
+        "replacement": "}\n\n"
+      },
+      {
+        "description": "Ensure space after ; in compound commands",
+        "pattern": ";(\\w)",
+        "replacement": "; $1"
+      },
+      {
+        "description": "Normalize then/do placement (same line)",
+        "pattern": "\\b(if|elif|while|until|for)\\b(.+)\\n\\s*\\b(then|do)\\b",
+        "replacement": "$1$2; $3"
+      },
+      {
+        "description": "Ensure newline before fi/done/esac",
+        "pattern": ";\\s*(fi|done|esac)\\b",
+        "replacement": "\n$1"
+      },
+      {
+        "description": "Normalize heredoc indentation for <<-",
+        "pattern": "<<-\\s*(\\w+)",
+        "replacement": "<<-\t$1"
+      },
+      {
+        "description": "No space before semicolons",
+        "pattern": "\\s+;",
+        "replacement": ";"
+      },
+      {
+        "description": "Ensure space around pipe operators",
+        "pattern": "(\\S)\\|(\\S)",
+        "replacement": "$1 | $2"
+      },
+      {
+        "description": "Ensure space around redirections",
+        "pattern": "(\\w)(>>?|<<?)(?=[^<>&])(\\S)",
+        "replacement": "$1 $2 $3"
+      },
+      {
+        "description": "Remove trailing whitespace",
+        "pattern": "\\\\s+$",
+        "replacement": ""
+      },
+      {
+        "description": "Ensure single space after keywords",
+        "pattern": "\\\\b(if|for|while|until|case|select)\\\\(",
+        "replacement": "$1 ("
+      },
+      {
+        "description": "Normalize line endings",
+        "pattern": "\\\\r\\\\n",
+        "replacement": "\\n"
+      }
+    ],
+    "indentation": {
+      "increasePattern": "(?:then|do|else|elif\\s.*then|\\{|\\()\\s*(?:#.*)?$|^\\s*(?:if|elif|while|until|for|select)\\b.*[^;]$",
+      "decreasePattern": "^\\s*(?:fi|done|else|elif|esac|\\}|\\))\\b"
+    }
+  }
+}