@memberjunction/react-test-harness 5.29.0 → 5.30.1

package/README.md

@@ -1,194 +1,181 @@
 # @memberjunction/react-test-harness
 
-Automated test harness for MemberJunction React components using Playwright. Provides static analysis (linting), constraint validation, browser-based rendering tests, and a CLI for running test suites against dynamically compiled components.
+Automated test harness for MemberJunction interactive React components. Provides static analysis (linting) with 57 extensible rules, type inference, constraint validation, browser-based rendering via Playwright, and a CLI for running test suites.
 
-## Architecture
+## Quick Start
+
+### Linting a Component
+
+```typescript
+import { ComponentLinter } from '@memberjunction/react-test-harness';
 
-```mermaid
-graph TD
-    subgraph "@memberjunction/react-test-harness"
-        A[TestHarness] --> B[ComponentLinter]
-        A --> C[ComponentRunner]
-        A --> D[BrowserContext]
-
-        B --> E[Type Inference Engine]
-        B --> F[Control Flow Analyzer]
-        B --> G[Prop Value Extractor]
-        B --> H[Styles Type Analyzer]
-
-        subgraph "Constraint Validators"
-            I[BaseConstraintValidator]
-            I --> J[RequiredWhenValidator]
-            I --> K[SQLWhereClauseValidator]
-            I --> L[SubsetOfEntityFieldsValidator]
-        end
-
-        C --> D
-        D --> M["Playwright Browser"]
-
-        N[CLI] --> A
-    end
-
-    subgraph "Dependencies"
-        O["@memberjunction/react-runtime<br/>(Component Compilation)"]
-        P["Babel Parser<br/>(AST Analysis)"]
-    end
-
-    B --> P
-    C --> O
-
-    style A fill:#2d6a9f,stroke:#1a4971,color:#fff
-    style B fill:#2d8659,stroke:#1a5c3a,color:#fff
-    style C fill:#2d8659,stroke:#1a5c3a,color:#fff
-    style D fill:#7c5295,stroke:#563a6b,color:#fff
-    style E fill:#b8762f,stroke:#8a5722,color:#fff
-    style I fill:#7c5295,stroke:#563a6b,color:#fff
-    style N fill:#2d6a9f,stroke:#1a4971,color:#fff
+const result = await ComponentLinter.lintComponent(
+  code,           // JavaScript/JSX source
+  'MyComponent',  // Component name
+  componentSpec,  // ComponentSpec with metadata
+  true,           // isRootComponent
+);
+
+if (!result.success) {
+  for (const v of result.violations) {
+    console.log(`[${v.severity}] ${v.rule}: ${v.message} (line ${v.line})`);
+  }
+}
 ```
 
-## Overview
+### Browser-Based Testing
 
-This package provides comprehensive testing for MemberJunction's dynamically compiled React components. It combines static analysis (without executing) and runtime testing (via Playwright) to validate components before deployment.
+```typescript
+import { ComponentRunner } from '@memberjunction/react-test-harness';
 
-**Key capabilities:**
+const runner = new ComponentRunner();
+const result = await runner.executeComponent(componentSpec, {
+  contextUser,
+  props: { data: testData },
+});
 
-- **Component Linting**: Static analysis of component source using Babel AST parsing
-- **Type Inference**: Infers component prop types from source code and usage patterns
-- **Constraint Validation**: Validates data constraints like SQL WHERE clauses, required-when conditions, and entity field subsets
-- **Control Flow Analysis**: Detects unreachable code, missing returns, and complex control flow patterns
-- **Browser Rendering**: Launches components in a real browser via Playwright for visual/functional testing
-- **Prop Value Extraction**: Extracts and validates prop values from JSX source
-- **Library Lint Caching**: Caches lint results for external libraries to improve performance
-- **CLI Tool**: `mj-react-test` command for running test suites
+console.log('Rendered:', result.success);
+console.log('Errors:', result.errors);
+```
 
-## Installation
+### Writing Custom Rules
 
-```bash
-npm install @memberjunction/react-test-harness
+Rules extend `BaseLintRule` and auto-register via `@RegisterClass`:
+
+```typescript
+import { RegisterClass } from '@memberjunction/global';
+import { BaseLintRule } from '@memberjunction/react-test-harness';
+
+@RegisterClass(BaseLintRule, 'my-custom-rule')
+export class MyCustomRule extends BaseLintRule {
+  get Name() { return 'my-custom-rule'; }
+  get AppliesTo(): 'all' | 'child' | 'root' { return 'all'; }
+
+  Test(ast, componentName, componentSpec, options, typeContext) {
+    const violations = [];
+    // Babel AST traversal and validation logic
+    return violations;
+  }
+}
 ```
 
-## Usage
+External packages (e.g., Skip-Brain) can define custom rules — the linter discovers them automatically via MJGlobal's ClassFactory.
 
-### CLI
+## Testing
 
 ```bash
-# Run the test harness
-npx mj-react-test
+cd packages/React/test-harness
 
-# Or if installed globally
-mj-react-test
-```
+# Build (required before testing)
+npm run build
 
-### Programmatic API
+# Run all 425 tests
+npx vitest run
 
-```typescript
-import { TestHarness } from '@memberjunction/react-test-harness';
+# Run with verbose output (see individual fixture results)
+npx vitest run --reporter=verbose
 
-const harness = new TestHarness();
+# Watch mode
+npx vitest
+```
+
+### Database Connection (Optional)
+
+Some rules validate against entity metadata from the database. Create `.env`:
 
-// Run all tests for a component
-const results = await harness.RunTests(componentSource, {
-    libraries: libraryConfigs,
-    entityMetadata: entityInfo
-});
+```
+DB_HOST=your-host
+DB_DATABASE=your-db
+DB_USERNAME=your-user
+DB_PASSWORD=your-password
+DB_PORT=1433
+DB_TRUST_SERVER_CERTIFICATE=1
 ```
 
-### Component Linting
+Without a database, DB-dependent fixtures still run but rules that need entity metadata emit low-severity warnings instead of violations.
 
-```typescript
-import { ComponentLinter } from '@memberjunction/react-test-harness';
+## Architecture
 
-const linter = new ComponentLinter();
-const lintResults = linter.Lint(componentSource, {
-    checkPropTypes: true,
-    checkControlFlow: true,
-    validateConstraints: true
-});
+See [LINTER-ARCHITECTURE.md](LINTER-ARCHITECTURE.md) for comprehensive documentation including:
+- How rules work and how to add new ones
+- Rule categories and what each validates
+- Type inference engine capabilities
+- Metadata fallback strategy
+- SQL dialect configuration
+- Test fixture organization
 
-for (const issue of lintResults.issues) {
-    console.log(`${issue.severity}: ${issue.message} (line ${issue.line})`);
-}
-```
+## Lint Rules (57)
 
-### Browser-Based Testing
+### Data Access (5 rules)
+- `runview-call-validation` — RunView/RunViews call-site validation
+- `runquery-call-validation` — RunQuery call-site validation with parameter type checking
+- `data-result-validation` — RunView/RunQuery/Search result usage patterns
+- `search-availability-check` — `utilities.search` null guard
+- `search-call-validation` — Search/PreviewSearch parameter validation
 
-```typescript
-import { ComponentRunner, BrowserContext } from '@memberjunction/react-test-harness';
+### Entity & Query Fields (4 rules)
+- `entity-field-access-validation` — Field access on RunView results (typos, case, type coercion)
+- `query-result-field-access-validation` — Field access on RunQuery results
+- `chart-field-validation` — Chart prop field references
+- `datagrid-field-validation` — Grid column field references
 
-const browser = await BrowserContext.Create();
-const runner = new ComponentRunner(browser);
+### Runtime Constraints (8 rules)
+- `no-import-statements`, `no-export-statements`, `no-require-statements`
+- `no-iife-wrapper`, `no-return-component`, `no-window-access`
+- `use-function-declaration`, `single-function-only`
 
-const result = await runner.Render(compiledComponent, {
-    props: { data: testData },
-    timeout: 5000
-});
+### Component Structure (9 rules)
+- `react-component-naming`, `component-name-mismatch`, `pass-standard-props`
+- `no-react-destructuring`, `no-data-prop`, `no-child-implementation`
+- `component-props-validation`, `child-component-prop-validation`
+- `component-usage-without-destructuring`
 
-console.log('Rendered successfully:', result.success);
-console.log('Console errors:', result.consoleErrors);
+### Dependencies (7 rules)
+- `component-not-in-dependencies`, `undefined-component-usage`
+- `unused-libraries`, `unused-component-dependencies`
+- `library-variable-names`, `dependency-shadowing`, `validate-component-references`
 
-await browser.Close();
-```
+### Callbacks & Events (1 consolidated rule)
+- `callback-event-validation` — Method usage, parameter signatures, passthrough, event null-checks
 
-### Constraint Validation
+### Best Practices (8 rules)
+- `prefer-async-await`, `prefer-jsx-syntax`, `react-hooks-rules`
+- `useeffect-unstable-dependencies`, `unsafe-array-operations`, `unsafe-formatting-methods`
+- `string-replace-all-occurrences`, `string-template-validation`
 
-```typescript
-import {
-    SQLWhereClauseValidator,
-    RequiredWhenValidator,
-    SubsetOfEntityFieldsValidator
-} from '@memberjunction/react-test-harness';
-
-// Validate a SQL WHERE clause
-const sqlValidator = new SQLWhereClauseValidator();
-const sqlResult = sqlValidator.Validate("Status = 'Active' AND Age > 18", context);
-
-// Validate required-when conditions
-const reqValidator = new RequiredWhenValidator();
-const reqResult = reqValidator.Validate("IsAdmin = true", context);
-
-// Validate field subset
-const subsetValidator = new SubsetOfEntityFieldsValidator();
-const subsetResult = subsetValidator.Validate(["Name", "Email", "Status"], context);
-```
+### Type Safety (2 rules)
+- `type-inference-errors`, `type-mismatch-operation`
 
-## Components
-
-| Component | Description |
-|-----------|-------------|
-| `TestHarness` | Main orchestrator for running all test types |
-| `ComponentLinter` | Static analysis of component source code |
-| `ComponentRunner` | Browser-based component rendering tests |
-| `BrowserContext` | Manages Playwright browser lifecycle |
-| `TypeInferenceEngine` | Infers prop types from source code |
-| `ControlFlowAnalyzer` | Detects control flow issues |
-| `PropValueExtractor` | Extracts and validates prop values |
-| `StylesTypeAnalyzer` | Analyzes component style patterns |
-| `LibraryLintCache` | Caches lint results for external libraries |
-| `LinterTestTool` | Testing utilities for linter development |
+### Styles (1 consolidated rule)
+- `styles-validation` — Invalid path access, unsafe patterns
 
-## Testing
+### Utilities (3 rules)
+- `utilities-api-validation`, `utilities-no-direct-instantiation`, `ai-tools-availability-check`
 
-```bash
-npm test
-npm run test:watch
-```
+### State & Settings (5 rules)
+- `saved-user-settings-pattern`, `noisy-settings-updates`, `prop-state-sync`
+- `property-name-consistency`, `server-reload-on-client-operation`
+
+### Other (4 rules)
+- `no-use-reducer`, `required-queries-not-called`
+- `undefined-jsx-component`, `no-child-implementation`
+
+## Exports
 
-Uses Vitest for unit testing.
-
-## Dependencies
-
-| Package | Purpose |
-|---------|---------|
-| `@memberjunction/react-runtime` | Component compilation and registry |
-| `@memberjunction/interactive-component-types` | Component type definitions |
-| `@memberjunction/core` | Core MJ functionality |
-| `@memberjunction/core-entities` | Entity types |
-| `@babel/parser` | AST parsing for static analysis |
-| `@babel/traverse` | AST traversal |
-| `@playwright/test` | Browser automation |
-| `commander` | CLI framework |
-| `chalk` | Terminal styling |
-| `node-sql-parser` | SQL WHERE clause validation |
+```typescript
+// Core linting
+export { ComponentLinter, LintResult, Violation } from './lib/component-linter';
+export { BaseLintRule } from './lib/lint-rule';
+
+// Test harness
+export { ReactTestHarness, TestHarnessOptions } from './lib/test-harness';
+export { ComponentRunner, ComponentExecutionOptions, ComponentExecutionResult } from './lib/component-runner';
+export { BrowserManager, BrowserContextOptions } from './lib/browser-context';
+
+// Utilities
+export { LibraryLintCache, CompiledLibraryRules, CompiledValidator } from './lib/library-lint-cache';
+export { ComponentSpec } from '@memberjunction/interactive-component-types';
+```
 
 ## License
 

package/dist/__tests__/setup/vitest-setup.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Vitest Setup File — Database Connection (runs in each test worker)
+ *
+ * Establishes a SQL Server connection and initializes the MJ metadata provider
+ * so that component linter tests can access entity metadata, library lint rules,
+ * and other database-dependent validation logic.
+ *
+ * Credentials are loaded from packages/React/test-harness/.env
+ */
+export {};
+//# sourceMappingURL=vitest-setup.d.ts.map

package/dist/__tests__/setup/vitest-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest-setup.d.ts","sourceRoot":"","sources":["../../../src/__tests__/setup/vitest-setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/__tests__/setup/vitest-setup.js

@@ -0,0 +1,73 @@
+/**
+ * Vitest Setup File — Database Connection (runs in each test worker)
+ *
+ * Establishes a SQL Server connection and initializes the MJ metadata provider
+ * so that component linter tests can access entity metadata, library lint rules,
+ * and other database-dependent validation logic.
+ *
+ * Credentials are loaded from packages/React/test-harness/.env
+ */
+import sql from 'mssql';
+import dotenv from 'dotenv';
+import path from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const ENV_PATH = path.resolve(__dirname, '../../../.env');
+let connectionPool = null;
+// Load .env
+dotenv.config({ path: ENV_PATH, override: true });
+const dbHost = process.env.DB_HOST || 'localhost';
+const dbPort = parseInt(process.env.DB_PORT || '1433', 10);
+const dbDatabase = process.env.DB_DATABASE;
+const dbUsername = process.env.DB_USERNAME;
+const dbPassword = process.env.DB_PASSWORD;
+const trustCert = process.env.DB_TRUST_SERVER_CERTIFICATE === '1';
+if (dbDatabase && dbUsername && dbPassword) {
+    const sqlConfig = {
+        server: dbHost,
+        port: dbPort,
+        database: dbDatabase,
+        user: dbUsername,
+        password: dbPassword,
+        options: {
+            encrypt: true,
+            trustServerCertificate: trustCert,
+            enableArithAbort: true,
+        },
+        pool: {
+            max: 10,
+            min: 2,
+            idleTimeoutMillis: 30000,
+        },
+    };
+    try {
+        connectionPool = new sql.ConnectionPool(sqlConfig);
+        await connectionPool.connect();
+        const { setupSQLServerClient, SQLServerProviderConfigData } = await import('@memberjunction/sqlserver-dataprovider');
+        const providerConfig = new SQLServerProviderConfigData(connectionPool, '__mj', 180000);
+        await setupSQLServerClient(providerConfig);
+        const { Metadata } = await import('@memberjunction/core');
+        const md = new Metadata();
+        console.log(`✅ MJ Provider initialized — ${md.Entities.length} entities loaded`);
+        process.env.__MJ_DB_AVAILABLE = 'true';
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        console.warn(`⚠️  Database connection failed — DB-dependent tests will be skipped.\n   Error: ${msg}`);
+        process.env.__MJ_DB_AVAILABLE = 'false';
+        if (connectionPool) {
+            try {
+                await connectionPool.close();
+            }
+            catch { /* ignore */ }
+            connectionPool = null;
+        }
+    }
+}
+else {
+    console.warn('⚠️  Database credentials not configured — DB-dependent tests will be skipped.\n' +
+        '   Set DB_HOST, DB_DATABASE, DB_USERNAME, DB_PASSWORD in .env to enable them.');
+}
+// Connection pool closes automatically when the process exits.
+// Don't use afterAll — vitest may run this setup per-file with tight hook timeouts.
+//# sourceMappingURL=vitest-setup.js.map

package/dist/__tests__/setup/vitest-setup.js.map

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

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export { BrowserManager, BrowserContextOptions } from './lib/browser-context.js'
 export { ComponentRunner, ComponentExecutionOptions, ComponentExecutionResult } from './lib/component-runner.js';
 export { AssertionHelpers } from './lib/assertion-helpers.js';
 export { ComponentLinter, LintResult, Violation } from './lib/component-linter.js';
+export { BaseLintRule } from './lib/lint-rule.js';
 export { LibraryLintCache, CompiledLibraryRules, CompiledValidator } from './lib/library-lint-cache.js';
 export { ComponentSpec } from '@memberjunction/interactive-component-types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9E,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAC9G,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACrG,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9E,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAC9G,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACrG,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC"}

package/dist/index.js

@@ -4,6 +4,7 @@ export { BrowserManager } from './lib/browser-context.js';
 export { ComponentRunner } from './lib/component-runner.js';
 export { AssertionHelpers } from './lib/assertion-helpers.js';
 export { ComponentLinter } from './lib/component-linter.js';
+export { BaseLintRule } from './lib/lint-rule.js';
 export { LibraryLintCache } from './lib/library-lint-cache.js';
 export { ComponentSpec } from '@memberjunction/interactive-component-types';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAsB,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAyB,MAAM,uBAAuB,CAAC;AAC9E,0EAA0E;AAC1E,OAAO,EAAE,eAAe,EAAuD,MAAM,wBAAwB,CAAC;AAC9G,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAyB,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAA2C,MAAM,0BAA0B,CAAC;AACrG,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAsB,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAyB,MAAM,uBAAuB,CAAC;AAC9E,0EAA0E;AAC1E,OAAO,EAAE,eAAe,EAAuD,MAAM,wBAAwB,CAAC;AAC9G,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAyB,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAA2C,MAAM,0BAA0B,CAAC;AACrG,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC"}

package/dist/lib/component-linter.d.ts

@@ -1,6 +1,8 @@
 import { ComponentSpec } from '@memberjunction/interactive-component-types';
 import type { UserInfo } from '@memberjunction/core';
 import { ComponentExecutionOptions } from './component-runner.js';
+import type { SQLParserDialect } from '@memberjunction/sql-dialect';
+import './runtime-rules/index.js';
 export interface LintResult {
     success: boolean;
     violations: Violation[];
@@ -27,25 +29,20 @@ export interface Violation {
     };
 }
 export declare class ComponentLinter {
-    private static stylesAnalyzer;
-    private static getStylesAnalyzer;
-    private static containsReturn;
-    private static isVariableFromRunQueryOrView;
-    private static universalComponentRules;
     static validateComponentSyntax(code: string, componentName: string): Promise<{
         valid: boolean;
         errors: string[];
     }>;
-    static lintComponent(code: string, componentName: string, componentSpec?: ComponentSpec, isRootComponent?: boolean, contextUser?: UserInfo, debugMode?: boolean, options?: ComponentExecutionOptions): Promise<LintResult>;
-    private static validateDataRequirements;
-    private static getFunctionName;
-    private static deduplicateViolations;
     /**
-     * Adds suggestions directly to violations based on their rule type
-     * @param violations Array of violations to enhance with suggestions
-     * @returns The same violations array with suggestions embedded
+     * The SQL dialect used for WHERE clause validation in semantic validators.
+     * Defaults to SQL Server. Set via the `sqlDialect` parameter on `lintComponent()`.
      */
-    private static addSuggestionsToViolations;
+    private static _sqlDialect;
+    /** Current SQL dialect used for WHERE clause parsing */
+    static get SqlDialect(): SQLParserDialect;
+    static lintComponent(code: string, componentName: string, componentSpec?: ComponentSpec, isRootComponent?: boolean, contextUser?: UserInfo, debugMode?: boolean, options?: ComponentExecutionOptions, sqlDialect?: SQLParserDialect): Promise<LintResult>;
+    private static validateDataRequirements;
+    private static deduplicateViolations;
     private static generateSyntaxErrorSuggestions;
     /**
      * Apply library-specific lint rules based on ComponentLibrary LintRules field

package/dist/lib/component-linter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component-linter.d.ts","sourceRoot":"","sources":["../../src/lib/component-linter.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,aAAa,EAAwD,MAAM,6CAA6C,CAAC;AAIlI,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAU/D,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,gBAAgB,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,cAAc,CAAC;IACnF,UAAU,CAAC,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AA0OD,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,cAAc,CAAqB;IAGlD,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAQhC,OAAO,CAAC,MAAM,CAAC,cAAc;IA8B7B,OAAO,CAAC,MAAM,CAAC,4BAA4B;IAyC3C,OAAO,CAAC,MAAM,CAAC,uBAAuB,CAk4PpC;WAEkB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;WAmC3G,aAAa,CAC/B,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EACrB,aAAa,CAAC,EAAE,aAAa,EAC7B,eAAe,CAAC,EAAE,OAAO,EACzB,WAAW,CAAC,EAAE,QAAQ,EACtB,SAAS,CAAC,EAAE,OAAO,EACnB,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,UAAU,CAAC;IA4KtB,OAAO,CAAC,MAAM,CAAC,wBAAwB;IA+avC,OAAO,CAAC,MAAM,CAAC,eAAe;IA2B9B,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAyBpC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,0BAA0B;IA4hCzC,OAAO,CAAC,MAAM,CAAC,8BAA8B;IA0B7C;;OAEG;mBACkB,qBAAqB;IA0H1C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAqDzC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,6BAA6B;IAwB5C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IA+BlC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IA+KpC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IA2DlC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;CAqGzC"}
+{"version":3,"file":"component-linter.d.ts","sourceRoot":"","sources":["../../src/lib/component-linter.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,aAAa,EAAwD,MAAM,6CAA6C,CAAC;AAGlI,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAS/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAGpE,OAAO,iBAAiB,CAAC;AAEzB,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,gBAAgB,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,cAAc,CAAC;IACnF,UAAU,CAAC,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,qBAAa,eAAe;WAEN,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAmC/H;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW,CAA6C;IAEvE,wDAAwD;IACxD,WAAkB,UAAU,IAAI,gBAAgB,CAE/C;WAEmB,aAAa,CAC/B,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EACrB,aAAa,CAAC,EAAE,aAAa,EAC7B,eAAe,CAAC,EAAE,OAAO,EACzB,WAAW,CAAC,EAAE,QAAQ,EACtB,SAAS,CAAC,EAAE,OAAO,EACnB,OAAO,CAAC,EAAE,yBAAyB,EACnC,UAAU,CAAC,EAAE,gBAAgB,GAC5B,OAAO,CAAC,UAAU,CAAC;IA2OtB,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAgbvC,OAAO,CAAC,MAAM,CAAC,qBAAqB;IA0BpC,OAAO,CAAC,MAAM,CAAC,8BAA8B;IA0B7C;;OAEG;mBACkB,qBAAqB;IA0H1C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAqDzC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,6BAA6B;IAwB5C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IA+BlC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IA+KpC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IA2DlC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;CAqGzC"}