@memberjunction/react-linter 0.0.1 → 5.38.0

package/dist/runtime-rules/utilities-api-validation.js

@@ -0,0 +1,121 @@
+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: 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
+ */
+let UtilitiesApiValidationRule = class UtilitiesApiValidationRule extends BaseLintRule {
+    get Name() { return 'utilities-api-validation'; }
+    get AppliesTo() { return 'all'; }
+    Test(ast) {
+        const violations = [];
+        // Define the complete utilities API surface
+        const utilitiesAPI = {
+            rv: { methods: new Set(['RunView', 'RunViews']), properties: new Set() },
+            rq: { methods: new Set(['RunQuery']), properties: new Set() },
+            md: { methods: new Set(['GetEntityObject']), properties: new Set(['Entities']) },
+            ai: { methods: new Set(['ExecutePrompt', 'EmbedText']), properties: new Set(['VectorService']) },
+        };
+        const validUtilityProps = new Set(Object.keys(utilitiesAPI));
+        traverse(ast, {
+            // Check for utilities.* property access
+            MemberExpression(path) {
+                // Check for direct utilities.* access
+                if (t.isIdentifier(path.node.object) && path.node.object.name === 'utilities') {
+                    if (t.isIdentifier(path.node.property)) {
+                        const propName = path.node.property.name;
+                        if (!validUtilityProps.has(propName)) {
+                            violations.push({
+                                rule: 'utilities-api-validation',
+                                severity: 'critical',
+                                line: path.node.loc?.start.line || 0,
+                                column: path.node.loc?.start.column || 0,
+                                message: `Invalid utilities property '${propName}'. Valid properties are: rv (RunView), rq (RunQuery), md (Metadata), ai (AI Tools)`,
+                                code: `utilities.${propName}`,
+                            });
+                        }
+                    }
+                    return; // Don't check deeper for this node
+                }
+                // Check for utilities.{rv|rq|md|ai}.property access (non-call)
+                if (t.isCallExpression(path.parent) && path.parent.callee === path.node) {
+                    return; // Skip - this is a method call, handled below
+                }
+                if (t.isMemberExpression(path.node.object) &&
+                    t.isIdentifier(path.node.object.object) &&
+                    path.node.object.object.name === 'utilities' &&
+                    t.isIdentifier(path.node.object.property) &&
+                    t.isIdentifier(path.node.property)) {
+                    const utilityName = path.node.object.property.name;
+                    const propName = path.node.property.name;
+                    const api = utilitiesAPI[utilityName];
+                    if (api && !api.properties.has(propName) && !api.methods.has(propName)) {
+                        const validItems = [
+                            ...Array.from(api.methods).map((m) => `${m}()`),
+                            ...Array.from(api.properties),
+                        ];
+                        violations.push({
+                            rule: 'utilities-api-validation',
+                            severity: 'critical',
+                            line: path.node.loc?.start.line || 0,
+                            column: path.node.loc?.start.column || 0,
+                            message: `Invalid access '${propName}' on utilities.${utilityName}. Valid: ${validItems.join(', ')}`,
+                            code: `utilities.${utilityName}.${propName}`,
+                        });
+                    }
+                }
+            },
+            // Check for utilities.{rv|rq|md|ai}.method() calls
+            CallExpression(path) {
+                if (t.isMemberExpression(path.node.callee)) {
+                    const callee = path.node.callee;
+                    if (t.isMemberExpression(callee.object) &&
+                        t.isIdentifier(callee.object.object) &&
+                        callee.object.object.name === 'utilities' &&
+                        t.isIdentifier(callee.object.property) &&
+                        t.isIdentifier(callee.property)) {
+                        const utilityName = callee.object.property.name;
+                        const methodName = callee.property.name;
+                        const api = utilitiesAPI[utilityName];
+                        if (api && !api.methods.has(methodName)) {
+                            const validMethods = Array.from(api.methods).join(', ');
+                            violations.push({
+                                rule: 'utilities-api-validation',
+                                severity: 'critical',
+                                line: path.node.loc?.start.line || 0,
+                                column: path.node.loc?.start.column || 0,
+                                message: `Invalid method '${methodName}' on utilities.${utilityName}. Valid methods: ${validMethods}`,
+                                code: `utilities.${utilityName}.${methodName}()`,
+                            });
+                        }
+                    }
+                }
+            },
+        });
+        return violations;
+    }
+};
+UtilitiesApiValidationRule = __decorate([
+    RegisterClass(BaseLintRule, 'utilities-api-validation')
+], UtilitiesApiValidationRule);
+export { UtilitiesApiValidationRule };
+//# sourceMappingURL=utilities-api-validation.js.map

package/dist/runtime-rules/utilities-api-validation.js.map

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

package/dist/runtime-rules/utilities-no-direct-instantiation.d.ts

@@ -0,0 +1,20 @@
+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: utilities-no-direct-instantiation
+ *
+ * Prevents direct instantiation of classes that should be accessed via the utilities parameter.
+ * Classes like RunView, RunQuery, Metadata, and SimpleVectorService are provided by the runtime
+ * and should be used through the utilities object.
+ *
+ * Severity: high
+ * Applies to: all components
+ */
+export declare class UtilitiesNoDirectInstantiationRule extends BaseLintRule {
+    get Name(): string;
+    get AppliesTo(): 'all' | 'child' | 'root';
+    Test(ast: t.File, componentName: string, componentSpec?: ComponentSpec): Violation[];
+}
+//# sourceMappingURL=utilities-no-direct-instantiation.d.ts.map

package/dist/runtime-rules/utilities-no-direct-instantiation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities-no-direct-instantiation.d.ts","sourceRoot":"","sources":["../../src/runtime-rules/utilities-no-direct-instantiation.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;;;;;;;;;GASG;AACH,qBACa,kCAAmC,SAAQ,YAAY;IAClE,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,EAAE,aAAa,CAAC,EAAE,aAAa,GAAG,SAAS,EAAE;CAgCrF"}

package/dist/runtime-rules/utilities-no-direct-instantiation.js

@@ -0,0 +1,58 @@
+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: utilities-no-direct-instantiation
+ *
+ * Prevents direct instantiation of classes that should be accessed via the utilities parameter.
+ * Classes like RunView, RunQuery, Metadata, and SimpleVectorService are provided by the runtime
+ * and should be used through the utilities object.
+ *
+ * Severity: high
+ * Applies to: all components
+ */
+let UtilitiesNoDirectInstantiationRule = class UtilitiesNoDirectInstantiationRule extends BaseLintRule {
+    get Name() { return 'utilities-no-direct-instantiation'; }
+    get AppliesTo() { return 'all'; }
+    Test(ast, componentName, componentSpec) {
+        const violations = [];
+        const restrictedClasses = new Map([
+            ['RunView', 'utilities.rv'],
+            ['RunQuery', 'utilities.rq'],
+            ['Metadata', 'utilities.md'],
+            ['SimpleVectorService', 'utilities.ai.VectorService'],
+        ]);
+        traverse(ast, {
+            NewExpression(path) {
+                // Check if instantiating a restricted class
+                if (t.isIdentifier(path.node.callee)) {
+                    const className = path.node.callee.name;
+                    if (restrictedClasses.has(className)) {
+                        const utilityPath = restrictedClasses.get(className);
+                        violations.push({
+                            rule: 'utilities-no-direct-instantiation',
+                            severity: 'high',
+                            line: path.node.loc?.start.line || 0,
+                            column: path.node.loc?.start.column || 0,
+                            message: `Don't instantiate ${className} directly. Use ${utilityPath} instead which is provided in the component's utilities parameter.`,
+                            code: `new ${className}()`,
+                        });
+                    }
+                }
+            },
+        });
+        return violations;
+    }
+};
+UtilitiesNoDirectInstantiationRule = __decorate([
+    RegisterClass(BaseLintRule, 'utilities-no-direct-instantiation')
+], UtilitiesNoDirectInstantiationRule);
+export { UtilitiesNoDirectInstantiationRule };
+//# sourceMappingURL=utilities-no-direct-instantiation.js.map

package/dist/runtime-rules/utilities-no-direct-instantiation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities-no-direct-instantiation.js","sourceRoot":"","sources":["../../src/runtime-rules/utilities-no-direct-instantiation.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,QAAQ,EAAY,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,CAAC,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAI5C;;;;;;;;;GASG;AAEI,IAAM,kCAAkC,GAAxC,MAAM,kCAAmC,SAAQ,YAAY;IAClE,IAAI,IAAI,KAAK,OAAO,mCAAmC,CAAC,CAAC,CAAC;IAC1D,IAAI,SAAS,KAA+B,OAAO,KAAK,CAAC,CAAC,CAAC;IAE3D,IAAI,CAAC,GAAW,EAAE,aAAqB,EAAE,aAA6B;QACpE,MAAM,UAAU,GAAgB,EAAE,CAAC;QACnC,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;YAChC,CAAC,SAAS,EAAE,cAAc,CAAC;YAC3B,CAAC,UAAU,EAAE,cAAc,CAAC;YAC5B,CAAC,UAAU,EAAE,cAAc,CAAC;YAC5B,CAAC,qBAAqB,EAAE,4BAA4B,CAAC;SACtD,CAAC,CAAC;QAEH,QAAQ,CAAC,GAAG,EAAE;YACZ,aAAa,CAAC,IAA+B;gBAC3C,4CAA4C;gBAC5C,IAAI,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;oBACrC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;oBAExC,IAAI,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;wBACrC,MAAM,WAAW,GAAG,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;wBACrD,UAAU,CAAC,IAAI,CAAC;4BACd,IAAI,EAAE,mCAAmC;4BACzC,QAAQ,EAAE,MAAM;4BAChB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC;4BACpC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC;4BACxC,OAAO,EAAE,qBAAqB,SAAS,kBAAkB,WAAW,oEAAoE;4BACxI,IAAI,EAAE,OAAO,SAAS,IAAI;yBAC3B,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;SACF,CAAC,CAAC;QAEH,OAAO,UAAU,CAAC;IAClB,CAAC;CACJ,CAAA;AApCY,kCAAkC;IAD9C,aAAa,CAAC,YAAY,EAAE,mCAAmC,CAAC;GACpD,kCAAkC,CAoC9C"}

package/dist/runtime-rules/validate-component-references.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: validate-component-references
+ *
+ * Validates that component references used in JSX or React.createElement calls
+ * match declared dependencies. Also warns about unused dependencies.
+ *
+ * Severity: critical (for undefined references), low (for unused dependencies)
+ * Applies to: all components
+ */
+export declare class ValidateComponentReferencesRule extends BaseLintRule {
+    get Name(): string;
+    get AppliesTo(): 'all' | 'child' | 'root';
+    Test(ast: t.File, componentName: string, componentSpec?: ComponentSpec): Violation[];
+}
+//# sourceMappingURL=validate-component-references.d.ts.map

package/dist/runtime-rules/validate-component-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-component-references.d.ts","sourceRoot":"","sources":["../../src/runtime-rules/validate-component-references.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,+BAAgC,SAAQ,YAAY;IAC/D,IAAI,IAAI,WAA8C;IACtD,IAAI,SAAS,IAAI,KAAK,GAAG,OAAO,GAAG,MAAM,CAAkB;IAE3D,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,aAAa,GAAG,SAAS,EAAE;CA8PrF"}

package/dist/runtime-rules/validate-component-references.js

@@ -0,0 +1,255 @@
+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: validate-component-references
+ *
+ * Validates that component references used in JSX or React.createElement calls
+ * match declared dependencies. Also warns about unused dependencies.
+ *
+ * Severity: critical (for undefined references), low (for unused dependencies)
+ * Applies to: all components
+ */
+let ValidateComponentReferencesRule = class ValidateComponentReferencesRule extends BaseLintRule {
+    get Name() { return 'validate-component-references'; }
+    get AppliesTo() { return 'all'; }
+    Test(ast, componentName, componentSpec) {
+        const violations = [];
+        // Skip if no spec or no dependencies
+        if (!componentSpec?.dependencies || componentSpec.dependencies.length === 0) {
+            return violations;
+        }
+        // Build a set of available component names from dependencies
+        const availableComponents = new Set();
+        for (const dep of componentSpec.dependencies) {
+            if (dep.location === 'embedded' && dep.name) {
+                availableComponents.add(dep.name);
+            }
+        }
+        // If no embedded dependencies, nothing to validate
+        if (availableComponents.size === 0) {
+            return violations;
+        }
+        // Track ALL defined variables in scope (from destructuring, imports, declarations, etc.)
+        const definedVariables = new Set();
+        const referencedComponents = new Set();
+        // First pass: collect all variable declarations and destructuring
+        traverse(ast, {
+            // Track variable declarations (const x = ...)
+            VariableDeclarator(path) {
+                if (t.isIdentifier(path.node.id)) {
+                    definedVariables.add(path.node.id.name);
+                }
+                else if (t.isObjectPattern(path.node.id)) {
+                    // Track all destructured variables
+                    const collectDestructured = (pattern) => {
+                        for (const prop of pattern.properties) {
+                            if (t.isObjectProperty(prop)) {
+                                if (t.isIdentifier(prop.value)) {
+                                    definedVariables.add(prop.value.name);
+                                }
+                                else if (t.isObjectPattern(prop.value)) {
+                                    collectDestructured(prop.value);
+                                }
+                            }
+                            else if (t.isRestElement(prop) && t.isIdentifier(prop.argument)) {
+                                definedVariables.add(prop.argument.name);
+                            }
+                        }
+                    };
+                    collectDestructured(path.node.id);
+                }
+                else if (t.isArrayPattern(path.node.id)) {
+                    // Track array destructuring
+                    for (const elem of path.node.id.elements) {
+                        if (t.isIdentifier(elem)) {
+                            definedVariables.add(elem.name);
+                        }
+                    }
+                }
+            },
+            // Track function declarations
+            FunctionDeclaration(path) {
+                if (path.node.id) {
+                    definedVariables.add(path.node.id.name);
+                }
+            },
+            // Track class declarations
+            ClassDeclaration(path) {
+                if (path.node.id) {
+                    definedVariables.add(path.node.id.name);
+                }
+            },
+            // Track function parameters
+            Function(path) {
+                for (const param of path.node.params) {
+                    if (t.isIdentifier(param)) {
+                        definedVariables.add(param.name);
+                    }
+                    else if (t.isObjectPattern(param)) {
+                        // Track destructured parameters
+                        const collectParams = (pattern) => {
+                            for (const prop of pattern.properties) {
+                                if (t.isObjectProperty(prop)) {
+                                    if (t.isIdentifier(prop.value)) {
+                                        definedVariables.add(prop.value.name);
+                                    }
+                                    else if (t.isObjectPattern(prop.value)) {
+                                        collectParams(prop.value);
+                                    }
+                                }
+                            }
+                        };
+                        collectParams(param);
+                    }
+                }
+            },
+        });
+        // Second pass: check component usage
+        traverse(ast, {
+            // Look for React.createElement calls
+            CallExpression(path) {
+                const callee = path.node.callee;
+                // Check for React.createElement(ComponentName, ...)
+                if (t.isMemberExpression(callee) &&
+                    t.isIdentifier(callee.object) &&
+                    callee.object.name === 'React' &&
+                    t.isIdentifier(callee.property) &&
+                    callee.property.name === 'createElement') {
+                    const firstArg = path.node.arguments[0];
+                    // If first argument is an identifier (component reference)
+                    if (t.isIdentifier(firstArg)) {
+                        const componentRef = firstArg.name;
+                        // Skip HTML elements and React built-ins
+                        if (!componentRef.match(/^[a-z]/) && componentRef !== 'Fragment') {
+                            // Only check if it's supposed to be a component dependency
+                            // and it's not defined elsewhere in the code
+                            if (availableComponents.has(componentRef)) {
+                                referencedComponents.add(componentRef);
+                            }
+                            else if (!definedVariables.has(componentRef)) {
+                                // Only complain if it's not defined anywhere
+                                const availableList = Array.from(availableComponents).sort().join(', ');
+                                const availableLibs = componentSpec?.libraries
+                                    ?.map((lib) => lib.globalVariable)
+                                    .filter(Boolean)
+                                    .join(', ') || '';
+                                let message = `Component "${componentRef}" is not defined. Available component dependencies: ${availableList}`;
+                                if (availableLibs) {
+                                    message += `. Available libraries: ${availableLibs}`;
+                                }
+                                violations.push({
+                                    rule: 'validate-component-references',
+                                    severity: 'critical',
+                                    line: firstArg.loc?.start.line || 0,
+                                    column: firstArg.loc?.start.column || 0,
+                                    message: message,
+                                    code: `React.createElement(${componentRef}, ...)`,
+                                });
+                            }
+                        }
+                    }
+                }
+            },
+            // Look for JSX elements
+            JSXElement(path) {
+                const openingElement = path.node.openingElement;
+                const elementName = openingElement.name;
+                if (t.isJSXIdentifier(elementName)) {
+                    const componentRef = elementName.name;
+                    // Skip HTML elements and fragments
+                    if (!componentRef.match(/^[a-z]/) && componentRef !== 'Fragment') {
+                        // Track if it's a known component dependency
+                        if (availableComponents.has(componentRef)) {
+                            referencedComponents.add(componentRef);
+                        }
+                        else if (!definedVariables.has(componentRef)) {
+                            // Only complain if it's not defined anywhere (not from libraries, not from declarations)
+                            const availableList = Array.from(availableComponents).sort().join(', ');
+                            const availableLibs = componentSpec?.libraries
+                                ?.map((lib) => lib.globalVariable)
+                                .filter(Boolean)
+                                .join(', ') || '';
+                            let message = `Component "${componentRef}" is not defined. Available component dependencies: ${availableList}`;
+                            if (availableLibs) {
+                                message += `. Available libraries: ${availableLibs}`;
+                            }
+                            violations.push({
+                                rule: 'validate-component-references',
+                                severity: 'critical',
+                                line: elementName.loc?.start.line || 0,
+                                column: elementName.loc?.start.column || 0,
+                                message: message,
+                                code: `<${componentRef} ... />`,
+                            });
+                        }
+                    }
+                }
+            },
+            // Look for destructuring from components prop specifically
+            ObjectPattern(path) {
+                // Check if this is destructuring from a 'components' parameter
+                const parent = path.parent;
+                // Check if it's a function parameter with components
+                if ((t.isFunctionDeclaration(parent) || t.isFunctionExpression(parent) || t.isArrowFunctionExpression(parent)) &&
+                    parent.params.includes(path.node)) {
+                    // Look for components property
+                    for (const prop of path.node.properties) {
+                        if (t.isObjectProperty(prop) && t.isIdentifier(prop.key) && prop.key.name === 'components' && t.isObjectPattern(prop.value)) {
+                            // Check each destructured component
+                            for (const componentProp of prop.value.properties) {
+                                if (t.isObjectProperty(componentProp) && t.isIdentifier(componentProp.key)) {
+                                    const componentRef = componentProp.key.name;
+                                    referencedComponents.add(componentRef);
+                                    if (!availableComponents.has(componentRef)) {
+                                        const availableList = Array.from(availableComponents).sort().join(', ');
+                                        // Try to find similar names for suggestions
+                                        const suggestions = Array.from(availableComponents).filter((name) => name.toLowerCase().includes(componentRef.toLowerCase()) || componentRef.toLowerCase().includes(name.toLowerCase()));
+                                        let message = `Destructured component "${componentRef}" is not found in dependencies. Available components: ${availableList}`;
+                                        if (suggestions.length > 0) {
+                                            message += `. Did you mean: ${suggestions.join(' or ')}?`;
+                                        }
+                                        violations.push({
+                                            rule: 'validate-component-references',
+                                            severity: 'critical',
+                                            line: componentProp.key.loc?.start.line || 0,
+                                            column: componentProp.key.loc?.start.column || 0,
+                                            message: message,
+                                            code: `{ components: { ${componentRef}, ... } }`,
+                                        });
+                                    }
+                                }
+                            }
+                        }
+                    }
+                }
+            },
+        });
+        // Also warn about unused dependencies
+        for (const depName of availableComponents) {
+            if (!referencedComponents.has(depName)) {
+                violations.push({
+                    rule: 'validate-component-references',
+                    severity: 'low',
+                    line: 1,
+                    column: 0,
+                    message: `Component dependency "${depName}" is defined but never used in the code.`,
+                    code: `dependencies: [..., { name: "${depName}", ... }, ...]`,
+                });
+            }
+        }
+        return violations;
+    }
+};
+ValidateComponentReferencesRule = __decorate([
+    RegisterClass(BaseLintRule, 'validate-component-references')
+], ValidateComponentReferencesRule);
+export { ValidateComponentReferencesRule };
+//# sourceMappingURL=validate-component-references.js.map

package/dist/runtime-rules/validate-component-references.js.map

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

package/dist/schema-validation/component-prop-rule.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Component Prop Rule - Unified component property validation
+ *
+ * This rule consolidates all component prop validation:
+ * 1. Prop existence (from dependency-prop-validation)
+ * 2. Required props checking
+ * 3. Prop type validation (via TypeContext)
+ * 4. Semantic constraint validation (via SemanticValidators)
+ * 5. Unknown props warning
+ *
+ * @category schema
+ * @severity high
+ *
+ * ## Rationale
+ * Component props are the contract between components. This rule ensures:
+ * - All required props are provided
+ * - Prop types match expected types
+ * - Prop values meet semantic constraints
+ * - Unknown props are flagged (may be typos)
+ *
+ * ## Integration
+ * - Uses SemanticValidatorRegistry for constraint validation
+ * - Uses TypeInferenceEngine for type checking
+ * - Uses ComponentMetadataEngine for dependency specs
+ *
+ * ## Phase 3 Consolidation
+ * This rule merges:
+ * - dependency-prop-validation (prop existence, required, types, unknown)
+ * - validate-component-props (semantic constraint validation)
+ */
+import * as t from '@babel/types';
+import { ComponentSpec } from '@memberjunction/interactive-component-types';
+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 interface LintContext {
+    componentName: string;
+    componentSpec?: ComponentSpec;
+    typeContext: any;
+    typeEngine: any;
+    controlFlowAnalyzer: any;
+    /** SQL dialect for WHERE clause parsing in semantic validators */
+    sqlDialect?: import('@memberjunction/sql-dialect').SQLParserDialect;
+    /**
+     * Resolver for registry-located dependency components. Caller-supplied
+     * (see LinterOptions.componentResolver). Optional — rules degrade
+     * gracefully when absent.
+     */
+    componentResolver?: (name: string, namespace?: string, registry?: string) => ComponentSpec | undefined;
+}
+/**
+ * ComponentPropRule - Validates all aspects of component property usage
+ *
+ * Validates:
+ * 1. Props exist in component spec (schema validation)
+ * 2. Required props are provided
+ * 3. Prop types match expected types (via TypeContext)
+ * 4. Semantic constraints are met (via SemanticValidators)
+ * 5. Unknown props warning
+ */
+export declare class ComponentPropRule {
+    name: string;
+    appliesTo: 'all' | 'child' | 'root';
+    private readonly standardProps;
+    private readonly reactSpecialProps;
+    /** SQL dialect for semantic validators, set from LintContext during validate() */
+    private _sqlDialect?;
+    /**
+     * Validate component props
+     */
+    validate(ast: t.File, context: LintContext): Violation[];
+    /**
+     * Build map of dependency components to their full specs
+     */
+    private buildDependencySpecs;
+    /**
+     * Build validation context helpers from parent spec's dataRequirements
+     */
+    private buildValidationHelpers;
+    /**
+     * Get element name from JSX opening element
+     */
+    private getElementName;
+    /**
+     * Get set of provided prop names
+     */
+    private getProvidedProps;
+    /**
+     * Get map of provided prop names to their JSXAttribute nodes
+     */
+    private getProvidedPropNodes;
+    /**
+     * Validate required props are provided
+     */
+    private validateRequiredProps;
+    /**
+     * Validate prop types match expected types
+     */
+    private validatePropTypes;
+    /**
+     * Get the type of an expression
+     */
+    private getExpressionType;
+    /**
+     * Check if actual type is compatible with expected type
+     */
+    private checkTypeCompatibility;
+    /**
+     * Validate unknown props (may be typos)
+     */
+    private validateUnknownProps;
+    /**
+     * Find closest matching prop name using Levenshtein distance
+     */
+    private findClosestMatch;
+    /**
+     * Validate semantic constraints on props
+     */
+    private validateSemanticConstraints;
+}
+//# sourceMappingURL=component-prop-rule.d.ts.map