@brad-frost-web/eddie-brain 0.32.0

package/dist/analyze/naming-validator.js

@@ -0,0 +1,430 @@
+/**
+ * Naming Validator
+ *
+ * Validates BEM/BEMIT naming conventions in Eddie components:
+ * - CSS class prefixes (ed-c-, ed-l-, ed-u-, ed-r-, ed-p-, etc.)
+ * - BEM structure (block__element--modifier)
+ * - Detects unclassed HTML elements in Lit component templates
+ *
+ * Understands Lit-specific patterns:
+ * - Only scans inside html`...` tagged template literals
+ * - Recognizes dynamic class bindings (class="${expr}")
+ * - Skips JSDoc/comment blocks
+ * - Skips .stories.ts files for unclassed element checks (slot content is fine)
+ */
+import { readFile } from 'fs/promises';
+import glob from 'fast-glob';
+export class NamingValidator {
+    /**
+     * Class prefix patterns
+     */
+    validPrefixes = [
+        /^ed-c-/, // Component
+        /^ed-l-/, // Layout
+        /^ed-u-/, // Utility
+        /^is-/, // State
+        /^has-/, // State (has)
+        /^ed-r-/, // Recipe
+        /^ed-p-/, // Page
+    ];
+    /**
+     * HTML elements that can exist without a class
+     * - SVG internals, slots, templates, scripts, style tags
+     * - Custom elements (contain a hyphen) always skip
+     */
+    unclassedAllowed = new Set([
+        'svg', 'path', 'g', 'circle', 'rect', 'ellipse', 'line',
+        'polyline', 'polygon', 'text', 'tspan', 'image', 'use',
+        'defs', 'symbol', 'marker', 'linearGradient', 'radialGradient',
+        'stop', 'clipPath', 'mask', 'pattern',
+        'style', 'script', 'template', 'slot',
+        // Lit-specific
+        'br', 'hr', 'img', 'input', 'meta', 'link', 'source', 'track', 'wbr',
+    ]);
+    /**
+     * Validate a single component file
+     */
+    async validateFile(filePath) {
+        try {
+            const content = await readFile(filePath, 'utf-8');
+            const issues = [];
+            const isTemplate = filePath.endsWith('.ts') || filePath.endsWith('.tsx');
+            const isStyle = filePath.endsWith('.scss');
+            const isStories = filePath.includes('.stories.');
+            if (isTemplate) {
+                issues.push(...this.validateTemplate(filePath, content, isStories));
+            }
+            if (isStyle) {
+                issues.push(...this.validateStyleFile(filePath, content));
+            }
+            return issues;
+        }
+        catch (error) {
+            return [{
+                    id: `naming-validate-error-${Date.now()}`,
+                    category: 'naming',
+                    severity: 'error',
+                    message: `Failed to validate file: ${error instanceof Error ? error.message : String(error)}`,
+                    file: filePath,
+                    autoFixable: false,
+                }];
+        }
+    }
+    /**
+     * Validate all component files in a directory
+     */
+    async validateDirectory(dirPath) {
+        const componentFiles = await glob(['**/*.ts', '**/*.tsx', '**/*.scss'], {
+            cwd: dirPath,
+            absolute: true,
+            ignore: ['**/node_modules/**', '**/*.d.ts'],
+        });
+        const allIssues = [];
+        for (const file of componentFiles) {
+            const issues = await this.validateFile(file);
+            allIssues.push(...issues);
+        }
+        return allIssues;
+    }
+    /**
+     * Validate a single CSS class name string
+     */
+    validateClassName(className) {
+        const result = this.classNameValidation(className);
+        if (!result.valid) {
+            return {
+                id: `naming-class-${className}`,
+                category: 'naming',
+                severity: 'error',
+                message: `Invalid class name "${className}": ${result.issues.join('; ')}`,
+                actual: className,
+                expected: this.suggestClassName(className),
+                autoFixable: false,
+                file: 'unknown',
+            };
+        }
+        return null;
+    }
+    // ===========================================================================
+    // Template validation — Lit-aware
+    // ===========================================================================
+    /**
+     * Validate HTML elements inside Lit templates.
+     *
+     * Key behaviors:
+     * - Extracts only the content inside html`...` tagged template literals
+     * - Strips JSDoc/block comments before scanning
+     * - Recognizes dynamic class bindings: class="${...}" counts as having a class
+     * - Skips unclassed-element checks in .stories.ts (slot content is fine)
+     * - Skips self-closing void elements and custom elements (contain hyphen)
+     */
+    validateTemplate(filePath, content, isStories) {
+        const issues = [];
+        // Strip all block comments (/** ... */, /* ... */) to avoid scanning JSDoc
+        const stripped = this.stripBlockComments(content);
+        // Extract html`...` template regions with their starting line offsets
+        const templateRegions = this.extractLitTemplates(stripped);
+        if (templateRegions.length === 0) {
+            // No Lit templates found — nothing to validate for unclassed elements
+            // Still check any static class="" attributes in the whole file
+            return issues;
+        }
+        for (const region of templateRegions) {
+            // Check for unclassed elements (skip in stories files)
+            if (!isStories) {
+                issues.push(...this.checkUnclassedElements(filePath, region.content, region.startLine));
+            }
+            // Check static class names in templates
+            issues.push(...this.checkStaticClassNames(filePath, region.content, region.startLine));
+        }
+        return issues;
+    }
+    /**
+     * Strip block comments (/* ... * /) including JSDoc (/** ... * /)
+     * Preserves line count by replacing comment content with blank lines.
+     */
+    stripBlockComments(content) {
+        // Replace block comments with the same number of newlines to preserve line numbering
+        return content.replace(/\/\*[\s\S]*?\*\//g, (match) => {
+            const newlineCount = (match.match(/\n/g) || []).length;
+            return '\n'.repeat(newlineCount);
+        });
+    }
+    /**
+     * Extract content from html`...` tagged template literals.
+     * Returns regions with their content and the line offset where they start.
+     */
+    extractLitTemplates(content) {
+        const regions = [];
+        // Match html`...` with support for nested ${} expressions
+        // We use a state machine approach since regex can't handle nested backticks well
+        const lines = content.split('\n');
+        let inTemplate = false;
+        let depth = 0;
+        let templateLines = [];
+        let templateStartLine = 0;
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // Skip single-line comments
+            const trimmed = line.trim();
+            if (trimmed.startsWith('//'))
+                continue;
+            if (!inTemplate) {
+                // Look for html` start
+                const htmlStart = line.indexOf('html`');
+                if (htmlStart !== -1) {
+                    inTemplate = true;
+                    depth = 1;
+                    templateStartLine = i;
+                    // Get the part after html`
+                    const afterStart = line.substring(htmlStart + 5);
+                    // Count backticks to track depth (simplified — handles most cases)
+                    templateLines = [afterStart];
+                    // Check if template closes on same line
+                    if (this.templateClosesOnLine(afterStart)) {
+                        inTemplate = false;
+                        regions.push({
+                            content: templateLines.join('\n'),
+                            startLine: templateStartLine,
+                        });
+                        templateLines = [];
+                    }
+                }
+            }
+            else {
+                templateLines.push(line);
+                // Check if template closes on this line
+                // Look for a backtick that's not inside a ${} expression
+                if (this.templateClosesOnLine(line)) {
+                    inTemplate = false;
+                    regions.push({
+                        content: templateLines.join('\n'),
+                        startLine: templateStartLine,
+                    });
+                    templateLines = [];
+                }
+            }
+        }
+        return regions;
+    }
+    /**
+     * Simplified check: does a template close on this line?
+     * Looks for a ` that's not preceded by ${ context.
+     */
+    templateClosesOnLine(line) {
+        // Count unescaped backticks not inside ${}
+        let inExpr = 0;
+        for (let i = 0; i < line.length; i++) {
+            if (line[i] === '$' && line[i + 1] === '{') {
+                inExpr++;
+                i++; // skip {
+            }
+            else if (line[i] === '}' && inExpr > 0) {
+                inExpr--;
+            }
+            else if (line[i] === '`' && inExpr === 0) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Check for HTML elements without classes in template content.
+     *
+     * Understands:
+     * - class="${expr}" — dynamic class, counts as having a class
+     * - class="literal" — static class
+     * - styleModifier="..." — Eddie's pattern for passing classes to children
+     * - Tags with a hyphen are custom elements (always skip)
+     */
+    checkUnclassedElements(filePath, templateContent, startLine) {
+        const issues = [];
+        const lines = templateContent.split('\n');
+        // Skip TextPassage (prose content is allowed unclassed) and test files
+        if (filePath.includes('text-passage') ||
+            filePath.includes('TextPassage') ||
+            filePath.includes('.test.') ||
+            filePath.includes('.spec.')) {
+            return issues;
+        }
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // Find opening HTML tags — include hyphens in tag name to capture custom elements
+            const tagMatches = line.matchAll(/<([a-zA-Z][a-zA-Z0-9-]*)\b([^>]*?)>/g);
+            for (const match of tagMatches) {
+                const tagName = match[1].toLowerCase();
+                const attributes = match[2];
+                // Skip: custom elements (have hyphen), void elements, allowed elements
+                if (tagName.includes('-'))
+                    continue;
+                if (this.unclassedAllowed.has(tagName))
+                    continue;
+                // Check if element has a class attribute (static or dynamic)
+                const hasClass = /class\s*=/.test(attributes) || // class="..." or class="${...}"
+                    /styleModifier\s*=/.test(attributes) || // Eddie's styleModifier pattern
+                    /\$\{.*class/.test(attributes); // ${classMap(...)} etc.
+                if (!hasClass) {
+                    issues.push({
+                        id: `naming-unclassed-${tagName}-${startLine + i}`,
+                        category: 'naming',
+                        severity: 'warning',
+                        message: `Unclassed <${tagName}> element in Lit template. Consider adding a BEM class.`,
+                        file: filePath,
+                        line: startLine + i + 1,
+                        actual: `<${tagName}>`,
+                        expected: `<${tagName} class="ed-c-...">`,
+                        autoFixable: false,
+                    });
+                }
+            }
+        }
+        return issues;
+    }
+    /**
+     * Check static class name values in templates for Eddie naming compliance.
+     * Only validates literal class strings, not dynamic ${} expressions.
+     */
+    checkStaticClassNames(filePath, templateContent, startLine) {
+        const issues = [];
+        const lines = templateContent.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // Match static class="literal-value" (not class="${dynamic}")
+            const staticClassMatches = line.matchAll(/class\s*=\s*"([^"$]+)"/g);
+            for (const match of staticClassMatches) {
+                const classValue = match[1].trim();
+                if (!classValue)
+                    continue;
+                const classNames = classValue.split(/\s+/);
+                for (const className of classNames) {
+                    if (!className)
+                        continue;
+                    // Skip Lit expressions that leaked through
+                    if (className.includes('${') || className.includes('}'))
+                        continue;
+                    const result = this.classNameValidation(className);
+                    if (!result.valid) {
+                        issues.push({
+                            id: `naming-class-${className}-${startLine + i}`,
+                            category: 'naming',
+                            severity: 'error',
+                            message: `Invalid class name "${className}" in template. ${result.issues.join('; ')}`,
+                            file: filePath,
+                            line: startLine + i + 1,
+                            actual: className,
+                            expected: this.suggestClassName(className),
+                            autoFixable: true,
+                        });
+                    }
+                }
+            }
+        }
+        return issues;
+    }
+    // ===========================================================================
+    // SCSS validation
+    // ===========================================================================
+    /**
+     * Validate class names in SCSS file
+     */
+    validateStyleFile(filePath, content) {
+        const issues = [];
+        const lines = content.split('\n');
+        let inBlockComment = false;
+        lines.forEach((line, lineIndex) => {
+            const trimmed = line.trim();
+            // Track block comments
+            if (trimmed.includes('/*'))
+                inBlockComment = true;
+            if (trimmed.includes('*/')) {
+                inBlockComment = false;
+                return;
+            }
+            if (inBlockComment)
+                return;
+            // Skip single-line comments
+            if (trimmed.startsWith('//'))
+                return;
+            // Find class definitions (.className { or .className &)
+            const classDefMatches = line.matchAll(/\.([a-zA-Z][a-zA-Z0-9_-]*)\s*[{&,]/g);
+            for (const match of classDefMatches) {
+                const className = match[1];
+                // Skip Sass variables and interpolations
+                if (className.startsWith('$') || className.includes('#{'))
+                    continue;
+                const result = this.classNameValidation(className);
+                if (!result.valid) {
+                    issues.push({
+                        id: `naming-scss-class-${className}-${lineIndex}`,
+                        category: 'naming',
+                        severity: 'error',
+                        message: `Invalid class name ".${className}" in SCSS. ${result.issues.join('; ')}`,
+                        file: filePath,
+                        line: lineIndex + 1,
+                        actual: className,
+                        expected: this.suggestClassName(className),
+                        autoFixable: false,
+                    });
+                }
+            }
+        });
+        return issues;
+    }
+    // ===========================================================================
+    // Class name validation logic
+    // ===========================================================================
+    /**
+     * Validate a single class name string against Eddie's BEM/BEMIT conventions
+     */
+    classNameValidation(className) {
+        const issues = [];
+        if (!className) {
+            return { valid: false, issues: ['Class name is empty'] };
+        }
+        // Check for valid prefix
+        const hasValidPrefix = this.validPrefixes.some((pattern) => pattern.test(className));
+        if (!hasValidPrefix) {
+            issues.push('Does not start with valid prefix (ed-c-, ed-l-, ed-u-, ed-r-, ed-p-, is-, has-)');
+        }
+        // Extract the part after prefix for BEM validation
+        let bemPart = className;
+        for (const prefix of this.validPrefixes) {
+            const match = className.match(prefix);
+            if (match) {
+                bemPart = className.slice(match[0].length);
+                break;
+            }
+        }
+        // Validate BEM structure (block__element--modifier)
+        if (bemPart && !this.validateBemStructure(bemPart)) {
+            issues.push('Invalid BEM structure. Use block, block__element, or block--modifier format');
+        }
+        // Check for uppercase letters (BEM uses lowercase only)
+        if (/[A-Z]/.test(className)) {
+            issues.push('BEM classes must be lowercase');
+        }
+        return {
+            valid: issues.length === 0,
+            issues,
+        };
+    }
+    /**
+     * Validate BEM structure (block__element--modifier)
+     * Allows: block, block__element, block--modifier, block__element--modifier
+     * Parts can contain hyphens (single) for multi-word names.
+     */
+    validateBemStructure(bemPart) {
+        const bemRegex = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*(?:__[a-z][a-z0-9]*(?:-[a-z0-9]+)*)?(?:--[a-z][a-z0-9]*(?:-[a-z0-9]+)*)?$/;
+        return bemRegex.test(bemPart);
+    }
+    /**
+     * Suggest a corrected class name
+     */
+    suggestClassName(className) {
+        if (!this.validPrefixes.some((p) => p.test(className))) {
+            return `ed-c-${className.toLowerCase()}`;
+        }
+        return className.toLowerCase().replace(/[^a-z0-9_-]/g, '');
+    }
+}
+//# sourceMappingURL=naming-validator.js.map

package/dist/analyze/naming-validator.js.map

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

package/dist/analyze/slot-contract-validator.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Slot Contract Validator
+ *
+ * Detects the silent-drop class of bug filed under #595, #627, #639: Eddie
+ * markup that uses a `slot="X"` attribute referencing a slot the component
+ * doesn't declare. The unknown slot reaches the shadow DOM with no matching
+ * `<slot name="X">`, the content is dropped, and nothing in the browser
+ * surfaces the failure.
+ *
+ * Scope:
+ *  - `.html` files (consumer projects, boilerplates)
+ *  - Lit `html\`...\`` template regions inside `.ts` / `.tsx` files
+ *
+ * Strategy:
+ *  - Find every `<ed-...>` opening tag
+ *  - Walk forward to its matching close tag (depth-tracked)
+ *  - Inside that range, find every immediate-child element with a
+ *    `slot="NAME"` attribute
+ *  - Look up the parent component in the index; if NAME is not in the
+ *    declared slot list, emit a finding
+ *
+ * The check is intentionally conservative: false positives are worse than
+ * false negatives because validators run in tight CI loops and noisy
+ * output gets ignored. Components missing from the index are skipped
+ * (rather than flagged as unknown), and the regex is forgiving about
+ * whitespace and quote style.
+ */
+import type { ComponentEntry, HealthIssue } from '../types.js';
+interface ComponentLookup {
+    getComponent(tagName: string): ComponentEntry | undefined;
+}
+export declare class SlotContractValidator {
+    private readonly index;
+    constructor(index: ComponentLookup);
+    /**
+     * Validate a single file for slot-contract violations.
+     * Returns an empty array for files we don't scan (e.g. .scss).
+     */
+    validateFile(filePath: string): Promise<HealthIssue[]>;
+    /**
+     * Scan one chunk of markup for slot-contract violations.
+     * `startLine` is the 0-based line offset of the chunk within the file —
+     * issue line numbers are reported relative to the file, not the chunk.
+     */
+    private scanRegion;
+    /**
+     * Look up the component, then scan the inner markup for any
+     * `slot="NAME"` attribute. Emit a finding for each NAME that the
+     * component doesn't declare.
+     */
+    private scanInner;
+    /**
+     * Walk forward from `startIdx` to find the matching `</tag>` for an
+     * already-opened `<tag …>`. Tracks open/close depth so nested same-named
+     * tags don't fool the matcher.
+     */
+    private findMatchingClose;
+    /**
+     * Extract Lit `html\`...\`` template regions from a TS/TSX file.
+     * Mirrors NamingValidator.extractLitTemplates, but stripped down — we
+     * don't need to handle every nesting edge case, just the common ones.
+     */
+    private extractLitTemplates;
+    private templateClosesOnLine;
+    private lineOf;
+}
+export {};
+//# sourceMappingURL=slot-contract-validator.d.ts.map

package/dist/analyze/slot-contract-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot-contract-validator.d.ts","sourceRoot":"","sources":["../../src/analyze/slot-contract-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/D,UAAU,eAAe;IACvB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;CAC3D;AAED,qBAAa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,eAAe;IAEnD;;;OAGG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAgC5D;;;;OAIG;IACH,OAAO,CAAC,UAAU;IA+BlB;;;;OAIG;IACH,OAAO,CAAC,SAAS;IA6CjB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAwBzB;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAsC3B,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,MAAM;CAOf"}