@schemyx/mcp 0.1.2 → 0.1.4

package/dist/codebase-scanner/extractors.d.ts

@@ -37,6 +37,7 @@ export declare function extractCssVariableReferences(content: string): string[];
 export declare function extractClassReferences(content: string, classExpressions?: ClassExpression[]): string[];
 export declare function extractClassExpressions(content: string): ClassExpression[];
 export declare function extractComponentStyleDefinitions(content: string): ComponentStyleDefinition[];
+export declare function readJsxClassSources(source: string): string[];
 export declare function extractThemeTokens(relPath: string, content: string): ThemeToken[];
 export declare function extractInlineStyles(content: string): InlineStyle[];
 interface OpeningTagInfo {
@@ -151,6 +152,7 @@ export declare function createRoleDensityKey(classes: string[], children?: UiEle
 export declare function createRoleSurfaceKey(classes: string[]): string;
 export declare function createRoleLayoutKey(kind: string, tagName: string, classes: string[], children?: UiElementChildSummary[], parentClasses?: string[]): string;
 export declare function isCompactHeroEyebrow(classes: string[]): boolean;
+export declare function isPlainTextEyebrow(classes: string[], layoutRole?: string): boolean;
 export declare function isOverlayPill(classes: string[]): boolean;
 export declare function isHeroHeadingScale(classes: string[]): boolean;
 export declare function isOversizedHeadingScale(classes: string[]): boolean;
@@ -158,6 +160,8 @@ export declare function isMetricValueScale(classes: string[]): boolean;
 export declare function isCompactStatValue(classes: string[]): boolean;
 export declare function isLargeMetricValue(classes: string[]): boolean;
 export declare function isCompactStatCard(classes: string[], childRoles: string[]): boolean;
+export declare function isCompactMetricGrid(classes: string[]): boolean;
+export declare function isCtaPanelShell(classes: string[], childRoles?: string[]): boolean;
 export declare function isInteractiveServiceCard(classes: string[]): boolean;
 export declare function isStaticArticleCard(classes: string[]): boolean;
 export declare function isMediaPanelCard(classes: string[], childKinds: string[], childRoles: string[]): boolean;

package/dist/codebase-scanner/extractors.js

@@ -32,6 +32,7 @@ exports.extractCssVariableReferences = extractCssVariableReferences;
 exports.extractClassReferences = extractClassReferences;
 exports.extractClassExpressions = extractClassExpressions;
 exports.extractComponentStyleDefinitions = extractComponentStyleDefinitions;
+exports.readJsxClassSources = readJsxClassSources;
 exports.extractThemeTokens = extractThemeTokens;
 exports.extractInlineStyles = extractInlineStyles;
 exports.nearestCssSelector = nearestCssSelector;
@@ -120,6 +121,7 @@ exports.createRoleDensityKey = createRoleDensityKey;
 exports.createRoleSurfaceKey = createRoleSurfaceKey;
 exports.createRoleLayoutKey = createRoleLayoutKey;
 exports.isCompactHeroEyebrow = isCompactHeroEyebrow;
+exports.isPlainTextEyebrow = isPlainTextEyebrow;
 exports.isOverlayPill = isOverlayPill;
 exports.isHeroHeadingScale = isHeroHeadingScale;
 exports.isOversizedHeadingScale = isOversizedHeadingScale;
@@ -127,6 +129,8 @@ exports.isMetricValueScale = isMetricValueScale;
 exports.isCompactStatValue = isCompactStatValue;
 exports.isLargeMetricValue = isLargeMetricValue;
 exports.isCompactStatCard = isCompactStatCard;
+exports.isCompactMetricGrid = isCompactMetricGrid;
+exports.isCtaPanelShell = isCtaPanelShell;
 exports.isInteractiveServiceCard = isInteractiveServiceCard;
 exports.isStaticArticleCard = isStaticArticleCard;
 exports.isMediaPanelCard = isMediaPanelCard;
@@ -810,6 +814,7 @@ function extractClassExpressions(content) {
 function extractComponentStyleDefinitions(content) {
     const definitions = [];
     const cvaPattern = /(?:export\s+)?(?:const|let|var)\s+([A-Za-z_$][\w$]*)\s*=\s*cva\s*\(/g;
+    const forwardRefPattern = /(?:export\s+)?(?:const|let|var)\s+([A-Z][A-Za-z0-9_$]*)\s*=\s*(?:React\.)?forwardRef\b/g;
     for (const match of content.matchAll(cvaPattern)) {
         if (isInsideQuotedString(content, match.index ?? 0)) {
             continue;
@@ -838,6 +843,37 @@ function extractComponentStyleDefinitions(content) {
             source: (0, utils_1.truncate)(call, 2200),
         });
     }
+    for (const match of content.matchAll(forwardRefPattern)) {
+        if (isInsideQuotedString(content, match.index ?? 0)) {
+            continue;
+        }
+        const forwardRefIndex = content.indexOf('forwardRef', match.index ?? 0);
+        const call = readBalancedCall(content, forwardRefIndex);
+        if (!call) {
+            continue;
+        }
+        const classSources = readJsxClassSources(call);
+        const styleHelper = readPrimaryClassHelperUsage(call);
+        const baseClasses = (0, utils_1.unique)(classSources.flatMap((classSource) => analyzeClassSource(classSource).defaultClasses));
+        const classes = (0, utils_1.unique)([
+            ...classSources.flatMap((classSource) => analyzeClassSource(classSource).classes),
+            ...baseClasses,
+        ]);
+        if (!classes.length && !styleHelper) {
+            continue;
+        }
+        definitions.push({
+            name: match[1],
+            kind: 'component-wrapper',
+            line: (0, utils_1.lineNumberAt)(content, match.index ?? 0),
+            baseClasses,
+            variants: {},
+            defaultVariants: {},
+            classes,
+            ...(styleHelper ? { styleHelper: styleHelper.name } : {}),
+            source: (0, utils_1.truncate)(call, 2200),
+        });
+    }
     for (const match of content.matchAll(/(?:export\s+)?(?:const|let|var)\s+([A-Za-z_$][\w$]*(?:Classes|ClassNames|Styles|Variants|Config|Map))\s*=\s*\{/g)) {
         if (isInsideQuotedString(content, match.index ?? 0)) {
             continue;
@@ -864,6 +900,25 @@ function extractComponentStyleDefinitions(content) {
     }
     return (0, utils_1.uniqueBy)(definitions, (definition) => `${definition.name}:${definition.line}`).slice(0, 80);
 }
+function readJsxClassSources(source) {
+    const sources = [];
+    for (const pattern of [
+        /\bclass(?:Name)?\s*=\s*(["'`])([\s\S]*?)\1/g,
+        /\bclass(?:Name)?\s*=\s*\{\s*(["'`])([\s\S]*?)\1\s*\}/g,
+    ]) {
+        for (const match of source.matchAll(pattern)) {
+            sources.push(match[2] ?? match[1] ?? '');
+        }
+    }
+    for (const match of source.matchAll(/\bclass(?:Name)?\s*=\s*\{/g)) {
+        const openIndex = source.indexOf('{', match.index ?? 0);
+        const block = readBalancedBlock(source, openIndex);
+        if (block) {
+            sources.push(block.slice(1, -1));
+        }
+    }
+    return (0, utils_1.unique)(sources.filter(Boolean)).slice(0, 24);
+}
 function extractThemeTokens(relPath, content) {
     const shouldExtract = /(?:theme|token|tailwind|config|globals|styles?|css|scss)/i.test(relPath) ||
         /--[a-zA-Z0-9-_]+\s*:/.test(content);
@@ -1766,6 +1821,7 @@ function isTypographyClass(className) {
 }
 function isTypographyScaleBase(base) {
     return (/^(?:font-|leading-|tracking-|line-clamp|whitespace-|break-|truncate|text-balance|text-pretty|text-nowrap|text-wrap)/.test(base) ||
+        /^(?:uppercase|lowercase|capitalize|normal-case)$/.test(base) ||
         /^(?:fs-|fw-|lh-|display-|lead|small|text-uppercase|text-lowercase|text-capitalize)/.test(base) ||
         /^text-(?:xs|sm|base|lg|xl|[2-9]xl|\[[^\]]+\])/.test(base) ||
         /^max-w-\[(?:\d+(?:\.\d+)?)?ch\]/.test(base));
@@ -2254,7 +2310,11 @@ function createUiRoleSignature(input) {
     }
     if (kind === 'layout') {
         roleGroup = 'layout';
-        if (layout === 'split-media-layout') {
+        if (layout === 'compact-metric-grid-layout') {
+            role = 'compact-metric-grid-layout';
+            flags.add('compact-metric-grid');
+        }
+        else if (layout === 'split-media-layout') {
             role = 'split-media-layout';
             flags.add('split-media');
         }
@@ -2317,6 +2377,10 @@ function createUiRoleSignature(input) {
             role = 'hero-stat-card-compact';
             flags.add('compact-stat-card');
         }
+        else if (isCtaPanelShell(classes, childRoles)) {
+            role = 'cta-panel-shell';
+            flags.add('cta-panel');
+        }
         else if (isInteractiveServiceCard(classes)) {
             role = 'interactive-service-card';
             flags.add('interactive-card');
@@ -2335,7 +2399,11 @@ function createUiRoleSignature(input) {
     }
     if (kind === 'text') {
         roleGroup = 'text';
-        if (isCompactStatValue(classes)) {
+        if (isPlainTextEyebrow(classes, input.layoutRole)) {
+            role = 'section-eyebrow-text';
+            flags.add('plain-eyebrow');
+        }
+        else if (isCompactStatValue(classes)) {
             role = 'compact-stat-value';
             flags.add('compact-stat-value');
         }
@@ -2389,7 +2457,7 @@ function exactRoleClassFacts(classes) {
             isSizingClass(className) ||
             isLayoutClass(className) ||
             isStateClass(className) ||
-            /^(?:bg-|text-|border|rounded|shadow|backdrop|opacity|ring|outline|z-|absolute|relative|fixed|sticky|top-|right-|bottom-|left-|overflow-|object-|aspect-|group|transition|duration|ease)/.test(base));
+            /^(?:bg-|text-|border|rounded|shadow|backdrop|opacity|ring|outline|z-|absolute|relative|fixed|sticky|top-|right-|bottom-|left-|overflow-|object-|aspect-|auto-rows-|grid-cols-|grid-rows-|group|transition|duration|ease)/.test(base));
     })).slice(0, 120);
 }
 function createRoleScaleKey(classes, children = []) {
@@ -2461,6 +2529,10 @@ function createRoleLayoutKey(kind, tagName, classes, children = [], parentClasse
         (baseSet.has('right-3') || baseSet.has('right-4'))) {
         return 'absolute-bottom-right-overlay';
     }
+    if (isCompactMetricGrid(classes) ||
+        isCompactMetricGrid(parentClasses)) {
+        return 'compact-metric-grid-layout';
+    }
     if ((baseSet.has('grid') || parentBaseSet.has('grid')) &&
         hasMediaChild &&
         hasTextChildren &&
@@ -2492,6 +2564,18 @@ function isCompactHeroEyebrow(classes) {
         bases.some((base) => /^py-(?:1\.5|2)$/.test(base)) &&
         bases.some((base) => /^px-(?:3|4|5)$/.test(base)));
 }
+function isPlainTextEyebrow(classes, layoutRole) {
+    const bases = classes.map(utils_1.classBase);
+    const baseSet = new Set(bases);
+    const hasPlainTextScale = classes.some((className) => /(?:^|:)text-(?:xs|sm|\[(?:10|11|12|13|14)px\])(?:\/\d+|\]\/\d+)?$/.test(className));
+    const hasSurfaceTreatment = bases.some((base) => /^(?:bg-|border|rounded|shadow|ring|outline|backdrop)/.test(base));
+    const hasPillSpacing = bases.some((base) => /^px-/.test(base)) || bases.some((base) => /^py-/.test(base));
+    return (layoutRole === 'eyebrow-or-badge' &&
+        baseSet.has('uppercase') &&
+        hasPlainTextScale &&
+        !hasSurfaceTreatment &&
+        !hasPillSpacing);
+}
 function isOverlayPill(classes) {
     const bases = classes.map(utils_1.classBase);
     const baseSet = new Set(bases);
@@ -2544,6 +2628,34 @@ function isCompactStatCard(classes, childRoles) {
             bases.some((base) => /^p-(?:4|5)$/.test(base)) &&
             !baseSet.has('group')));
 }
+function isCompactMetricGrid(classes) {
+    const bases = classes.map(utils_1.classBase);
+    const baseSet = new Set(bases);
+    const hasCompactGap = bases.some((base) => /^gap-(?:2|3|4)$/.test(base));
+    const hasConstrainedWidth = classes.some((className) => /(?:^|:)(?:max-w-(?:2xl|3xl|4xl)|lg:max-w-(?:2xl|3xl|4xl)|max-w-\[[^\]]+\])$/.test(className));
+    const hasDenseColumns = classes.some((className) => /(?:^|:)(?:grid-cols-[34]|grid-cols-\[[^\]]+\]|lg:grid-cols-[34]|md:grid-cols-[34])$/.test(className));
+    return (baseSet.has('grid') &&
+        (baseSet.has('auto-rows-fr') || baseSet.has('items-stretch')) &&
+        hasCompactGap &&
+        hasDenseColumns &&
+        hasConstrainedWidth);
+}
+function isCtaPanelShell(classes, childRoles = []) {
+    const bases = classes.map(utils_1.classBase);
+    const baseSet = new Set(bases);
+    const hasLargePanelShape = bases.some((base) => /^rounded-\[(?:2[4-9]|3\d)px\]$/.test(base)) ||
+        bases.some((base) => /^rounded-(?:2xl|3xl)$/.test(base));
+    const hasSpaciousPadding = bases.some((base) => /^p-(?:8|10|12|14|16)$/.test(base)) ||
+        classes.some((className) => /(?:^|:)p-(?:8|10|12|14|16)$/.test(className));
+    const hasCalloutSurface = bases.some((base) => /^bg-/.test(base)) &&
+        bases.some((base) => /^border/.test(base)) &&
+        (baseSet.has('overflow-hidden') || bases.some((base) => /^shadow/.test(base)));
+    const hasTextHierarchy = childRoles.includes('section-heading') ||
+        childRoles.includes('section-eyebrow-text') ||
+        childRoles.includes('body-copy') ||
+        childRoles.includes('action-button');
+    return hasLargePanelShape && hasSpaciousPadding && hasCalloutSurface && hasTextHierarchy;
+}
 function isInteractiveServiceCard(classes) {
     const bases = classes.map(utils_1.classBase);
     const baseSet = new Set(bases);