@memberjunction/react-linter 0.0.1 → 5.38.0

package/dist/runtime-rules/search-availability-check.js

@@ -0,0 +1,220 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { traverse } from '../lint-utils.js';
+import * as t from '@babel/types';
+import { RegisterClass } from '@memberjunction/global';
+import { BaseLintRule } from '../lint-rule.js';
+/**
+ * Rule: search-availability-check
+ *
+ * Checks that `utilities.search` is guarded with a null/undefined check before use.
+ * The `search` property on the utilities object may be undefined if the search
+ * provider is not configured or available. Accessing methods on it without a guard
+ * will throw a runtime error.
+ *
+ * Correct patterns:
+ *   if (utilities.search) { await utilities.search.Search(...); }
+ *   const result = await utilities.search?.Search(...);
+ *
+ * Incorrect pattern:
+ *   const result = await utilities.search.Search(...);
+ *
+ * Severity: medium
+ * Applies to: all components
+ */
+/**
+ * Checks if a NodePath is inside a guard that checks `utilities.search` for truthiness.
+ * Recognized guard patterns:
+ *   - if (utilities.search) { ... }
+ *   - if (utilities.search != null) { ... }
+ *   - utilities.search && ...
+ */
+function isInsideSearchGuard(path) {
+    let current = path.parentPath;
+    while (current) {
+        // Check if statements
+        if (current.isIfStatement()) {
+            if (testChecksUtilitiesSearch(current.node.test)) {
+                if (isInConsequent(path.node, current.node)) {
+                    return true;
+                }
+            }
+        }
+        // Check logical && guards: utilities.search && utilities.search.Search(...)
+        if (current.isLogicalExpression() && current.node.operator === '&&') {
+            if (testChecksUtilitiesSearch(current.node.left)) {
+                return true;
+            }
+        }
+        // Check ternary: utilities.search ? utilities.search.Search(...) : null
+        if (current.isConditionalExpression()) {
+            if (testChecksUtilitiesSearch(current.node.test)) {
+                return true;
+            }
+        }
+        // Check try/catch: try { utilities.search.Search(...) } catch { ... }
+        if (current.isTryStatement()) {
+            return true;
+        }
+        // Check for early-return guard in enclosing function:
+        // if (!utilities.search) return;  OR  if (!utilities.search) { return; }
+        if (current.isFunction()) {
+            const body = current.get('body');
+            if (body && !Array.isArray(body) && body.isBlockStatement()) {
+                for (const stmt of body.get('body')) {
+                    if (stmt.isIfStatement()) {
+                        const test = stmt.node.test;
+                        // Check for: if (!utilities.search) return;
+                        if (t.isUnaryExpression(test) && test.operator === '!' && isUtilitiesSearchAccess(test.argument)) {
+                            return true;
+                        }
+                        // Check for: if (utilities.search == null) return;
+                        if (t.isBinaryExpression(test) && (test.operator === '==' || test.operator === '===')) {
+                            if (isUtilitiesSearchAccess(test.left) &&
+                                (t.isNullLiteral(test.right) || (t.isIdentifier(test.right) && test.right.name === 'undefined'))) {
+                                return true;
+                            }
+                        }
+                    }
+                }
+            }
+            // Stop walking up past the function boundary
+            break;
+        }
+        current = current.parentPath;
+    }
+    return false;
+}
+/**
+ * Checks if a test expression is checking `utilities.search` for truthiness.
+ */
+function testChecksUtilitiesSearch(test) {
+    // Direct: utilities.search
+    if (isUtilitiesSearchAccess(test)) {
+        return true;
+    }
+    // Negated null check: utilities.search != null  or  utilities.search !== null
+    // Also: utilities.search !== undefined
+    if (t.isBinaryExpression(test) && (test.operator === '!=' || test.operator === '!==')) {
+        if (isUtilitiesSearchAccess(test.left) &&
+            (t.isNullLiteral(test.right) || (t.isIdentifier(test.right) && test.right.name === 'undefined'))) {
+            return true;
+        }
+    }
+    // Logical AND chain
+    if (t.isLogicalExpression(test) && test.operator === '&&') {
+        return testChecksUtilitiesSearch(test.left) || testChecksUtilitiesSearch(test.right);
+    }
+    return false;
+}
+/**
+ * Checks if a node is `utilities.search` member expression.
+ */
+function isUtilitiesSearchAccess(node) {
+    return (t.isMemberExpression(node) &&
+        t.isIdentifier(node.object) &&
+        node.object.name === 'utilities' &&
+        t.isIdentifier(node.property) &&
+        node.property.name === 'search');
+}
+/**
+ * Checks if targetNode is within the consequent (true branch) of an if statement.
+ */
+function isInConsequent(targetNode, ifStatement) {
+    let found = false;
+    traverse(ifStatement.consequent, {
+        enter(innerPath) {
+            if (innerPath.node === targetNode) {
+                found = true;
+                innerPath.stop();
+            }
+        },
+        noScope: true,
+    });
+    return found;
+}
+/**
+ * Checks if a MemberExpression accesses a property/method on utilities.search
+ * (i.e., utilities.search.Search or utilities.search.PreviewSearch).
+ */
+function isUtilitiesSearchMethodAccess(node) {
+    return isUtilitiesSearchAccess(node.object);
+}
+/**
+ * Checks if the access uses optional chaining at the search level.
+ * Pattern: utilities.search?.Search(...)
+ * In the AST this appears as an OptionalMemberExpression chain.
+ */
+function isOptionalSearchAccess(path) {
+    const parent = path.parent;
+    if (t.isOptionalCallExpression(parent) || t.isOptionalMemberExpression(parent)) {
+        return true;
+    }
+    // Check if the utilities.search part itself is optional: utilities?.search?.method()
+    if (t.isOptionalMemberExpression(path.node.object)) {
+        return true;
+    }
+    return false;
+}
+let SearchAvailabilityCheckRule = class SearchAvailabilityCheckRule extends BaseLintRule {
+    get Name() { return 'search-availability-check'; }
+    get AppliesTo() { return 'all'; }
+    Test(ast) {
+        const violations = [];
+        // First pass: count total utilities.search accesses (guarded and unguarded)
+        // If the component uses utilities.search extensively, it's designed for search environments
+        let totalSearchAccesses = 0;
+        traverse(ast, {
+            MemberExpression(path) {
+                if (isUtilitiesSearchMethodAccess(path.node))
+                    totalSearchAccesses++;
+            },
+            OptionalMemberExpression(path) {
+                const node = path.node;
+                if (node.object && isUtilitiesSearchAccess(node.object))
+                    totalSearchAccesses++;
+            },
+        });
+        // If >=3 total accesses, the component is designed for search environments — skip
+        if (totalSearchAccesses >= 3)
+            return violations;
+        traverse(ast, {
+            MemberExpression(path) {
+                // We want to find utilities.search.Search or utilities.search.PreviewSearch
+                if (!isUtilitiesSearchMethodAccess(path.node))
+                    return;
+                // Skip if using optional chaining
+                if (isOptionalSearchAccess(path))
+                    return;
+                // Skip if inside a guard
+                if (isInsideSearchGuard(path))
+                    return;
+                const propertyName = t.isIdentifier(path.node.property)
+                    ? path.node.property.name
+                    : '(computed)';
+                violations.push({
+                    rule: 'search-availability-check',
+                    severity: 'medium',
+                    line: path.node.loc?.start.line ?? 0,
+                    column: path.node.loc?.start.column ?? 0,
+                    message: `Accessing "utilities.search.${propertyName}" without checking if utilities.search is available. The search provider may be undefined if not configured.`,
+                    code: `utilities.search.${propertyName}`,
+                    suggestion: {
+                        text: `Add a null check before accessing utilities.search`,
+                        example: `if (utilities.search) {\n  const result = await utilities.search.${propertyName}(...);\n}`,
+                    },
+                });
+            },
+        });
+        return violations;
+    }
+};
+SearchAvailabilityCheckRule = __decorate([
+    RegisterClass(BaseLintRule, 'search-availability-check')
+], SearchAvailabilityCheckRule);
+export { SearchAvailabilityCheckRule };
+//# sourceMappingURL=search-availability-check.js.map

package/dist/runtime-rules/search-availability-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-availability-check.js","sourceRoot":"","sources":["../../src/runtime-rules/search-availability-check.ts"],"names":[],"mappings":"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"}

package/dist/runtime-rules/search-call-validation.d.ts

@@ -0,0 +1,9 @@
+import * as t from '@babel/types';
+import { BaseLintRule } from '../lint-rule.js';
+import { Violation } from '../component-linter.js';
+export declare class SearchCallValidationRule extends BaseLintRule {
+    get Name(): string;
+    get AppliesTo(): 'all' | 'child' | 'root';
+    Test(ast: t.File): Violation[];
+}
+//# sourceMappingURL=search-call-validation.d.ts.map

package/dist/runtime-rules/search-call-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-call-validation.d.ts","sourceRoot":"","sources":["../../src/runtime-rules/search-call-validation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,CAAC,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AA4VhD,qBACa,wBAAyB,SAAQ,YAAY;IACxD,IAAI,IAAI,WAAuC;IAC/C,IAAI,SAAS,IAAI,KAAK,GAAG,OAAO,GAAG,MAAM,CAAkB;IAE3D,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,GAAG,SAAS,EAAE;CAwB/B"}

package/dist/runtime-rules/search-call-validation.js

@@ -0,0 +1,336 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { traverse } from '../lint-utils.js';
+import { RegisterClass } from '@memberjunction/global';
+import * as t from '@babel/types';
+import { BaseLintRule } from '../lint-rule.js';
+/**
+ * Rule: search-call-validation
+ *
+ * Validates `utilities.search.Search()` and `utilities.search.PreviewSearch()` call arguments.
+ *
+ * Search() checks:
+ * 1. First argument must be an object (or Identifier — skip validation for variables)
+ * 2. Required property: `Query` (string) — flag if missing
+ * 3. Valid properties: Query, MaxResults, MinScore, Filters — flag unknown properties
+ * 4. Property types: Query=string, MaxResults=number, MinScore=number (0-1), Filters=object
+ * 5. Filters sub-properties: EntityNames, SourceTypes, Tags — all must be arrays
+ * 6. SourceTypes valid values: 'Vector', 'FullText', 'Entity', 'Storage'
+ *
+ * PreviewSearch() checks:
+ * 1. First argument must be string (the query)
+ * 2. Second argument if present must be number (maxResults)
+ *
+ * Severity: critical for missing Query, high for invalid properties/types
+ * Applies to: all components
+ */
+const RULE_NAME = 'search-call-validation';
+const VALID_SEARCH_PROPS = new Set(['Query', 'MaxResults', 'MinScore', 'Filters']);
+const VALID_FILTER_PROPS = new Set(['EntityNames', 'SourceTypes', 'Tags']);
+const VALID_SOURCE_TYPES = new Set(['Vector', 'FullText', 'Entity', 'Storage']);
+/**
+ * Checks if a call expression targets utilities.search.Search or utilities.search.PreviewSearch.
+ * Returns the method name if matched, null otherwise.
+ * Handles both direct and optional-chaining patterns.
+ */
+function getSearchMethodName(callee) {
+    // Direct: utilities.search.Search(...)
+    if (t.isMemberExpression(callee) && t.isIdentifier(callee.property)) {
+        const methodName = callee.property.name;
+        if (methodName !== 'Search' && methodName !== 'PreviewSearch')
+            return null;
+        const obj = callee.object;
+        // utilities.search.Method
+        if (t.isMemberExpression(obj) &&
+            t.isIdentifier(obj.object) && obj.object.name === 'utilities' &&
+            t.isIdentifier(obj.property) && obj.property.name === 'search')
+            return methodName;
+        // utilities.search?.Method (optional on search)
+        if (t.isOptionalMemberExpression(obj) &&
+            t.isIdentifier(obj.object) && obj.object.name === 'utilities' &&
+            t.isIdentifier(obj.property) && obj.property.name === 'search')
+            return methodName;
+    }
+    // Optional call: utilities.search?.Search?.(...) or utilities.search.Search?.(...)
+    if (t.isOptionalMemberExpression(callee) && t.isIdentifier(callee.property)) {
+        const methodName = callee.property.name;
+        if (methodName !== 'Search' && methodName !== 'PreviewSearch')
+            return null;
+        const obj = callee.object;
+        if (t.isMemberExpression(obj) &&
+            t.isIdentifier(obj.object) && obj.object.name === 'utilities' &&
+            t.isIdentifier(obj.property) && obj.property.name === 'search')
+            return methodName;
+        if (t.isOptionalMemberExpression(obj) &&
+            t.isIdentifier(obj.object) && obj.object.name === 'utilities' &&
+            t.isIdentifier(obj.property) && obj.property.name === 'search')
+            return methodName;
+    }
+    return null;
+}
+// ── Search() argument validation ─────────────────────────────────────
+function validateSearchArgs(args, line, column, violations) {
+    if (args.length === 0) {
+        violations.push({
+            rule: RULE_NAME,
+            severity: 'critical',
+            line, column,
+            message: 'Search() requires an options object argument with at least a "Query" property.',
+            code: 'utilities.search.Search()',
+        });
+        return;
+    }
+    const firstArg = args[0];
+    // If it's a variable reference, skip validation (can't statically analyze)
+    if (t.isIdentifier(firstArg))
+        return;
+    if (!t.isObjectExpression(firstArg)) {
+        violations.push({
+            rule: RULE_NAME,
+            severity: 'high',
+            line: firstArg.loc?.start.line ?? line,
+            column: firstArg.loc?.start.column ?? column,
+            message: 'Search() argument must be an object with at least a "Query" property.',
+            code: 'utilities.search.Search(...)',
+        });
+        return;
+    }
+    validateSearchOptionsObject(firstArg, violations);
+}
+function validateSearchOptionsObject(obj, violations) {
+    const propNames = new Set();
+    for (const prop of obj.properties) {
+        if (!t.isObjectProperty(prop) || !t.isIdentifier(prop.key))
+            continue;
+        propNames.add(prop.key.name);
+    }
+    // Check required Query property
+    if (!propNames.has('Query')) {
+        violations.push({
+            rule: RULE_NAME,
+            severity: 'critical',
+            line: obj.loc?.start.line ?? 0,
+            column: obj.loc?.start.column ?? 0,
+            message: 'Search() options missing required "Query" property. The query string is required for search.',
+            code: 'Search({ ... })',
+        });
+    }
+    // Check for invalid properties and validate types
+    for (const prop of obj.properties) {
+        if (!t.isObjectProperty(prop) || !t.isIdentifier(prop.key))
+            continue;
+        const name = prop.key.name;
+        const value = prop.value;
+        const propLine = prop.loc?.start.line ?? 0;
+        const propCol = prop.loc?.start.column ?? 0;
+        if (!VALID_SEARCH_PROPS.has(name)) {
+            violations.push({
+                rule: RULE_NAME,
+                severity: 'high',
+                line: propLine,
+                column: propCol,
+                message: `Unknown property "${name}" in Search() options. Valid properties: ${[...VALID_SEARCH_PROPS].join(', ')}`,
+                code: name,
+            });
+            continue;
+        }
+        validateSearchPropertyType(name, value, propLine, propCol, violations);
+    }
+}
+function validateSearchPropertyType(name, value, line, column, violations) {
+    // Skip validation for identifiers/expressions — can't statically determine type
+    if (t.isIdentifier(value) || t.isCallExpression(value) || t.isMemberExpression(value) ||
+        t.isTemplateLiteral(value) || t.isConditionalExpression(value))
+        return;
+    switch (name) {
+        case 'Query':
+            if (!t.isStringLiteral(value) && !t.isTemplateLiteral(value)) {
+                // Only flag clearly wrong types (numbers, booleans, objects, arrays)
+                if (t.isNumericLiteral(value) || t.isBooleanLiteral(value) ||
+                    t.isObjectExpression(value) || t.isArrayExpression(value)) {
+                    violations.push({
+                        rule: RULE_NAME, severity: 'high', line, column,
+                        message: 'Search() "Query" property must be a string.',
+                        code: `Query: ${t.isNumericLiteral(value) ? String(value.value) : '...'}`,
+                    });
+                }
+            }
+            break;
+        case 'MaxResults':
+            if (!t.isNumericLiteral(value)) {
+                if (t.isStringLiteral(value) || t.isBooleanLiteral(value)) {
+                    violations.push({
+                        rule: RULE_NAME, severity: 'high', line, column,
+                        message: 'Search() "MaxResults" property must be a number.',
+                        code: `MaxResults: ${t.isStringLiteral(value) ? `"${value.value}"` : '...'}`,
+                    });
+                }
+            }
+            break;
+        case 'MinScore':
+            if (t.isNumericLiteral(value)) {
+                if (value.value < 0 || value.value > 1) {
+                    violations.push({
+                        rule: RULE_NAME, severity: 'high', line, column,
+                        message: `Search() "MinScore" must be between 0 and 1, got ${value.value}.`,
+                        code: `MinScore: ${value.value}`,
+                    });
+                }
+            }
+            else if (t.isStringLiteral(value) || t.isBooleanLiteral(value)) {
+                violations.push({
+                    rule: RULE_NAME, severity: 'high', line, column,
+                    message: 'Search() "MinScore" property must be a number between 0 and 1.',
+                    code: `MinScore: ${t.isStringLiteral(value) ? `"${value.value}"` : '...'}`,
+                });
+            }
+            break;
+        case 'Filters':
+            if (t.isObjectExpression(value)) {
+                validateFiltersObject(value, violations);
+            }
+            else if (t.isStringLiteral(value) || t.isNumericLiteral(value) || t.isBooleanLiteral(value) || t.isArrayExpression(value)) {
+                violations.push({
+                    rule: RULE_NAME, severity: 'high', line, column,
+                    message: 'Search() "Filters" property must be an object with optional EntityNames, SourceTypes, and Tags arrays.',
+                    code: 'Filters: ...',
+                });
+            }
+            break;
+    }
+}
+function validateFiltersObject(obj, violations) {
+    for (const prop of obj.properties) {
+        if (!t.isObjectProperty(prop) || !t.isIdentifier(prop.key))
+            continue;
+        const name = prop.key.name;
+        const value = prop.value;
+        const propLine = prop.loc?.start.line ?? 0;
+        const propCol = prop.loc?.start.column ?? 0;
+        if (!VALID_FILTER_PROPS.has(name)) {
+            violations.push({
+                rule: RULE_NAME,
+                severity: 'high',
+                line: propLine,
+                column: propCol,
+                message: `Unknown property "${name}" in Search() Filters. Valid properties: ${[...VALID_FILTER_PROPS].join(', ')}`,
+                code: name,
+            });
+            continue;
+        }
+        // All filter properties should be arrays (skip identifiers)
+        if (t.isIdentifier(value) || t.isCallExpression(value) || t.isMemberExpression(value))
+            continue;
+        if (!t.isArrayExpression(value)) {
+            violations.push({
+                rule: RULE_NAME,
+                severity: 'high',
+                line: propLine,
+                column: propCol,
+                message: `Search() Filters.${name} must be an array.`,
+                code: `${name}: ...`,
+            });
+            continue;
+        }
+        // Validate SourceTypes values
+        if (name === 'SourceTypes') {
+            validateSourceTypeValues(value, violations);
+        }
+    }
+}
+function validateSourceTypeValues(arr, violations) {
+    for (const elem of arr.elements) {
+        if (!t.isStringLiteral(elem))
+            continue;
+        if (!VALID_SOURCE_TYPES.has(elem.value)) {
+            violations.push({
+                rule: RULE_NAME,
+                severity: 'high',
+                line: elem.loc?.start.line ?? 0,
+                column: elem.loc?.start.column ?? 0,
+                message: `Invalid SourceType "${elem.value}". Valid values: ${[...VALID_SOURCE_TYPES].join(', ')}`,
+                code: `"${elem.value}"`,
+            });
+        }
+    }
+}
+// ── PreviewSearch() argument validation ──────────────────────────────
+function validatePreviewSearchArgs(args, line, column, violations) {
+    if (args.length === 0) {
+        violations.push({
+            rule: RULE_NAME,
+            severity: 'critical',
+            line, column,
+            message: 'PreviewSearch() requires at least a query string argument.',
+            code: 'utilities.search.PreviewSearch()',
+        });
+        return;
+    }
+    const firstArg = args[0];
+    // Skip identifiers — can't statically validate variable types
+    if (!t.isIdentifier(firstArg) && !t.isStringLiteral(firstArg) && !t.isTemplateLiteral(firstArg)) {
+        if (t.isNumericLiteral(firstArg) || t.isBooleanLiteral(firstArg) ||
+            t.isObjectExpression(firstArg) || t.isArrayExpression(firstArg)) {
+            violations.push({
+                rule: RULE_NAME,
+                severity: 'high',
+                line: firstArg.loc?.start.line ?? line,
+                column: firstArg.loc?.start.column ?? column,
+                message: 'PreviewSearch() first argument must be a query string.',
+                code: 'PreviewSearch(...)',
+            });
+        }
+    }
+    // Validate second argument if present
+    if (args.length >= 2) {
+        const secondArg = args[1];
+        if (!t.isIdentifier(secondArg) && !t.isNumericLiteral(secondArg)) {
+            if (t.isStringLiteral(secondArg) || t.isBooleanLiteral(secondArg) ||
+                t.isObjectExpression(secondArg) || t.isArrayExpression(secondArg)) {
+                violations.push({
+                    rule: RULE_NAME,
+                    severity: 'high',
+                    line: secondArg.loc?.start.line ?? line,
+                    column: secondArg.loc?.start.column ?? column,
+                    message: 'PreviewSearch() second argument (maxResults) must be a number.',
+                    code: 'PreviewSearch(query, ...)',
+                });
+            }
+        }
+    }
+}
+// ── Main Rule ────────────────────────────────────────────────────────
+let SearchCallValidationRule = class SearchCallValidationRule extends BaseLintRule {
+    get Name() { return 'search-call-validation'; }
+    get AppliesTo() { return 'all'; }
+    Test(ast) {
+        const violations = [];
+        const visitCall = (path) => {
+            const methodName = getSearchMethodName(path.node.callee);
+            if (!methodName)
+                return;
+            const line = path.node.loc?.start.line ?? 0;
+            const column = path.node.loc?.start.column ?? 0;
+            if (methodName === 'Search') {
+                validateSearchArgs(path.node.arguments, line, column, violations);
+            }
+            else if (methodName === 'PreviewSearch') {
+                validatePreviewSearchArgs(path.node.arguments, line, column, violations);
+            }
+        };
+        traverse(ast, {
+            CallExpression(path) { visitCall(path); },
+            OptionalCallExpression(path) { visitCall(path); },
+        });
+        return violations;
+    }
+};
+SearchCallValidationRule = __decorate([
+    RegisterClass(BaseLintRule, 'search-call-validation')
+], SearchCallValidationRule);
+export { SearchCallValidationRule };
+//# sourceMappingURL=search-call-validation.js.map

package/dist/runtime-rules/search-call-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-call-validation.js","sourceRoot":"","sources":["../../src/runtime-rules/search-call-validation.ts"],"names":[],"mappings":"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"}

package/dist/runtime-rules/server-reload-on-client-operation.d.ts

@@ -0,0 +1,18 @@
+import * as t from '@babel/types';
+import { BaseLintRule } from '../lint-rule.js';
+import { Violation } from '../component-linter.js';
+/**
+ * Rule: server-reload-on-client-operation
+ *
+ * Detects when components reload data from the server during sort/filter operations.
+ * These operations should be performed client-side using useMemo for better performance.
+ *
+ * Severity: critical
+ * Applies to: all components
+ */
+export declare class ServerReloadOnClientOperationRule extends BaseLintRule {
+    get Name(): string;
+    get AppliesTo(): 'all' | 'child' | 'root';
+    Test(ast: t.File, componentName: string): Violation[];
+}
+//# sourceMappingURL=server-reload-on-client-operation.d.ts.map

package/dist/runtime-rules/server-reload-on-client-operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-reload-on-client-operation.d.ts","sourceRoot":"","sources":["../../src/runtime-rules/server-reload-on-client-operation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,CAAC,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAgChD;;;;;;;;GAQG;AACH,qBACa,iCAAkC,SAAQ,YAAY;IACjE,IAAI,IAAI,WAAkD;IAC1D,IAAI,SAAS,IAAI,KAAK,GAAG,OAAO,GAAG,MAAM,CAAkB;IAE3D,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,GAAG,SAAS,EAAE;CA2DtD"}