refactor: Add lines-around-comment rule

I often struggle with spacing around block comments, so I've decided to add the `lines-around-comment` lint rule to help manage this.

For more details, see the https://eslint.org/docs/latest/rules/lines-around-comment

Author: alan-agius4

.eslintrc.json

@@ -68,6 +68,16 @@
         "groups": [["builtin", "external"], "parent", "sibling", "index"]
       }
     ],
+    "lines-around-comment": [
+      "error",
+      {
+        "beforeBlockComment": true,
+        "allowClassStart": true,
+        "allowBlockStart": true,
+        "allowObjectStart": true,
+        "allowArrayStart": true
+      }
+    ],
     "max-len": [
       "error",
       {

packages/angular/build/src/builders/dev-server/vite-server.ts

@@ -709,6 +709,7 @@ function getDepOptimizationConfig({
 }
 
 const nodeJsBuiltinModules = new Set(builtinModules);
+
 /** Remove any Node.js builtin modules to avoid Vite's prebundling from processing them as files. */
 function removeNodeJsBuiltinModules(value: string): boolean {
   return !nodeJsBuiltinModules.has(value);

packages/angular/build/src/tools/esbuild/angular/compiler-plugin.ts

@@ -39,6 +39,7 @@ export interface CompilerPluginOptions {
   sourcemap: boolean | 'external';
   tsconfig: string;
   jit?: boolean;
+
   /** Skip TypeScript compilation setup. This is useful to re-use the TypeScript compilation from another plugin. */
   noopTypeScriptCompilation?: boolean;
   advancedOptimizations?: boolean;

packages/angular/build/src/tools/esbuild/i18n-inliner-worker.ts

@@ -22,10 +22,12 @@ interface InlineRequest {
    * during Worker initialization.
    */
   filename: string;
+
   /**
    * The locale specifier that should be used during the inlining process of the file.
    */
   locale: string;
+
   /**
    * The translation messages for the locale that should be used during the inlining process of the file.
    */

packages/angular/build/src/tools/esbuild/stylesheets/css-inline-fonts-plugin.ts

@@ -18,6 +18,7 @@ import { LoadResultCache, createCachedLoad } from '../load-result-cache';
 export interface CssInlineFontsPluginOptions {
   /** Disk cache normalized options */
   cacheOptions?: NormalizedCachedOptions;
+
   /** Load results cache. */
   cache?: LoadResultCache;
 }

packages/angular/build/src/tools/esbuild/stylesheets/stylesheet-plugin-factory.ts

@@ -190,6 +190,7 @@ export class StylesheetPluginFactory {
   }
 
   private initPostcssCallCount = 0;
+
   /**
    * This method should not be called directly.
    * Use {@link setupPostcss} instead.

packages/angular/build/src/tools/esbuild/virtual-module-plugin.ts

@@ -16,17 +16,22 @@ import { LoadResultCache, createCachedLoad } from './load-result-cache';
 export interface VirtualModulePluginOptions {
   /** Namespace. Example: `angular:polyfills`. */
   namespace: string;
+
   /** If the generated module should be marked as external. */
   external?: boolean;
+
   /** Method to transform the onResolve path. */
   transformPath?: (path: string) => string;
+
   /** Method to provide the module content. */
   loadContent: (
     args: OnLoadArgs,
     build: PluginBuild,
   ) => ReturnType<Parameters<PluginBuild['onLoad']>[1]>;
+
   /** Restrict to only entry points. Defaults to `true`. */
   entryPointOnly?: boolean;
+
   /** Load results cache. */
   cache?: LoadResultCache;
 }

packages/angular/build/src/tools/esbuild/wasm-plugin.ts

@@ -21,6 +21,7 @@ import { LoadResultCache, createCachedLoad } from './load-result-cache';
 export interface WasmPluginOptions {
   /** Allow generation of async (proposal compliant) WASM imports. This requires zoneless to enable async/await. */
   allowAsync?: boolean;
+
   /** Load results cache. */
   cache?: LoadResultCache;
 }

packages/angular/build/src/tools/sass/sass-service.ts

@@ -52,6 +52,7 @@ export interface SerializableVersion {
 export interface SerializableDeprecation extends Omit<Deprecation, 'obsoleteIn' | 'deprecatedIn'> {
   /** The version this deprecation first became active in. */
   deprecatedIn: SerializableVersion | null;
+
   /** The version this deprecation became obsolete in. */
   obsoleteIn: SerializableVersion | null;
 }

packages/angular/build/src/tools/sass/worker.ts

@@ -35,21 +35,25 @@ interface RenderRequestMessage {
    * The contents to compile.
    */
   source: string;
+
   /**
    * The Sass options to provide to the `dart-sass` compile function.
    */
   options: Omit<StringOptions<'sync'>, 'url'> & { url: string };
+
   /**
    * Indicates the request has a custom importer function on the main thread.
    */
   importerChannel?: {
     port: MessagePort;
     signal: Int32Array;
   };
+
   /**
    * Indicates the request has a custom logger for warning messages.
    */
   hasLogger: boolean;
+
   /**
    * Indicates paths within url() CSS functions should be rebased.
    */