@memberjunction/react-linter 0.0.1 → 5.38.0

package/dist/runtime-rules/unsafe-formatting-methods.js

@@ -0,0 +1,277 @@
+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';
+import { ControlFlowAnalyzer } from '../control-flow-analyzer.js';
+import { TypeInferenceEngine } from '../type-inference-engine.js';
+/**
+ * Rule: unsafe-formatting-methods
+ *
+ * Detects formatting methods (toFixed, toLowerCase, etc.) called on potentially null/undefined
+ * values without optional chaining or null checks. Uses control flow analysis and type inference
+ * to reduce false positives.
+ *
+ * Closure dependencies: ControlFlowAnalyzer, TypeInferenceEngine, LinterOptions,
+ * EntityInfo, EntityFieldInfo (all instantiated locally within the rule)
+ *
+ * Severity: medium-high (depends on entity metadata nullability)
+ * Applies to: all components
+ */
+let UnsafeFormattingMethodsRule = class UnsafeFormattingMethodsRule extends BaseLintRule {
+    get Name() { return 'unsafe-formatting-methods'; }
+    get AppliesTo() { return 'all'; }
+    Test(ast, componentName, componentSpec, options) {
+        const violations = [];
+        // Standard props that are always defined (passed by runtime to all components)
+        const standardProps = new Set(['utilities', 'styles', 'components', 'callbacks', 'savedUserSettings', 'onSaveUserSettings']);
+        // Create control flow analyzer for guard detection
+        const cfa = new ControlFlowAnalyzer(ast, componentSpec);
+        // Create type inference engine for property safety checking
+        const typeInferenceEngine = new TypeInferenceEngine(componentSpec);
+        // Run analysis synchronously (the async part is not needed for basic inference)
+        typeInferenceEngine.analyze(ast);
+        const typeContext = typeInferenceEngine.getTypeContext();
+        /**
+         * Check if an object property is safe to access based on type inference.
+         * Returns true if the object is locally defined with known structure and the property exists.
+         *
+         * Example: const metrics = { winRate: 75.5 }; metrics.winRate.toFixed() is safe
+         */
+        const isKnownObjectProperty = (objectName, propertyName) => {
+            const varType = typeContext.getVariableType(objectName);
+            if (!varType) {
+                return false;
+            }
+            // Check if it's an object type with known fields
+            if (varType.type === 'object' && varType.fields) {
+                const fieldInfo = varType.fields.get(propertyName);
+                // Property exists in the object definition and is non-null
+                return fieldInfo !== undefined && !fieldInfo.nullable;
+            }
+            return false;
+        };
+        // Common formatting methods that can fail on null/undefined
+        const formattingMethods = new Set([
+            // Number methods
+            'toFixed',
+            'toPrecision',
+            'toExponential',
+            // Conversion methods
+            'toLocaleString',
+            'toString',
+            // String methods
+            'toLowerCase',
+            'toUpperCase',
+            'trim',
+            'split',
+            'slice',
+            'substring',
+            'substr',
+            'charAt',
+            'charCodeAt',
+            'indexOf',
+            'lastIndexOf',
+            'padStart',
+            'padEnd',
+            'repeat',
+            'replace',
+        ]);
+        const checkFieldNullability = (propertyName) => {
+            // Step 1: Check if componentSpec has data requirements and utilities are available
+            if (!componentSpec?.dataRequirements?.entities || !options?.utilities?.md?.Entities) {
+                return { found: false, nullable: false };
+            }
+            try {
+                // Step 2: Iterate through only the entities defined in dataRequirements
+                for (const dataReqEntity of componentSpec.dataRequirements.entities) {
+                    const entityName = dataReqEntity.name; // e.g., "AI Prompt Runs"
+                    // Step 3: Find this entity in the full metadata (case insensitive)
+                    // Use proper typing - we know Entities is an array of EntityInfo objects
+                    const fullEntity = options.utilities.md?.Entities.find((e) => e.Name && e.Name.toLowerCase() === entityName.toLowerCase());
+                    if (fullEntity && fullEntity.Fields && Array.isArray(fullEntity.Fields)) {
+                        // Step 4: Look for the field in this specific entity (case insensitive)
+                        const field = fullEntity.Fields.find((f) => f.Name && f.Name.trim().toLowerCase() === propertyName.trim().toLowerCase());
+                        if (field) {
+                            // Field found - check if it's nullable
+                            // In MJ, AllowsNull is a boolean property
+                            return {
+                                found: true,
+                                nullable: field.AllowsNull,
+                                entityName: fullEntity.Name,
+                                fieldName: field.Name,
+                            };
+                        }
+                    }
+                }
+            }
+            catch (error) {
+                // If there's any error accessing metadata, fail gracefully
+                console.warn('Error checking field nullability:', error);
+            }
+            return { found: false, nullable: false };
+        };
+        traverse(ast, {
+            // Check JSX expressions
+            JSXExpressionContainer(path) {
+                const expr = path.node.expression;
+                // Look for object.property.method() pattern
+                if (t.isCallExpression(expr) && t.isMemberExpression(expr.callee) && t.isIdentifier(expr.callee.property)) {
+                    const methodName = expr.callee.property.name;
+                    // Check if it's a formatting method
+                    if (formattingMethods.has(methodName)) {
+                        const callee = expr.callee;
+                        // Check if the object being called on is also a member expression (x.y pattern)
+                        if (t.isMemberExpression(callee.object) && t.isIdentifier(callee.object.property)) {
+                            const propertyName = callee.object.property.name;
+                            // Check if optional chaining is already used
+                            const hasOptionalChaining = callee.object.optional || callee.optional;
+                            // Check if there's a fallback (looking in parent for || or ??)
+                            let hasFallback = false;
+                            const parent = path.parent;
+                            const grandParent = path.parentPath?.parent;
+                            // Check if parent is a logical expression with fallback
+                            if (grandParent && t.isLogicalExpression(grandParent) && (grandParent.operator === '||' || grandParent.operator === '??')) {
+                                hasFallback = true;
+                            }
+                            // Also check conditional expressions
+                            if (grandParent && t.isConditionalExpression(grandParent)) {
+                                hasFallback = true;
+                            }
+                            // Check if inside a null/undefined check using Control Flow Analyzer
+                            const hasNullCheck = cfa.isDefinitelyNonNull(callee.object, path);
+                            // Skip if accessing properties on standard props (guaranteed to be defined)
+                            // Pattern: styles.borders.radius is ALWAYS safe (styles is always provided)
+                            let isStandardProp = false;
+                            if (t.isIdentifier(callee.object.object)) {
+                                const objectName = callee.object.object.name;
+                                if (standardProps.has(objectName)) {
+                                    isStandardProp = true;
+                                }
+                            }
+                            // Skip if the object property is known to be safe via type inference
+                            // Pattern: const metrics = { winRate: 75.5 }; metrics.winRate.toFixed() is safe
+                            // This uses TypeInferenceEngine to track object literal assignments
+                            let isKnownObjectProperty_flag = false;
+                            if (t.isIdentifier(callee.object.object)) {
+                                const objectName = callee.object.object.name;
+                                isKnownObjectProperty_flag = isKnownObjectProperty(objectName, propertyName);
+                            }
+                            if (!hasOptionalChaining && !hasFallback && !hasNullCheck && !isStandardProp && !isKnownObjectProperty_flag) {
+                                // Check entity metadata for this field
+                                const fieldInfo = checkFieldNullability(propertyName);
+                                // Determine severity based on metadata
+                                let severity = 'medium';
+                                let message = `Unsafe formatting method '${methodName}()' called on '${propertyName}'. Consider using optional chaining.`;
+                                if (fieldInfo.found) {
+                                    if (fieldInfo.nullable) {
+                                        severity = 'high';
+                                        message = `Field '${fieldInfo.fieldName}' from entity '${fieldInfo.entityName}' is nullable. Use optional chaining to prevent runtime errors when calling '${methodName}()'.`;
+                                    }
+                                    else {
+                                        // Keep medium severity but note it's non-nullable
+                                        message = `Field '${fieldInfo.fieldName}' from entity '${fieldInfo.entityName}' appears to be non-nullable, but consider using optional chaining for safety when calling '${methodName}()'.`;
+                                    }
+                                }
+                                // Get the object name for better error message
+                                let objectName = '';
+                                if (t.isIdentifier(callee.object.object)) {
+                                    objectName = callee.object.object.name;
+                                }
+                                violations.push({
+                                    rule: 'unsafe-formatting-methods',
+                                    severity: severity,
+                                    line: expr.loc?.start.line || 0,
+                                    column: expr.loc?.start.column || 0,
+                                    message: message,
+                                    code: `${objectName}.${propertyName}.${methodName}() → ${objectName}.${propertyName}?.${methodName}() ?? defaultValue`,
+                                });
+                            }
+                        }
+                    }
+                }
+            },
+            // Also check template literals
+            TemplateLiteral(path) {
+                for (const expr of path.node.expressions) {
+                    // Look for object.property.method() pattern in template expressions
+                    if (t.isCallExpression(expr) && t.isMemberExpression(expr.callee) && t.isIdentifier(expr.callee.property)) {
+                        const methodName = expr.callee.property.name;
+                        // Check if it's a formatting method
+                        if (formattingMethods.has(methodName)) {
+                            const callee = expr.callee;
+                            // Check if the object being called on is also a member expression (x.y pattern)
+                            if (t.isMemberExpression(callee.object) && t.isIdentifier(callee.object.property)) {
+                                const propertyName = callee.object.property.name;
+                                // Check if optional chaining is already used
+                                const hasOptionalChaining = callee.object.optional || callee.optional;
+                                // Check if inside a null/undefined check using Control Flow Analyzer
+                                // Note: For template literals, we need to check the template itself since
+                                // the expression doesn't have its own NodePath
+                                const hasNullCheck = cfa.isDefinitelyNonNull(callee.object, path) ||
+                                    cfa.isProtectedByTernary(callee.object, path);
+                                // Skip if accessing properties on standard props (guaranteed to be defined)
+                                let isStandardProp = false;
+                                if (t.isIdentifier(callee.object.object)) {
+                                    const objectName = callee.object.object.name;
+                                    if (standardProps.has(objectName)) {
+                                        isStandardProp = true;
+                                    }
+                                }
+                                // Skip if the object property is known to be safe via type inference
+                                // Pattern: const metrics = { winRate: 75.5 }; metrics.winRate.toFixed() is safe
+                                // This uses TypeInferenceEngine to track object literal assignments
+                                let isKnownObjectProperty_flag = false;
+                                if (t.isIdentifier(callee.object.object)) {
+                                    const objectName = callee.object.object.name;
+                                    isKnownObjectProperty_flag = isKnownObjectProperty(objectName, propertyName);
+                                }
+                                if (!hasOptionalChaining && !hasNullCheck && !isStandardProp && !isKnownObjectProperty_flag) {
+                                    // Check entity metadata for this field
+                                    const fieldInfo = checkFieldNullability(propertyName);
+                                    // Determine severity based on metadata
+                                    let severity = 'medium';
+                                    let message = `Unsafe formatting method '${methodName}()' called on '${propertyName}' in template literal. Consider using optional chaining.`;
+                                    if (fieldInfo.found) {
+                                        if (fieldInfo.nullable) {
+                                            severity = 'high';
+                                            message = `Field '${propertyName}' is nullable in entity metadata. Use optional chaining to prevent runtime errors when calling '${methodName}()' in template literal.`;
+                                        }
+                                        else {
+                                            // Keep medium severity but note it's non-nullable
+                                            message = `Field '${propertyName}' appears to be non-nullable, but consider using optional chaining for safety when calling '${methodName}()' in template literal.`;
+                                        }
+                                    }
+                                    // Get the object name for better error message
+                                    let objectName = '';
+                                    if (t.isIdentifier(callee.object.object)) {
+                                        objectName = callee.object.object.name;
+                                    }
+                                    violations.push({
+                                        rule: 'unsafe-formatting-methods',
+                                        severity: severity,
+                                        line: expr.loc?.start.line || 0,
+                                        column: expr.loc?.start.column || 0,
+                                        message: message,
+                                        code: `\${${objectName}.${propertyName}.${methodName}()} → \${${objectName}.${propertyName}?.${methodName}() ?? defaultValue}`,
+                                    });
+                                }
+                            }
+                        }
+                    }
+                }
+            },
+        });
+        return violations;
+    }
+};
+UnsafeFormattingMethodsRule = __decorate([
+    RegisterClass(BaseLintRule, 'unsafe-formatting-methods')
+], UnsafeFormattingMethodsRule);
+export { UnsafeFormattingMethodsRule };
+//# sourceMappingURL=unsafe-formatting-methods.js.map

package/dist/runtime-rules/unsafe-formatting-methods.js.map

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

package/dist/runtime-rules/unused-component-dependencies.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: unused-component-dependencies
+ *
+ * Detects declared embedded component dependencies that are not used in the component code.
+ * Checks for various usage patterns including JSX, dot notation, and bracket notation.
+ *
+ * Severity: low
+ * Applies to: all components
+ */
+export declare class UnusedComponentDependenciesRule extends BaseLintRule {
+    get Name(): string;
+    get AppliesTo(): 'all' | 'child' | 'root';
+    Test(ast: t.File, componentName: string, componentSpec?: ComponentSpec): Violation[];
+}
+//# sourceMappingURL=unused-component-dependencies.d.ts.map

package/dist/runtime-rules/unused-component-dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unused-component-dependencies.d.ts","sourceRoot":"","sources":["../../src/runtime-rules/unused-component-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;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;CA0ErF"}

package/dist/runtime-rules/unused-component-dependencies.js

@@ -0,0 +1,90 @@
+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 { BaseLintRule } from '../lint-rule.js';
+/**
+ * Rule: unused-component-dependencies
+ *
+ * Detects declared embedded component dependencies that are not used in the component code.
+ * Checks for various usage patterns including JSX, dot notation, and bracket notation.
+ *
+ * Severity: low
+ * Applies to: all components
+ */
+let UnusedComponentDependenciesRule = class UnusedComponentDependenciesRule extends BaseLintRule {
+    get Name() { return 'unused-component-dependencies'; }
+    get AppliesTo() { return 'all'; }
+    Test(ast, componentName, componentSpec) {
+        const violations = [];
+        // Skip if no dependencies declared
+        if (!componentSpec?.dependencies || componentSpec.dependencies.length === 0) {
+            return violations;
+        }
+        // Filter to only embedded components
+        const embeddedDeps = componentSpec.dependencies.filter((dep) => dep.location === 'embedded' && dep.name);
+        if (embeddedDeps.length === 0) {
+            return violations;
+        }
+        // Get the function body to search within
+        let functionBody = '';
+        traverse(ast, {
+            FunctionDeclaration(path) {
+                if (path.node.id && path.node.id.name === componentName) {
+                    functionBody = path.toString();
+                }
+            },
+        });
+        // If we couldn't find the function body, use the whole code
+        if (!functionBody) {
+            functionBody = ast.toString ? ast.toString() : '';
+        }
+        // Check each component dependency for usage
+        for (const dep of embeddedDeps) {
+            const depName = dep.name;
+            // Check for various usage patterns
+            // Components can be used directly (if destructured) or via components object
+            const usagePatterns = [
+                // Direct usage (after destructuring)
+                '<' + depName + ' ', // JSX: <AccountList />
+                '<' + depName + '>', // JSX: <AccountList>
+                '<' + depName + '/', // JSX self-closing: <AccountList/>
+                depName + '(', // Direct call: AccountList()
+                '= ' + depName, // Assignment: const List = AccountList
+                depName + ' ||', // Fallback: AccountList || DefaultComponent
+                depName + ' &&', // Conditional: AccountList && ...
+                depName + ' ?', // Ternary: AccountList ? ... : ...
+                ', ' + depName, // In parameter/array list
+                '(' + depName, // Start of expression
+                '{' + depName, // In object literal
+                // Via components object
+                'components.' + depName, // Dot notation: components.AccountList
+                "components['" + depName + "']", // Bracket notation single quotes
+                'components["' + depName + '"]', // Bracket notation double quotes
+                'components[`' + depName + '`]', // Bracket notation template literal
+                '<components.' + depName, // JSX via components: <components.AccountList
+            ];
+            const isUsed = usagePatterns.some((pattern) => functionBody.includes(pattern));
+            if (!isUsed) {
+                violations.push({
+                    rule: 'unused-component-dependencies',
+                    severity: 'low',
+                    line: 1,
+                    column: 0,
+                    message: `Component dependency "${depName}" is declared but never used. Consider removing it if not needed.`,
+                    code: `Expected usage: <${depName} /> or <components.${depName} />`,
+                });
+            }
+        }
+        return violations;
+    }
+};
+UnusedComponentDependenciesRule = __decorate([
+    RegisterClass(BaseLintRule, 'unused-component-dependencies')
+], UnusedComponentDependenciesRule);
+export { UnusedComponentDependenciesRule };
+//# sourceMappingURL=unused-component-dependencies.js.map

package/dist/runtime-rules/unused-component-dependencies.js.map

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

package/dist/runtime-rules/unused-libraries.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: unused-libraries
+ *
+ * Detects declared libraries that are not used in the component code.
+ * Libraries declared in the component spec should be referenced in the code.
+ *
+ * Severity: critical (none used), high/low (some unused)
+ * Applies to: all components
+ */
+export declare class UnusedLibrariesRule extends BaseLintRule {
+    get Name(): string;
+    get AppliesTo(): 'all' | 'child' | 'root';
+    Test(ast: t.File, componentName: string, componentSpec?: ComponentSpec): Violation[];
+}
+//# sourceMappingURL=unused-libraries.d.ts.map

package/dist/runtime-rules/unused-libraries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unused-libraries.d.ts","sourceRoot":"","sources":["../../src/runtime-rules/unused-libraries.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,mBAAoB,SAAQ,YAAY;IACnD,IAAI,IAAI,WAAiC;IACzC,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;CA+GrF"}

package/dist/runtime-rules/unused-libraries.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 { traverse } from '../lint-utils.js';
+import { RegisterClass } from '@memberjunction/global';
+import { BaseLintRule } from '../lint-rule.js';
+/**
+ * Rule: unused-libraries
+ *
+ * Detects declared libraries that are not used in the component code.
+ * Libraries declared in the component spec should be referenced in the code.
+ *
+ * Severity: critical (none used), high/low (some unused)
+ * Applies to: all components
+ */
+let UnusedLibrariesRule = class UnusedLibrariesRule extends BaseLintRule {
+    get Name() { return 'unused-libraries'; }
+    get AppliesTo() { return 'all'; }
+    Test(ast, componentName, componentSpec) {
+        const violations = [];
+        // Skip if no libraries declared
+        if (!componentSpec?.libraries || componentSpec.libraries.length === 0) {
+            return violations;
+        }
+        // Get the function body to search within — include root AND child component code
+        let functionBody = '';
+        traverse(ast, {
+            FunctionDeclaration(path) {
+                if (path.node.id && path.node.id.name === componentName) {
+                    functionBody = path.toString();
+                }
+            },
+        });
+        // If we couldn't find the function body, use the whole code
+        if (!functionBody) {
+            functionBody = ast.toString ? ast.toString() : '';
+        }
+        // Also include child component code — libraries declared on the root spec
+        // may be used by child components in multi-component trees
+        if (componentSpec?.dependencies) {
+            for (const dep of componentSpec.dependencies) {
+                if (dep.code) {
+                    functionBody += '\n' + dep.code;
+                }
+                // Include grandchildren too
+                if (dep.dependencies) {
+                    for (const grandchild of dep.dependencies) {
+                        if (grandchild.code) {
+                            functionBody += '\n' + grandchild.code;
+                        }
+                    }
+                }
+            }
+        }
+        // Track which libraries are used and unused
+        const unusedLibraries = [];
+        const usedLibraries = [];
+        // Check each library for usage
+        for (const lib of componentSpec.libraries) {
+            const globalVar = lib.globalVariable;
+            if (!globalVar)
+                continue;
+            // Check for various usage patterns
+            const usagePatterns = [
+                globalVar + '.', // Direct property access: Chart.defaults
+                globalVar + '(', // Direct call: dayjs()
+                'new ' + globalVar + '(', // Constructor: new Chart()
+                globalVar + '[', // Array/property access: XLSX['utils']
+                '= ' + globalVar, // Assignment: const myChart = Chart
+                ', ' + globalVar, // In parameter list
+                '(' + globalVar, // Start of expression
+                '{' + globalVar, // In object literal
+                '<' + globalVar, // JSX component
+                globalVar + ' ', // Followed by space (various uses)
+                'unwrapLibraryComponents(' + globalVar, // unwrapLibraryComponents(antd, ...)
+                'unwrapLibraryComponents( ' + globalVar, // unwrapLibraryComponents( antd, ...)
+            ];
+            const isUsed = usagePatterns.some((pattern) => functionBody.includes(pattern));
+            if (isUsed) {
+                usedLibraries.push({ name: lib.name, globalVariable: globalVar });
+            }
+            else {
+                unusedLibraries.push({ name: lib.name, globalVariable: globalVar });
+            }
+        }
+        // Determine severity based on usage patterns
+        const totalLibraries = componentSpec.libraries.length;
+        const usedCount = usedLibraries.length;
+        if (usedCount === 0 && totalLibraries > 0) {
+            // CRITICAL: No libraries used at all
+            violations.push({
+                rule: 'unused-libraries',
+                severity: 'critical',
+                line: 1,
+                column: 0,
+                message: `CRITICAL: None of the ${totalLibraries} declared libraries are used. This indicates missing core functionality.`,
+                code: `Unused libraries: ${unusedLibraries.map((l) => l.name).join(', ')}`,
+            });
+        }
+        else if (unusedLibraries.length > 0) {
+            // Some libraries unused, severity depends on ratio
+            for (const lib of unusedLibraries) {
+                const severity = totalLibraries === 1 ? 'high' : 'low';
+                const contextMessage = totalLibraries === 1
+                    ? "This is the only declared library and it's not being used."
+                    : `${usedCount} of ${totalLibraries} libraries are being used. This might be an alternative/optional library.`;
+                violations.push({
+                    rule: 'unused-libraries',
+                    severity: severity,
+                    line: 1,
+                    column: 0,
+                    message: `Library "${lib.name}" (${lib.globalVariable}) is declared but not used. ${contextMessage}`,
+                    code: `Consider removing if not needed: { name: "${lib.name}", globalVariable: "${lib.globalVariable}" }`,
+                });
+            }
+        }
+        return violations;
+    }
+};
+UnusedLibrariesRule = __decorate([
+    RegisterClass(BaseLintRule, 'unused-libraries')
+], UnusedLibrariesRule);
+export { UnusedLibrariesRule };
+//# sourceMappingURL=unused-libraries.js.map

package/dist/runtime-rules/unused-libraries.js.map

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

package/dist/runtime-rules/use-function-declaration.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: use-function-declaration
+ *
+ * Ensures that components use function declaration syntax instead of
+ * arrow functions or function expressions.
+ *
+ * Severity: critical
+ * Applies to: all components
+ */
+export declare class UseFunctionDeclarationRule extends BaseLintRule {
+    get Name(): string;
+    get AppliesTo(): 'all' | 'child' | 'root';
+    Test(ast: t.File, componentName: string): Violation[];
+}
+//# sourceMappingURL=use-function-declaration.d.ts.map

package/dist/runtime-rules/use-function-declaration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-function-declaration.d.ts","sourceRoot":"","sources":["../../src/runtime-rules/use-function-declaration.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGhD;;;;;;;;GAQG;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,EAAE,aAAa,EAAE,MAAM,GAAG,SAAS,EAAE;CA2HtD"}