refactor(project): restructure codebase and add native AST types 🚧

- Add deno native plugins AST type definitions
- Bump version to 0.2.0 for major structural changes
- Centralize shared logic into dedicated utils directory
- Migrate from shared to interfaces directory structure
- Rename rule files from kebab-case to PascalCase convention
- Rename test files to match PascalCase naming convention
- Update import paths and entry point configuration

Author: NeaByteLab

deno.json

@@ -1,10 +1,10 @@
 {
   "name": "@neabyte/deno-lint",
   "description": "Deno lint plugin collection for identifying and reporting on patterns found in code",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "license": "MIT",
-  "exports": "./src/mod.ts",
+  "exports": "./src/index.ts",
   "compilerOptions": {
     "allowUnreachableCode": false,
     "allowUnusedLabels": false,
@@ -83,8 +83,9 @@
   "imports": {
     "@std/assert": "jsr:@std/assert@^1.0.15",
     "@app/": "./src/",
-    "@shared/": "./src/shared/",
+    "@interfaces/": "./src/interfaces/",
     "@rules/": "./src/rules/",
+    "@utils/": "./src/utils/",
     "@tests/": "./tests/"
   },
   "publish": {

src/mod.ts src/index.tssrc/mod.ts renamed to src/index.ts

@@ -1,11 +1,11 @@
-import type { LintPlugin } from '@app/types.ts'
-import { asyncFunctionNamingRule } from '@rules/async-function-naming.ts'
-import { explicitParameterTypesRule } from '@rules/explicit-parameter-types.ts'
-import { explicitReturnTypesRule } from '@rules/explicit-return-types.ts'
-import { preferNullishCoalescingRule } from '@rules/prefer-nullish-coalescing.ts'
-import { preferOptionalChainRule } from '@rules/prefer-optional-chain.ts'
-import { preferPromiseRejectErrorsRule } from '@rules/prefer-promise-reject-errors.ts'
-import { requireErrorHandlingRule } from '@rules/require-error-handling.ts'
+import type { LintPlugin } from '@interfaces/index.ts'
+import { asyncFunctionNamingRule } from '@rules/AsyncFunctionNaming.ts'
+import { explicitParameterTypesRule } from '@rules/ExplicitParameterTypes.ts'
+import { explicitReturnTypesRule } from '@rules/ExplicitReturnTypes.ts'
+import { preferNullishCoalescingRule } from '@rules/PreferNullishCoalescing.ts'
+import { preferOptionalChainRule } from '@rules/PreferOptionalChain.ts'
+import { preferPromiseRejectErrorsRule } from '@rules/PreferPromiseRejectErrors.ts'
+import { requireErrorHandlingRule } from '@rules/RequireErrorHandling.ts'
 
 /**
  * Deno lint plugin containing custom linting rules.

src/interfaces/ArrayExpression.ts

@@ -0,0 +1,11 @@
+import type { ASTNode } from '@interfaces/index.ts'
+
+/**
+ * AST node representing an array literal.
+ */
+export interface ArrayExpressionNode {
+  /** Type identifier for array expressions */
+  type: 'ArrayExpression'
+  /** Array of elements in the array */
+  elements: Array<ASTNode | null>
+}

src/interfaces/ArrowFunctionExpression.ts

@@ -0,0 +1,17 @@
+import type { ASTNode, ParameterNode } from '@interfaces/index.ts'
+
+/**
+ * AST node representing an arrow function expression.
+ */
+export interface ArrowFunctionExpressionNode {
+  /** Type identifier for arrow function expressions */
+  type: 'ArrowFunctionExpression'
+  /** Optional function identifier with name */
+  id?: { name: string }
+  /** Whether the function is declared as async */
+  async?: boolean
+  /** Array of function parameters */
+  params: Array<ParameterNode>
+  /** Function body */
+  body: ASTNode
+}

src/interfaces/AssignmentExpression.ts

@@ -0,0 +1,30 @@
+import type { ASTNode } from '@interfaces/index.ts'
+
+/**
+ * AST node representing an assignment expression.
+ */
+export interface AssignmentExpressionNode {
+  /** Type identifier for assignment expressions */
+  type: 'AssignmentExpression'
+  /** Source code range */
+  range: [number, number]
+  /** Assignment operator */
+  operator:
+    | '='
+    | '+='
+    | '-='
+    | '*='
+    | '/='
+    | '%='
+    | '**='
+    | '<<='
+    | '>>='
+    | '>>>='
+    | '&='
+    | '^='
+    | '|='
+  /** Left side of the assignment */
+  left: ASTNode
+  /** Right side of the assignment */
+  right: ASTNode
+}

src/interfaces/AssignmentPattern.ts

@@ -0,0 +1,15 @@
+import type { ASTNode } from '@interfaces/index.ts'
+
+/**
+ * AST node representing an assignment pattern in destructuring.
+ */
+export interface AssignmentPatternNode {
+  /** Type identifier for assignment patterns */
+  type: 'AssignmentPattern'
+  /** Source code range */
+  range: [number, number]
+  /** Left side of the assignment pattern */
+  left: ASTNode
+  /** Right side of the assignment pattern */
+  right: ASTNode
+}

src/interfaces/AwaitExpression.ts

@@ -0,0 +1,11 @@
+import type { ASTNode } from '@interfaces/index.ts'
+
+/**
+ * AST node representing an await expression.
+ */
+export interface AwaitExpressionNode {
+  /** Type identifier for await expressions */
+  type: 'AwaitExpression'
+  /** Expression being awaited */
+  argument: ASTNode
+}

src/interfaces/BinaryExpression.ts

@@ -0,0 +1,40 @@
+import type { ASTNode } from '@interfaces/index.ts'
+
+/**
+ * AST node representing a binary expression.
+ */
+export interface BinaryExpressionNode {
+  /** Type identifier for binary expressions */
+  type: 'BinaryExpression'
+  /** Source code range */
+  range: [number, number]
+  /** Binary operator */
+  operator:
+    | '+'
+    | '-'
+    | '*'
+    | '/'
+    | '%'
+    | '**'
+    | '=='
+    | '!='
+    | '==='
+    | '!=='
+    | '<'
+    | '<='
+    | '>'
+    | '>='
+    | '<<'
+    | '>>'
+    | '>>>'
+    | '&'
+    | '^'
+    | '|'
+    | '&&'
+    | '||'
+    | '??'
+  /** Left side of the expression */
+  left: ASTNode
+  /** Right side of the expression */
+  right: ASTNode
+}

src/interfaces/BlockStatement.ts

@@ -0,0 +1,11 @@
+import type { ASTNode } from '@interfaces/index.ts'
+
+/**
+ * AST node representing a block statement (code block).
+ */
+export interface BlockStatementNode {
+  /** Type identifier for block statements */
+  type: 'BlockStatement'
+  /** Array of statements in the block */
+  body: Array<ASTNode>
+}

src/interfaces/BreakStatement.ts

@@ -0,0 +1,13 @@
+import type { IdentifierNode } from '@interfaces/index.ts'
+
+/**
+ * AST node representing a break statement.
+ */
+export interface BreakStatementNode {
+  /** Type identifier for break statements */
+  type: 'BreakStatement'
+  /** Source code range */
+  range: [number, number]
+  /** Optional label */
+  label?: IdentifierNode
+}