@hatem427/code-guard-ci 1.0.0

package/config/react.config.ts

@@ -0,0 +1,330 @@
+/**
+ * ============================================================================
+ * react.config.ts — React-specific coding rules
+ * ============================================================================
+ *
+ * Registers rules that only apply to React projects:
+ *   - Hook usage patterns
+ *   - Props/state typing
+ *   - Component patterns
+ *   - Performance anti-patterns
+ */
+
+import { registerRules, Rule } from './guidelines.config';
+
+const reactRules: Rule[] = [
+  // ── Hooks ──────────────────────────────────────────────────────────────
+
+  {
+    id: 'react-no-useeffect-no-deps',
+    label: 'useEffect must have dependency array',
+    description:
+      'Every useEffect must have a dependency array. Missing deps causes infinite re-renders or stale closures.',
+    severity: 'error',
+    fileExtensions: ['tsx', 'jsx', 'ts', 'js'],
+    pattern: null,
+    customCheck: (file) => {
+      const violations: Array<{ line: number | null; message: string }> = [];
+      const lines: string[] = file.lines;
+
+      for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+
+        // Detect useEffect( without a closing bracket on subsequent lines containing dependency array
+        if (/useEffect\s*\(\s*\(\s*\)\s*=>\s*\{/.test(line)) {
+          // Look ahead for the closing of useEffect — find , [] or , [deps])
+          let foundDeps = false;
+          let parenDepth = 0;
+          for (let j = i; j < Math.min(i + 50, lines.length); j++) {
+            for (const ch of lines[j]) {
+              if (ch === '(') parenDepth++;
+              if (ch === ')') parenDepth--;
+            }
+            // Check if the dependency array is present
+            if (/\]\s*\)\s*;?\s*$/.test(lines[j]) || /,\s*\[/.test(lines[j])) {
+              foundDeps = true;
+              break;
+            }
+            if (parenDepth <= 0) break;
+          }
+
+          if (!foundDeps) {
+            violations.push({
+              line: i + 1,
+              message: 'useEffect without dependency array detected. Always specify dependencies.',
+            });
+          }
+        }
+      }
+
+      return violations;
+    },
+    applicableTo: ['react', 'nextjs'],
+    category: 'React Hooks',
+  },
+
+  {
+    id: 'react-no-inline-styles',
+    label: 'No inline style objects',
+    description:
+      'Avoid inline style={{ }} in JSX. Use Tailwind classes or CSS modules for consistent styling.',
+    severity: 'warning',
+    fileExtensions: ['tsx', 'jsx'],
+    pattern: /style\s*=\s*\{\s*\{/g,
+    applicableTo: ['react', 'nextjs'],
+    category: 'Styling',
+  },
+
+  {
+    id: 'react-no-direct-dom',
+    label: 'No direct DOM manipulation',
+    description:
+      'Avoid document.getElementById, querySelector, etc. Use useRef() and React state instead.',
+    severity: 'error',
+    fileExtensions: ['tsx', 'jsx', 'ts', 'js'],
+    pattern: /document\.(getElementById|querySelector|querySelectorAll|getElementsBy)/g,
+    applicableTo: ['react', 'nextjs'],
+    category: 'React Patterns',
+  },
+
+  // ── Component patterns ─────────────────────────────────────────────────
+
+  {
+    id: 'react-prefer-fc-typing',
+    label: 'Type component props explicitly',
+    description:
+      'Define a Props interface/type and use it. Avoid React.FC — type props parameter directly.',
+    severity: 'info',
+    fileExtensions: ['tsx'],
+    pattern: /React\.FC/g,
+    applicableTo: ['react', 'nextjs'],
+    category: 'TypeScript',
+  },
+
+  {
+    id: 'react-no-prop-spreading',
+    label: 'Avoid prop spreading ({...props})',
+    description:
+      'Spreading props makes component APIs unclear. Explicitly pass required props for better readability and TypeScript safety.',
+    severity: 'info',
+    fileExtensions: ['tsx', 'jsx'],
+    pattern: /\{\s*\.\.\.\w+\s*\}/g,
+    applicableTo: ['react', 'nextjs'],
+    category: 'React Patterns',
+  },
+
+  // ── Security Rules ─────────────────────────────────────────────────────
+
+  {
+    id: 'react-no-dangerously-set-html',
+    label: 'No dangerouslySetInnerHTML',
+    description:
+      'Using dangerouslySetInnerHTML opens your app to XSS attacks. Sanitize HTML or use safe alternatives.',
+    severity: 'error',
+    fileExtensions: ['tsx', 'jsx'],
+    pattern: /dangerouslySetInnerHTML/g,
+    applicableTo: ['react', 'nextjs'],
+    category: 'Security',
+  },
+
+  {
+    id: 'no-eval',
+    label: 'No eval() usage',
+    description:
+      'eval() allows arbitrary code execution and is a major security vulnerability. Use JSON.parse() or other safe alternatives.',
+    severity: 'error',
+    fileExtensions: ['tsx', 'jsx', 'ts', 'js'],
+    pattern: /\beval\s*\(/g,
+    applicableTo: ['react', 'nextjs'],
+    category: 'Security',
+  },
+
+  {
+    id: 'no-hardcoded-credentials',
+    label: 'No hardcoded credentials',
+    description:
+      'Never hardcode API keys, passwords, or secrets. Use environment variables instead.',
+    severity: 'error',
+    fileExtensions: ['tsx', 'jsx', 'ts', 'js'],
+    pattern: null,
+    customCheck: (file) => {
+      const violations: Array<{ line: number | null; message: string }> = [];
+      const lines = file.lines;
+      const suspiciousPatterns = [
+        /password\s*[=:]\s*["'`][^"'`]+["'`]/i,
+        /apikey\s*[=:]\s*["'`][^"'`]+["'`]/i,
+        /api_key\s*[=:]\s*["'`][^"'`]+["'`]/i,
+        /secret\s*[=:]\s*["'`][^"'`]+["'`]/i,
+        /token\s*[=:]\s*["'`][^"'`]{20,}["'`]/i,
+      ];
+
+      for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        for (const pattern of suspiciousPatterns) {
+          if (pattern.test(line)) {
+            violations.push({
+              line: i + 1,
+              message: `Potential hardcoded credential detected. Use environment variables: process.env.API_KEY`,
+            });
+            break;
+          }
+        }
+      }
+
+      return violations;
+    },
+    applicableTo: ['react', 'nextjs', 'angular'],
+    category: 'Security',
+  },
+
+  {
+    id: 'require-https',
+    label: 'Require HTTPS URLs',
+    description:
+      'HTTP URLs are insecure. Always use HTTPS for API calls and external resources.',
+    severity: 'warning',
+    fileExtensions: ['tsx', 'jsx', 'ts', 'js'],
+    pattern: /['"`]http:\/\/(?!localhost|127\.0\.0\.1)/g,
+    applicableTo: ['react', 'nextjs', 'angular'],
+    category: 'Security',
+  },
+
+  // ── Performance Rules ──────────────────────────────────────────────────
+
+  {
+    id: 'react-no-anonymous-functions-in-render',
+    label: 'No anonymous functions in JSX',
+    description:
+      'Anonymous functions in JSX props cause unnecessary re-renders. Use useCallback or define functions outside render.',
+    severity: 'warning',
+    fileExtensions: ['tsx', 'jsx'],
+    pattern: /onClick\s*=\s*\{\s*\(\s*\)\s*=>/g,
+    applicableTo: ['react', 'nextjs'],
+    category: 'Performance',
+  },
+
+  {
+    id: 'react-missing-key-prop',
+    label: 'Missing key prop in list',
+    description:
+      'When rendering lists with .map(), always provide a unique key prop for optimal reconciliation.',
+    severity: 'error',
+    fileExtensions: ['tsx', 'jsx'],
+    pattern: null,
+    customCheck: (file) => {
+      const violations: Array<{ line: number | null; message: string }> = [];
+      const lines = file.lines;
+
+      for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Detect .map( with JSX but no key prop nearby
+        if (/\.\s*map\s*\(/.test(line)) {
+          // Look ahead for JSX opening tag
+          let foundKey = false;
+          for (let j = i; j < Math.min(i + 10, lines.length); j++) {
+            if (/key\s*=/.test(lines[j])) {
+              foundKey = true;
+              break;
+            }
+          }
+          
+          // Check if there's JSX in the map
+          let hasJsx = false;
+          for (let j = i; j < Math.min(i + 10, lines.length); j++) {
+            if (/<[A-Z]/.test(lines[j]) || /<[a-z]/.test(lines[j])) {
+              hasJsx = true;
+              break;
+            }
+          }
+
+          if (hasJsx && !foundKey) {
+            violations.push({
+              line: i + 1,
+              message: 'List items rendered with .map() must have a key prop',
+            });
+          }
+        }
+      }
+
+      return violations;
+    },
+    applicableTo: ['react', 'nextjs'],
+    category: 'Performance',
+  },
+
+  {
+    id: 'no-large-bundle-imports',
+    label: 'Avoid large library imports',
+    description:
+      'Importing entire lodash or moment.js increases bundle size. Use specific imports: import get from "lodash/get"',
+    severity: 'warning',
+    fileExtensions: ['tsx', 'jsx', 'ts', 'js'],
+    pattern: /import\s+(?:(?:\*\s+as\s+\w+)|(?:\{\s*[^}]{50,}\s*\}))\s+from\s+['"](?:lodash|moment)['"];?$/gm,
+    applicableTo: ['react', 'nextjs', 'angular'],
+    category: 'Performance',
+  },
+
+  // ── Accessibility Rules ────────────────────────────────────────────────
+
+  {
+    id: 'require-alt-text',
+    label: 'Images must have alt text',
+    description:
+      'All <img> tags must have alt attribute for accessibility. Use empty alt="" for decorative images.',
+    severity: 'error',
+    fileExtensions: ['tsx', 'jsx'],
+    pattern: null,
+    customCheck: (file) => {
+      const violations: Array<{ line: number | null; message: string }> = [];
+      const lines = file.lines;
+
+      for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Match <img without alt or with empty src
+        if (/<img\b/.test(line) && !/alt\s*=/.test(line)) {
+          violations.push({
+            line: i + 1,
+            message: '<img> tag must have alt attribute for accessibility',
+          });
+        }
+      }
+
+      return violations;
+    },
+    applicableTo: ['react', 'nextjs'],
+    category: 'Accessibility',
+  },
+
+  {
+    id: 'require-button-type',
+    label: 'Buttons must have type attribute',
+    description:
+      'Always specify type="button", type="submit", or type="reset" on <button> elements to avoid unexpected form submissions.',
+    severity: 'warning',
+    fileExtensions: ['tsx', 'jsx'],
+    pattern: null,
+    customCheck: (file) => {
+      const violations: Array<{ line: number | null; message: string }> = [];
+      const lines = file.lines;
+
+      for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (/<button\b/.test(line) && !/type\s*=/.test(line)) {
+          violations.push({
+            line: i + 1,
+            message: '<button> should have explicit type attribute',
+          });
+        }
+      }
+
+      return violations;
+    },
+    applicableTo: ['react', 'nextjs'],
+    category: 'Accessibility',
+  },
+];
+
+// Register all React-specific rules
+registerRules('react', reactRules);
+
+export { reactRules };

package/dist/config/angular.config.d.ts

@@ -0,0 +1,15 @@
+/**
+ * ============================================================================
+ * angular.config.ts — Angular-specific coding rules
+ * ============================================================================
+ *
+ * Registers rules that only apply to Angular projects:
+ *   - ngOnInit misuse
+ *   - Deprecated APIs (::ng-deep, CommonModule, ngClass, ngStyle)
+ *   - Function calls in templates
+ *   - RxJS best practices (async pipe, takeUntilDestroyed, signals)
+ */
+import { Rule } from './guidelines.config';
+declare const angularRules: Rule[];
+export { angularRules };
+//# sourceMappingURL=angular.config.d.ts.map

package/dist/config/angular.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"angular.config.d.ts","sourceRoot":"","sources":["../../config/angular.config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAiB,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE1D,QAAA,MAAM,YAAY,EAAE,IAAI,EA2MvB,CAAC;AAKF,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/config/angular.config.js

@@ -0,0 +1,187 @@
+"use strict";
+/**
+ * ============================================================================
+ * angular.config.ts — Angular-specific coding rules
+ * ============================================================================
+ *
+ * Registers rules that only apply to Angular projects:
+ *   - ngOnInit misuse
+ *   - Deprecated APIs (::ng-deep, CommonModule, ngClass, ngStyle)
+ *   - Function calls in templates
+ *   - RxJS best practices (async pipe, takeUntilDestroyed, signals)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.angularRules = void 0;
+const guidelines_config_1 = require("./guidelines.config");
+const angularRules = [
+    // ── Lifecycle ──────────────────────────────────────────────────────────
+    {
+        id: 'angular-no-ngoninit',
+        label: 'Avoid ngOnInit for simple initialization',
+        description: 'Prefer constructor injection and field initializers. Use ngOnInit only when you need DOM access or @Input values. Modern Angular recommends inject() + signals.',
+        severity: 'warning',
+        fileExtensions: ['ts'],
+        pattern: /ngOnInit\s*\(\s*\)/g,
+        applicableTo: ['angular'],
+        category: 'Angular Lifecycle',
+    },
+    // ── Deprecated APIs ────────────────────────────────────────────────────
+    {
+        id: 'angular-no-ng-deep',
+        label: 'No ::ng-deep',
+        description: '::ng-deep is deprecated. Use :host, CSS custom properties, or component styling APIs instead.',
+        severity: 'error',
+        fileExtensions: ['css', 'scss', 'sass', 'less', 'ts'],
+        pattern: /::ng-deep/g,
+        applicableTo: ['angular'],
+        category: 'Angular Deprecated APIs',
+    },
+    {
+        id: 'angular-no-common-module',
+        label: 'No CommonModule import in standalone components',
+        description: 'Standalone components should import specific directives (NgIf, NgFor, etc.) instead of the entire CommonModule. Better yet, use @if/@for control flow.',
+        severity: 'warning',
+        fileExtensions: ['ts'],
+        pattern: /CommonModule/g,
+        applicableTo: ['angular'],
+        category: 'Angular Deprecated APIs',
+    },
+    {
+        id: 'angular-no-ngclass',
+        label: 'No [ngClass] — use [class] binding or Tailwind',
+        description: 'Prefer [class.name]="condition" binding or Tailwind dynamic classes over [ngClass]. It is cleaner and more performant.',
+        severity: 'warning',
+        fileExtensions: ['html', 'ts'],
+        pattern: /\[ngClass\]/g,
+        applicableTo: ['angular'],
+        category: 'Angular Deprecated APIs',
+    },
+    {
+        id: 'angular-no-ngstyle',
+        label: 'No [ngStyle] — use [style] binding or Tailwind',
+        description: 'Prefer [style.property]="value" binding or Tailwind utilities over [ngStyle].',
+        severity: 'warning',
+        fileExtensions: ['html', 'ts'],
+        pattern: /\[ngStyle\]/g,
+        applicableTo: ['angular'],
+        category: 'Angular Deprecated APIs',
+    },
+    // ── Template best practices ────────────────────────────────────────────
+    {
+        id: 'angular-no-function-in-template',
+        label: 'No function calls in templates',
+        description: 'Avoid calling functions in Angular templates — they run on every change detection cycle. Use pipes, computed signals, or memoized getters instead.',
+        severity: 'error',
+        fileExtensions: ['html'],
+        pattern: null,
+        customCheck: (file) => {
+            const violations = [];
+            /**
+             * Regex explanation:
+             * Match patterns like {{ someFunc() }} or (click)="handler()" but EXCLUDE:
+             *   - Event handlers: (click)="...", (submit)="...", on*="..."
+             *   - Known safe pipes: | async, | date, | json, etc.
+             *   - Structural directives: *ngIf, *ngFor, @if, @for
+             *
+             * We look for interpolation bindings {{ expr() }} and property bindings [prop]="expr()"
+             * that contain function calls which are NOT event bindings.
+             */
+            const interpolationRegex = /\{\{[^}]*\w+\s*\([^)]*\)[^}]*\}\}/g;
+            const propertyBindingRegex = /\[(?!click|submit|keyup|keydown|change|input|focus|blur)\w+\]\s*=\s*"[^"]*\w+\s*\([^)]*\)[^"]*"/g;
+            for (let i = 0; i < file.lines.length; i++) {
+                const line = file.lines[i];
+                // Check interpolation bindings {{ func() }}
+                interpolationRegex.lastIndex = 0;
+                if (interpolationRegex.test(line)) {
+                    // Exclude pipe usages like {{ value | pipeName }}
+                    const trimmed = line.trim();
+                    if (!trimmed.includes(' | ')) {
+                        violations.push({
+                            line: i + 1,
+                            message: `Function call in interpolation: "${trimmed}". Use a pipe or signal instead.`,
+                        });
+                    }
+                }
+                // Check property bindings [prop]="func()"
+                propertyBindingRegex.lastIndex = 0;
+                if (propertyBindingRegex.test(line)) {
+                    violations.push({
+                        line: i + 1,
+                        message: `Function call in property binding: "${line.trim()}". Use a signal or memoized getter.`,
+                    });
+                }
+            }
+            return violations;
+        },
+        applicableTo: ['angular'],
+        category: 'Angular Templates',
+    },
+    // ── RxJS best practices ────────────────────────────────────────────────
+    {
+        id: 'angular-use-async-pipe',
+        label: 'Use async pipe or toSignal() instead of manual subscribe',
+        description: 'Manual .subscribe() in components leads to memory leaks. Use the async pipe in templates or convert to signals with toSignal().',
+        severity: 'warning',
+        fileExtensions: ['ts'],
+        pattern: /\.subscribe\s*\(/g,
+        applicableTo: ['angular'],
+        category: 'RxJS',
+    },
+    {
+        id: 'angular-use-takeuntildestroyed',
+        label: 'Use takeUntilDestroyed() for subscriptions',
+        description: 'If you must subscribe manually, use takeUntilDestroyed() from @angular/core/rxjs-interop to auto-unsubscribe.',
+        severity: 'warning',
+        fileExtensions: ['ts'],
+        pattern: null,
+        customCheck: (file) => {
+            const violations = [];
+            // Only check Angular component/directive/service files
+            if (!file.content.includes('@Component') &&
+                !file.content.includes('@Directive') &&
+                !file.content.includes('@Injectable')) {
+                return [];
+            }
+            const hasSubscribe = /\.subscribe\s*\(/.test(file.content);
+            const hasTakeUntilDestroyed = file.content.includes('takeUntilDestroyed');
+            const hasAsyncPipe = file.content.includes('| async') || file.content.includes('toSignal');
+            if (hasSubscribe && !hasTakeUntilDestroyed && !hasAsyncPipe) {
+                violations.push({
+                    line: null,
+                    message: 'Manual .subscribe() found without takeUntilDestroyed(). Add pipe(takeUntilDestroyed()) or use async pipe / toSignal().',
+                });
+            }
+            return violations;
+        },
+        applicableTo: ['angular'],
+        category: 'RxJS',
+    },
+    {
+        id: 'angular-prefer-signals',
+        label: 'Consider using Angular Signals',
+        description: 'Angular 16+ supports Signals for reactive state. Consider using signal(), computed(), and effect() for simpler reactivity.',
+        severity: 'info',
+        fileExtensions: ['ts'],
+        pattern: null,
+        customCheck: (file) => {
+            // Only flag if the component uses BehaviorSubject but no signals
+            const hasBehaviorSubject = file.content.includes('BehaviorSubject');
+            const hasSignal = file.content.includes('signal(') || file.content.includes('computed(');
+            if (hasBehaviorSubject && !hasSignal) {
+                return [
+                    {
+                        line: null,
+                        message: 'BehaviorSubject detected. Consider migrating to Angular Signals (signal(), computed()) for simpler state management.',
+                    },
+                ];
+            }
+            return [];
+        },
+        applicableTo: ['angular'],
+        category: 'Angular Signals',
+    },
+];
+exports.angularRules = angularRules;
+// Register all Angular-specific rules
+(0, guidelines_config_1.registerRules)('angular', angularRules);
+//# sourceMappingURL=angular.config.js.map

package/dist/config/angular.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"angular.config.js","sourceRoot":"","sources":["../../config/angular.config.ts"],"names":[],"mappings":"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"}

package/dist/config/guidelines.config.d.ts

@@ -0,0 +1,63 @@
+/**
+ * ============================================================================
+ * guidelines.config.ts — Central guidelines configuration
+ * ============================================================================
+ *
+ * Defines the shape of a rule, severity levels, and the shared rule registry.
+ * Each project-type config (angular, react, nextjs) plugs into this registry.
+ */
+import { ProjectType } from '../scripts/utils/project-detector';
+export type Severity = 'error' | 'warning' | 'info';
+export interface Rule {
+    /** Unique identifier — used in reports and inline suppressions */
+    id: string;
+    /** Human-readable label for logs and checklists */
+    label: string;
+    /** Detailed description of what the rule checks */
+    description: string;
+    /** Severity: 'error' blocks commit, 'warning' allows but logs, 'info' is advisory */
+    severity: Severity;
+    /**
+     * Which file extensions this rule applies to.
+     * Empty array = all files.
+     */
+    fileExtensions: string[];
+    /**
+     * Regex pattern to search for inside file content.
+     * If set, the rule engine will scan each line for this pattern.
+     * `null` means the rule uses a custom checker function instead.
+     */
+    pattern: RegExp | null;
+    /**
+     * Optional custom checker function for complex rules that cannot be
+     * expressed as a simple regex. Receives the file info and returns
+     * an array of violation objects.
+     */
+    customCheck?: (file: any) => Array<{
+        line: number | null;
+        message: string;
+    }>;
+    /**
+     * Which project types this rule applies to.
+     * Empty array = all project types.
+     */
+    applicableTo: ProjectType[];
+    /** Category for grouping in the PR checklist */
+    category: string;
+}
+export declare const sharedRules: Rule[];
+/**
+ * Register rules for a specific project type.
+ * Called by angular.config.ts, react.config.ts, nextjs.config.ts.
+ */
+export declare function registerRules(projectType: ProjectType, rules: Rule[]): void;
+/**
+ * Get all applicable rules for a detected project type.
+ * Merges shared rules with project-specific rules.
+ */
+export declare function getRulesForProject(projectType: ProjectType): Rule[];
+/**
+ * Get ALL rules across all project types (used for PR checklist generation).
+ */
+export declare function getAllRules(): Rule[];
+//# sourceMappingURL=guidelines.config.d.ts.map

package/dist/config/guidelines.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guidelines.config.d.ts","sourceRoot":"","sources":["../../config/guidelines.config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAIhE,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAIpD,MAAM,WAAW,IAAI;IACnB,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IAEX,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IAEd,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IAEpB,qFAAqF;IACrF,QAAQ,EAAE,QAAQ,CAAC;IAEnB;;;OAGG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB;;;;OAIG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAE7E;;;OAGG;IACH,YAAY,EAAE,WAAW,EAAE,CAAC;IAE5B,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,eAAO,MAAM,WAAW,EAAE,IAAI,EAoH7B,CAAC;AAMF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,CAG3E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,EAAE,CASnE;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,EAAE,CAiBpC"}