@memberjunction/react-linter 0.0.1 → 5.38.0

package/dist/runtime-rules/use-function-declaration.js

@@ -0,0 +1,127 @@
+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 { RegisterClass } from '@memberjunction/global';
+import * as t from '@babel/types';
+import { BaseLintRule } from '../lint-rule.js';
+import { traverse, createViolation, truncateCode } from '../lint-utils.js';
+/**
+ * Rule: use-function-declaration
+ *
+ * Ensures that components use function declaration syntax instead of
+ * arrow functions or function expressions.
+ *
+ * Severity: critical
+ * Applies to: all components
+ */
+let UseFunctionDeclarationRule = class UseFunctionDeclarationRule extends BaseLintRule {
+    get Name() { return 'use-function-declaration'; }
+    get AppliesTo() { return 'all'; }
+    Test(ast, componentName) {
+        const violations = [];
+        traverse(ast, {
+            VariableDeclarator(path) {
+                // Only check TOP-LEVEL declarations (not nested inside functions)
+                // This prevents flagging arrow functions inside the component
+                const isTopLevel = path.getFunctionParent() === null || path.scope.path.type === 'Program';
+                if (!isTopLevel) {
+                    return; // Skip non-top-level declarations
+                }
+                // Check if this is the main component being defined as arrow function
+                if (t.isIdentifier(path.node.id) && path.node.id.name === componentName) {
+                    const init = path.node.init;
+                    // Check if it's an arrow function
+                    if (t.isArrowFunctionExpression(init)) {
+                        violations.push(createViolation('use-function-declaration', 'critical', path.node, `Component "${componentName}" must be defined using function declaration syntax, not arrow function.`, truncateCode(path.toString(), 150), {
+                            text: 'Use function declaration syntax for TOP-LEVEL component definitions. Arrow functions are fine inside components.',
+                            example: `// ❌ WRONG - Top-level arrow function component:
+const MyComponent = ({ utilities, styles, components }) => {
+  const [state, setState] = useState('');
+
+  return <div>{state}</div>;
+};
+
+// ✅ CORRECT - Function declaration for top-level:
+function MyComponent({ utilities, styles, components }) {
+  const [state, setState] = useState('');
+
+  // Arrow functions are FINE inside the component:
+  const handleClick = () => {
+    setState('clicked');
+  };
+
+  const ChildComponent = () => <div>This is OK inside the component</div>;
+
+  return <div onClick={handleClick}>{state}</div>;
+}
+
+// Child components also use function declaration:
+function ChildComponent() {
+  return <div>Child</div>;
+}
+
+// Why function declarations?
+// 1. Clearer component identification
+// 2. Better debugging experience (named functions)
+// 3. Hoisting allows flexible code organization
+// 4. Consistent with React documentation patterns
+// 5. Easier to distinguish from regular variables`,
+                        }));
+                    }
+                }
+                // Also check for any other TOP-LEVEL component-like arrow functions (starts with capital letter)
+                // But ONLY at the top level, not inside the component
+                if (t.isIdentifier(path.node.id) && /^[A-Z]/.test(path.node.id.name)) {
+                    const init = path.node.init;
+                    if (t.isArrowFunctionExpression(init)) {
+                        // Only flag if it's at the top level (parallel to main component)
+                        violations.push(createViolation('use-function-declaration', 'high', path.node, `Top-level component "${path.node.id.name}" should use function declaration syntax.`, truncateCode(path.toString(), 150), {
+                            text: 'Use function declaration syntax for TOP-LEVEL component definitions. Arrow functions are fine inside components.',
+                            example: `// ❌ WRONG - Top-level arrow function component:
+const MyComponent = ({ utilities, styles, components }) => {
+  const [state, setState] = useState('');
+
+  return <div>{state}</div>;
+};
+
+// ✅ CORRECT - Function declaration for top-level:
+function MyComponent({ utilities, styles, components }) {
+  const [state, setState] = useState('');
+
+  // Arrow functions are FINE inside the component:
+  const handleClick = () => {
+    setState('clicked');
+  };
+
+  const ChildComponent = () => <div>This is OK inside the component</div>;
+
+  return <div onClick={handleClick}>{state}</div>;
+}
+
+// Child components also use function declaration:
+function ChildComponent() {
+  return <div>Child</div>;
+}
+
+// Why function declarations?
+// 1. Clearer component identification
+// 2. Better debugging experience (named functions)
+// 3. Hoisting allows flexible code organization
+// 4. Consistent with React documentation patterns
+// 5. Easier to distinguish from regular variables`,
+                        }));
+                    }
+                }
+            },
+        });
+        return violations;
+    }
+};
+UseFunctionDeclarationRule = __decorate([
+    RegisterClass(BaseLintRule, 'use-function-declaration')
+], UseFunctionDeclarationRule);
+export { UseFunctionDeclarationRule };
+//# sourceMappingURL=use-function-declaration.js.map

package/dist/runtime-rules/use-function-declaration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-function-declaration.js","sourceRoot":"","sources":["../../src/runtime-rules/use-function-declaration.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,CAAC,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAY,eAAe,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElF;;;;;;;;GAQG;AAEI,IAAM,0BAA0B,GAAhC,MAAM,0BAA2B,SAAQ,YAAY;IAC1D,IAAI,IAAI,KAAK,OAAO,0BAA0B,CAAC,CAAC,CAAC;IACjD,IAAI,SAAS,KAA+B,OAAO,KAAK,CAAC,CAAC,CAAC;IAE3D,IAAI,CAAC,GAAW,EAAE,aAAqB;QACrC,MAAM,UAAU,GAAgB,EAAE,CAAC;QAEnC,QAAQ,CAAC,GAAG,EAAE;YACZ,kBAAkB,CAAC,IAAoC;gBACrD,kEAAkE;gBAClE,8DAA8D;gBAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,EAAE,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC;gBAE3F,IAAI,CAAC,UAAU,EAAE,CAAC;oBAChB,OAAO,CAAC,kCAAkC;gBAC5C,CAAC;gBAED,sEAAsE;gBACtE,IAAI,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;oBACxE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;oBAE5B,kCAAkC;oBAClC,IAAI,CAAC,CAAC,yBAAyB,CAAC,IAAI,CAAC,EAAE,CAAC;wBACtC,UAAU,CAAC,IAAI,CACb,eAAe,CACb,0BAA0B,EAC1B,UAAU,EACV,IAAI,CAAC,IAAI,EACT,cAAc,aAAa,0EAA0E,EACrG,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,GAAG,CAAC,EAClC;4BACE,IAAI,EAAE,kHAAkH;4BACxH,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mDA+BwB;yBAClC,CACF,CACF,CAAC;oBACJ,CAAC;gBACH,CAAC;gBAED,iGAAiG;gBACjG,sDAAsD;gBACtD,IAAI,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;oBACrE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;oBAC5B,IAAI,CAAC,CAAC,yBAAyB,CAAC,IAAI,CAAC,EAAE,CAAC;wBACtC,kEAAkE;wBAClE,UAAU,CAAC,IAAI,CACb,eAAe,CACb,0BAA0B,EAC1B,MAAM,EACN,IAAI,CAAC,IAAI,EACT,wBAAwB,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,2CAA2C,EACpF,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,GAAG,CAAC,EAClC;4BACE,IAAI,EAAE,kHAAkH;4BACxH,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mDA+BwB;yBAClC,CACF,CACF,CAAC;oBACJ,CAAC;gBACH,CAAC;YACH,CAAC;SACF,CAAC,CAAC;QAEH,OAAO,UAAU,CAAC;IAClB,CAAC;CACJ,CAAA;AA/HY,0BAA0B;IADtC,aAAa,CAAC,YAAY,EAAE,0BAA0B,CAAC;GAC3C,0BAA0B,CA+HtC"}

package/dist/runtime-rules/use-unwrap-components.d.ts

@@ -0,0 +1,19 @@
+import * as t from '@babel/types';
+import { BaseLintRule } from '../lint-rule.js';
+import { Violation } from '../component-linter.js';
+import { ComponentSpec } from '@memberjunction/interactive-component-types';
+/**
+ * Rule: use-unwrap-components
+ *
+ * Ensures that components use unwrapComponents() utility to access library components
+ * instead of direct destructuring. This ensures safe access to library APIs.
+ *
+ * Severity: critical
+ * Applies to: all components
+ */
+export declare class UseUnwrapComponentsRule extends BaseLintRule {
+    get Name(): string;
+    get AppliesTo(): 'all' | 'child' | 'root';
+    Test(ast: t.File, _componentName: string, componentSpec?: ComponentSpec): Violation[];
+}
+//# sourceMappingURL=use-unwrap-components.d.ts.map

package/dist/runtime-rules/use-unwrap-components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-unwrap-components.d.ts","sourceRoot":"","sources":["../../src/runtime-rules/use-unwrap-components.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;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAE5E;;;;;;;;GAQG;AACH,qBACa,uBAAwB,SAAQ,YAAY;IACvD,IAAI,IAAI,WAAsC;IAC9C,IAAI,SAAS,IAAI,KAAK,GAAG,OAAO,GAAG,MAAM,CAAkB;IAE3D,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,aAAa,GAAG,SAAS,EAAE;CA8DtF"}

package/dist/runtime-rules/use-unwrap-components.js

@@ -0,0 +1,84 @@
+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: use-unwrap-components
+ *
+ * Ensures that components use unwrapComponents() utility to access library components
+ * instead of direct destructuring. This ensures safe access to library APIs.
+ *
+ * Severity: critical
+ * Applies to: all components
+ */
+let UseUnwrapComponentsRule = class UseUnwrapComponentsRule extends BaseLintRule {
+    get Name() { return 'use-unwrap-components'; }
+    get AppliesTo() { return 'all'; }
+    Test(ast, _componentName, componentSpec) {
+        const violations = [];
+        // Build a set of library global variables
+        const libraryGlobals = new Set();
+        if (componentSpec?.libraries) {
+            for (const lib of componentSpec.libraries) {
+                if (lib.globalVariable) {
+                    libraryGlobals.add(lib.globalVariable);
+                }
+            }
+        }
+        traverse(ast, {
+            VariableDeclarator(path) {
+                // Check for direct destructuring from library globals
+                if (t.isObjectPattern(path.node.id) && t.isIdentifier(path.node.init)) {
+                    const sourceVar = path.node.init.name;
+                    // Check if this is destructuring from a library global
+                    if (libraryGlobals.has(sourceVar)) {
+                        // Extract the destructured component names
+                        const componentNames = [];
+                        for (const prop of path.node.id.properties) {
+                            if (t.isObjectProperty(prop)) {
+                                if (t.isIdentifier(prop.key)) {
+                                    componentNames.push(prop.key.name);
+                                }
+                            }
+                        }
+                        violations.push({
+                            rule: 'use-unwrap-components',
+                            severity: 'critical',
+                            line: path.node.loc?.start.line || 0,
+                            column: path.node.loc?.start.column || 0,
+                            message: `Direct destructuring from library "${sourceVar}" is not allowed. You MUST use unwrapComponents to access library components. Replace "const { ${componentNames.join(', ')} } = ${sourceVar};" with "const { ${componentNames.join(', ')} } = unwrapComponents(${sourceVar}, [${componentNames.map((n) => `'${n}'`).join(', ')}]);"`,
+                        });
+                    }
+                }
+                // Also check for MemberExpression destructuring like const { Button } = antd.Button
+                if (t.isObjectPattern(path.node.id) && t.isMemberExpression(path.node.init)) {
+                    const memberExpr = path.node.init;
+                    if (t.isIdentifier(memberExpr.object)) {
+                        const objName = memberExpr.object.name;
+                        if (libraryGlobals.has(objName)) {
+                            violations.push({
+                                rule: 'use-unwrap-components',
+                                severity: 'critical',
+                                line: path.node.loc?.start.line || 0,
+                                column: path.node.loc?.start.column || 0,
+                                message: `Direct destructuring from library member expression is not allowed. Use unwrapComponents to safely access library components. Example: Instead of "const { Something } = ${objName}.Something;", use "const { Something } = unwrapComponents(${objName}, ['Something']);"`,
+                            });
+                        }
+                    }
+                }
+            },
+        });
+        return violations;
+    }
+};
+UseUnwrapComponentsRule = __decorate([
+    RegisterClass(BaseLintRule, 'use-unwrap-components')
+], UseUnwrapComponentsRule);
+export { UseUnwrapComponentsRule };
+//# sourceMappingURL=use-unwrap-components.js.map

package/dist/runtime-rules/use-unwrap-components.js.map

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

package/dist/runtime-rules/useeffect-unstable-dependencies.d.ts

@@ -0,0 +1,23 @@
+import * as t from '@babel/types';
+import { BaseLintRule } from '../lint-rule.js';
+import { Violation } from '../component-linter.js';
+/**
+ * Rule: useeffect-unstable-dependencies
+ *
+ * Detects unstable dependencies in useEffect hooks that can cause infinite render loops.
+ * Two types of issues:
+ *
+ * 1. Object/function props (utilities, components, callbacks, styles, savedUserSettings)
+ *    - Severity: high - May cause infinite loops if parent doesn't provide stable references
+ *
+ * 2. Parameters with object literal defaults (queryParameters = {})
+ *    - Severity: critical - ALWAYS causes infinite loops (new object every render)
+ *
+ * Applies to: all components
+ */
+export declare class UseeffectUnstableDependenciesRule extends BaseLintRule {
+    get Name(): string;
+    get AppliesTo(): 'all' | 'child' | 'root';
+    Test(ast: t.File, componentName: string): Violation[];
+}
+//# sourceMappingURL=useeffect-unstable-dependencies.d.ts.map

package/dist/runtime-rules/useeffect-unstable-dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useeffect-unstable-dependencies.d.ts","sourceRoot":"","sources":["../../src/runtime-rules/useeffect-unstable-dependencies.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;AAEhD;;;;;;;;;;;;;GAaG;AACH,qBACa,iCAAkC,SAAQ,YAAY;IACjE,IAAI,IAAI,WAAgD;IACxD,IAAI,SAAS,IAAI,KAAK,GAAG,OAAO,GAAG,MAAM,CAAkB;IAE3D,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,GAAG,SAAS,EAAE;CAuMtD"}

package/dist/runtime-rules/useeffect-unstable-dependencies.js

@@ -0,0 +1,215 @@
+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: useeffect-unstable-dependencies
+ *
+ * Detects unstable dependencies in useEffect hooks that can cause infinite render loops.
+ * Two types of issues:
+ *
+ * 1. Object/function props (utilities, components, callbacks, styles, savedUserSettings)
+ *    - Severity: high - May cause infinite loops if parent doesn't provide stable references
+ *
+ * 2. Parameters with object literal defaults (queryParameters = {})
+ *    - Severity: critical - ALWAYS causes infinite loops (new object every render)
+ *
+ * Applies to: all components
+ */
+let UseeffectUnstableDependenciesRule = class UseeffectUnstableDependenciesRule extends BaseLintRule {
+    get Name() { return 'useeffect-unstable-dependencies'; }
+    get AppliesTo() { return 'all'; }
+    Test(ast, componentName) {
+        const violations = [];
+        // Known prop names that are always objects/functions and unstable
+        const unstablePropNames = new Set([
+            'utilities',
+            'components',
+            'callbacks',
+            'styles',
+            'savedUserSettings', // Can be unstable if not memoized by parent
+        ]);
+        // Helper to find the component function and extract parameters with object defaults
+        const findComponentParams = (useEffectPath) => {
+            const paramsWithObjectDefaults = new Map();
+            let current = useEffectPath.parentPath;
+            while (current) {
+                // Look for FunctionDeclaration or ArrowFunctionExpression/FunctionExpression
+                if (t.isFunctionDeclaration(current.node) ||
+                    t.isArrowFunctionExpression(current.node) ||
+                    t.isFunctionExpression(current.node)) {
+                    const func = current.node;
+                    // Check if this looks like a component (starts with uppercase)
+                    let isComponent = false;
+                    if (t.isFunctionDeclaration(func) && func.id && /^[A-Z]/.test(func.id.name)) {
+                        isComponent = true;
+                    }
+                    // For arrow functions, check the variable declarator name
+                    if ((t.isArrowFunctionExpression(func) || t.isFunctionExpression(func)) && current.parentPath) {
+                        const parent = current.parentPath.node;
+                        if (t.isVariableDeclarator(parent) && t.isIdentifier(parent.id) && /^[A-Z]/.test(parent.id.name)) {
+                            isComponent = true;
+                        }
+                    }
+                    if (isComponent) {
+                        // Extract parameters with object literal defaults
+                        for (const param of func.params) {
+                            // Case 1: ObjectPattern (destructured props): { foo = {}, bar = [] }
+                            if (t.isObjectPattern(param)) {
+                                for (const prop of param.properties) {
+                                    if (t.isObjectProperty(prop)) {
+                                        const value = prop.value;
+                                        // Check if this destructured property has a default: queryParameters = {}
+                                        if (t.isAssignmentPattern(value) && t.isIdentifier(value.left)) {
+                                            const defaultVal = value.right;
+                                            if (t.isObjectExpression(defaultVal) || t.isArrayExpression(defaultVal)) {
+                                                paramsWithObjectDefaults.set(value.left.name, defaultVal);
+                                            }
+                                        }
+                                    }
+                                }
+                            }
+                            // Case 2: AssignmentPattern (param with default): queryParameters = {}
+                            else if (t.isAssignmentPattern(param)) {
+                                const left = param.left;
+                                const right = param.right;
+                                // Simple param with object default: queryParameters = {}
+                                if (t.isIdentifier(left) && (t.isObjectExpression(right) || t.isArrayExpression(right))) {
+                                    paramsWithObjectDefaults.set(left.name, right);
+                                }
+                                // ObjectPattern with object default: { foo, bar } = {}
+                                else if (t.isObjectPattern(left) && (t.isObjectExpression(right) || t.isArrayExpression(right))) {
+                                    // The whole destructured object gets a default - mark all properties
+                                    for (const prop of left.properties) {
+                                        if (t.isObjectProperty(prop) && t.isIdentifier(prop.key)) {
+                                            paramsWithObjectDefaults.set(prop.key.name, right);
+                                        }
+                                    }
+                                }
+                            }
+                        }
+                        break; // Found the component, stop traversing up
+                    }
+                }
+                current = current.parentPath;
+            }
+            return paramsWithObjectDefaults;
+        };
+        traverse(ast, {
+            CallExpression(path) {
+                // Check for useEffect calls
+                if (t.isIdentifier(path.node.callee) && path.node.callee.name === 'useEffect') {
+                    // Get the dependency array (second argument)
+                    const depsArg = path.node.arguments[1];
+                    if (!depsArg || !t.isArrayExpression(depsArg)) {
+                        return; // No deps array or empty deps []
+                    }
+                    // Find component parameters with object defaults
+                    const paramsWithObjectDefaults = findComponentParams(path);
+                    // Check each dependency
+                    for (const dep of depsArg.elements) {
+                        if (!dep)
+                            continue;
+                        let unstableDep = null;
+                        let severity = 'high';
+                        let message = '';
+                        let suggestionText = '';
+                        // Case 1: Member expression (utilities.rq.RunQuery, callbacks?.onSelect)
+                        if (t.isMemberExpression(dep) || t.isOptionalMemberExpression(dep)) {
+                            const memberExpr = dep;
+                            // Get the root object (e.g., 'utilities' from 'utilities.rq.RunQuery')
+                            let rootObj = memberExpr.object;
+                            while ((t.isMemberExpression(rootObj) || t.isOptionalMemberExpression(rootObj)) && 'object' in rootObj) {
+                                rootObj = rootObj.object;
+                            }
+                            if (t.isIdentifier(rootObj) && unstablePropNames.has(rootObj.name)) {
+                                unstableDep = `${rootObj.name}.${t.isIdentifier(memberExpr.property) ? memberExpr.property.name : '...'}`;
+                                severity = 'high';
+                                message = `useEffect has unstable dependency '${unstableDep}' that may cause infinite render loops. Object/function references from props typically change on every render. This works if the parent provides stable references (via useMemo), but is fragile and should be avoided.`;
+                                suggestionText = `Remove '${unstableDep}' from dependency array. These utilities/services are typically stable and don't need to be tracked.`;
+                            }
+                        }
+                        // Case 2: Direct identifier (utilities, components, etc.)
+                        else if (t.isIdentifier(dep)) {
+                            // Check if it's a known unstable prop name
+                            if (unstablePropNames.has(dep.name)) {
+                                unstableDep = dep.name;
+                                severity = 'high';
+                                message = `useEffect has unstable dependency '${unstableDep}' that may cause infinite render loops. Object/function references from props typically change on every render. This works if the parent provides stable references (via useMemo), but is fragile and should be avoided.`;
+                                suggestionText = `Remove '${unstableDep}' from dependency array. These utilities/services are typically stable and don't need to be tracked.`;
+                            }
+                            // Check if it's a param with object literal default
+                            else if (paramsWithObjectDefaults.has(dep.name)) {
+                                unstableDep = dep.name;
+                                severity = 'critical';
+                                const defaultValue = paramsWithObjectDefaults.get(dep.name);
+                                const defaultStr = t.isObjectExpression(defaultValue) ? '{}' : '[]';
+                                message = `useEffect has CRITICAL unstable dependency '${unstableDep}' with object literal default (${dep.name} = ${defaultStr}). This creates a NEW object on EVERY render, causing infinite loops. This is ALWAYS broken.`;
+                                suggestionText = `Remove '${unstableDep}' from dependency array. Props with object literal defaults (${dep.name} = ${defaultStr}) create new references every render.`;
+                            }
+                        }
+                        // Report violation if we found an unstable dependency
+                        if (unstableDep) {
+                            let fixedDeps = depsArg.elements
+                                .filter((e) => e !== dep)
+                                .map((e) => {
+                                if (!e)
+                                    return '';
+                                if (t.isIdentifier(e))
+                                    return e.name;
+                                if (t.isMemberExpression(e) || t.isOptionalMemberExpression(e)) {
+                                    // Try to extract the full path
+                                    const parts = [];
+                                    let current = e;
+                                    while (t.isMemberExpression(current) || t.isOptionalMemberExpression(current)) {
+                                        if ('property' in current && t.isIdentifier(current.property)) {
+                                            parts.unshift(current.property.name);
+                                        }
+                                        if ('object' in current) {
+                                            current = current.object;
+                                        }
+                                        else {
+                                            break;
+                                        }
+                                    }
+                                    if (t.isIdentifier(current)) {
+                                        parts.unshift(current.name);
+                                    }
+                                    return parts.join('.');
+                                }
+                                return '...';
+                            })
+                                .filter(Boolean);
+                            violations.push({
+                                rule: 'useeffect-unstable-dependencies',
+                                severity: severity,
+                                line: dep.loc?.start.line || path.node.loc?.start.line || 0,
+                                column: dep.loc?.start.column || path.node.loc?.start.column || 0,
+                                message: message,
+                                code: `}, [${fixedDeps.join(', ')}${fixedDeps.length > 0 ? ', ' : ''}${unstableDep}]);  // ${severity === 'critical' ? '🚨' : '⚠️'} Remove '${unstableDep}'`,
+                                suggestion: {
+                                    text: suggestionText,
+                                    example: fixedDeps.length > 0
+                                        ? `}, [${fixedDeps.join(', ')}]);  // ✅ Removed unstable '${unstableDep}'`
+                                        : `}, []);  // ✅ Run once on mount - dependencies are stable`
+                                }
+                            });
+                        }
+                    }
+                }
+            },
+        });
+        return violations;
+    }
+};
+UseeffectUnstableDependenciesRule = __decorate([
+    RegisterClass(BaseLintRule, 'useeffect-unstable-dependencies')
+], UseeffectUnstableDependenciesRule);
+export { UseeffectUnstableDependenciesRule };
+//# sourceMappingURL=useeffect-unstable-dependencies.js.map

package/dist/runtime-rules/useeffect-unstable-dependencies.js.map

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

package/dist/runtime-rules/utilities-api-validation.d.ts

@@ -0,0 +1,24 @@
+import * as t from '@babel/types';
+import { BaseLintRule } from '../lint-rule.js';
+import { Violation } from '../component-linter.js';
+/**
+ * Rule: utilities-api-validation
+ *
+ * Validates that components only access valid properties and methods
+ * on the utilities object (rv, rq, md, ai) and their sub-objects.
+ *
+ * Valid API surface:
+ * - utilities.rv: RunView(), RunViews()
+ * - utilities.rq: RunQuery()
+ * - utilities.md: GetEntityObject(), Entities
+ * - utilities.ai: ExecutePrompt(), EmbedText(), VectorService
+ *
+ * Severity: critical
+ * Applies to: all components
+ */
+export declare class UtilitiesApiValidationRule extends BaseLintRule {
+    get Name(): string;
+    get AppliesTo(): 'all' | 'child' | 'root';
+    Test(ast: t.File): Violation[];
+}
+//# sourceMappingURL=utilities-api-validation.d.ts.map

package/dist/runtime-rules/utilities-api-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities-api-validation.d.ts","sourceRoot":"","sources":["../../src/runtime-rules/utilities-api-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;AAEhD;;;;;;;;;;;;;;GAcG;AACH,qBACa,0BAA2B,SAAQ,YAAY;IAC1D,IAAI,IAAI,WAAyC;IACjD,IAAI,SAAS,IAAI,KAAK,GAAG,OAAO,GAAG,MAAM,CAAkB;IAE3D,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,GAAG,SAAS,EAAE;CAsG/B"}