@enjoys/context-engine 1.2.0 → 1.4.1

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

package/data/formatting/tailwindcss.json

@@ -0,0 +1,48 @@
+{
+  "language": "tailwindcss",
+  "formatting": {
+    "defaultTabSize": 2,
+    "defaultInsertSpaces": true,
+    "rules": [
+      {
+        "description": "Sort utility classes in @apply rules following recommended order (layout, spacing, sizing, typography, backgrounds, borders, effects, transitions)",
+        "pattern": "@apply\\s+([\\w\\s:/-]+);",
+        "replacement": "@apply ${sorted_classes};"
+      },
+      {
+        "description": "Normalize spacing in @apply directives to single spaces between classes",
+        "pattern": "@apply\\s{2,}|@apply\\s+([\\w:-]+)\\s{2,}",
+        "replacement": "@apply ${1} "
+      },
+      {
+        "description": "Ensure @tailwind directives are ordered: base, components, utilities",
+        "pattern": "@tailwind\\s+(utilities|components|base)\\s*;",
+        "replacement": "@tailwind ${ordered_layer};"
+      },
+      {
+        "description": "Add blank line between @layer blocks for readability",
+        "pattern": "(\\})(\\s*)(@layer)",
+        "replacement": "${1}\n\n${3}"
+      },
+      {
+        "description": "Normalize @layer block formatting with consistent indentation",
+        "pattern": "@layer\\s+(\\w+)\\s*\\{\\s*",
+        "replacement": "@layer ${1} {\n  "
+      },
+      {
+        "description": "Ensure semicolons after @apply and @tailwind directives",
+        "pattern": "(@apply\\s+[\\w\\s:/-]+)\\s*$",
+        "replacement": "${1};"
+      },
+      {
+        "description": "Format @config directive with consistent quoting",
+        "pattern": "@config\\s+\"([^\"]+)\"\\s*;",
+        "replacement": "@config '${1}';"
+      }
+    ],
+    "indentation": {
+      "increasePattern": "\\{\\s*$|@layer\\s+\\w+\\s*\\{",
+      "decreasePattern": "^\\s*\\}"
+    }
+  }
+}