@memberjunction/react-linter 0.0.1 → 5.38.0

package/dist/component-linter.d.ts

@@ -0,0 +1,77 @@
+import { ComponentSpec } from '@memberjunction/interactive-component-types';
+import type { UserInfo } from '@memberjunction/core';
+import type { LinterOptions } from './linter-options.js';
+import type { SQLParserDialect } from '@memberjunction/sql-dialect';
+import './runtime-rules/index.js';
+export interface LintResult {
+    success: boolean;
+    violations: Violation[];
+    criticalCount?: number;
+    highCount?: number;
+    mediumCount?: number;
+    lowCount?: number;
+    hasErrors: boolean;
+}
+export interface LintOptions {
+    debugMode?: boolean;
+}
+export interface Violation {
+    rule: string;
+    severity: 'critical' | 'high' | 'medium' | 'low';
+    line: number;
+    column: number;
+    message: string;
+    code?: string;
+    source?: 'user-component' | 'runtime-wrapper' | 'react-framework' | 'test-harness';
+    suggestion?: {
+        text: string;
+        example?: string;
+    };
+}
+export declare class ComponentLinter {
+    static validateComponentSyntax(code: string, componentName: string): Promise<{
+        valid: boolean;
+        errors: string[];
+    }>;
+    /**
+     * The SQL dialect used for WHERE clause validation in semantic validators.
+     * Defaults to SQL Server. Set via the `sqlDialect` parameter on `lintComponent()`.
+     */
+    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?: LinterOptions, sqlDialect?: SQLParserDialect): Promise<LintResult>;
+    private static validateDataRequirements;
+    private static deduplicateViolations;
+    private static generateSyntaxErrorSuggestions;
+    /**
+     * Apply library-specific lint rules based on ComponentLibrary LintRules field
+     */
+    private static applyLibraryLintRules;
+    /**
+     * Check library initialization patterns (constructor, element type, etc.)
+     */
+    private static checkLibraryInitialization;
+    /**
+     * Check if a library is directly instantiated in the component code
+     * Returns false if the library is only used indirectly (e.g., by dependency components)
+     */
+    private static isLibraryDirectlyInstantiated;
+    /**
+     * Check if a ref is attached to the correct element type
+     */
+    private static checkRefElementType;
+    /**
+     * Check library lifecycle methods (render, destroy, etc.)
+     */
+    private static checkLibraryLifecycle;
+    /**
+     * Check library options and configuration
+     */
+    private static checkLibraryOptions;
+    /**
+     * Execute pre-compiled validators from cache
+     */
+    private static executeCompiledValidators;
+}
+//# sourceMappingURL=component-linter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"component-linter.d.ts","sourceRoot":"","sources":["../src/component-linter.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,aAAa,EAAwD,MAAM,6CAA6C,CAAC;AAGlI,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAStD,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,aAAa,EACvB,UAAU,CAAC,EAAE,gBAAgB,GAC5B,OAAO,CAAC,UAAU,CAAC;IA4OtB,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"}