@buoy-design/core 0.2.0 → 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Buoy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/analysis/analyzers/example-analyzer.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Example Code Analyzer - Example Code vs Production Code Analysis
+ *
+ * Detects story files and marks components as "example usage".
+ * Compares production code against story examples to understand intended usage.
+ *
+ * Phase 4.3 of BUOY_ROADMAP.md
+ */
+import type { Component, DriftSignal } from "../../models/index.js";
+export type ComponentContext = "production" | "example" | "test" | "unknown";
+export interface ComponentWithContext extends Component {
+    /** Context where this component was found */
+    context: ComponentContext;
+    /** Related example components (for production components) */
+    relatedExamples?: Component[];
+    /** Related production components (for example components) */
+    relatedProduction?: Component[];
+}
+/**
+ * Determine if a file path is example/story code
+ */
+export declare function isExampleFile(path: string): boolean;
+/**
+ * Determine if a file path is test code
+ */
+export declare function isTestFile(path: string): boolean;
+/**
+ * Classify a component's context based on its file path
+ */
+export declare function classifyComponentContext(component: Component): ComponentContext;
+/**
+ * Annotate components with their context and link related components
+ */
+export declare function annotateComponentContexts(components: Component[]): ComponentWithContext[];
+/**
+ * Analyze example coverage - which production components have examples
+ */
+export declare function analyzeExampleCoverage(components: Component[]): {
+    production: Component[];
+    withExamples: Component[];
+    withoutExamples: Component[];
+    exampleOnly: Component[];
+    coveragePercent: number;
+};
+/**
+ * Compare production component against its example usages
+ * Detects patterns used in examples that should be in production
+ */
+export declare function compareProductionToExamples(production: ComponentWithContext): Array<{
+    type: "missing-variant" | "missing-prop" | "example-only-pattern";
+    description: string;
+    exampleSource: string;
+}>;
+/**
+ * Check example code compliance and generate drift signals
+ */
+export declare function checkExampleCompliance(components: Component[]): DriftSignal[];
+//# sourceMappingURL=example-analyzer.d.ts.map

package/dist/analysis/analyzers/example-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-analyzer.d.ts","sourceRoot":"","sources":["../../../src/analysis/analyzers/example-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAmB,MAAM,uBAAuB,CAAC;AAwCrF,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAE7E,MAAM,WAAW,oBAAqB,SAAQ,SAAS;IACrD,6CAA6C;IAC7C,OAAO,EAAE,gBAAgB,CAAC;IAC1B,6DAA6D;IAC7D,eAAe,CAAC,EAAE,SAAS,EAAE,CAAC;IAC9B,6DAA6D;IAC7D,iBAAiB,CAAC,EAAE,SAAS,EAAE,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,SAAS,GAAG,gBAAgB,CAa/E;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,SAAS,EAAE,GACtB,oBAAoB,EAAE,CA4BxB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,SAAS,EAAE,GACtB;IACD,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,YAAY,EAAE,SAAS,EAAE,CAAC;IAC1B,eAAe,EAAE,SAAS,EAAE,CAAC;IAC7B,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACzB,CAmBA;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,oBAAoB,GAC/B,KAAK,CAAC;IACP,IAAI,EAAE,iBAAiB,GAAG,cAAc,GAAG,sBAAsB,CAAC;IAClE,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC,CAyDD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,WAAW,EAAE,CAmG7E"}

package/dist/analysis/analyzers/example-analyzer.js

@@ -0,0 +1,262 @@
+/**
+ * Example Code Analyzer - Example Code vs Production Code Analysis
+ *
+ * Detects story files and marks components as "example usage".
+ * Compares production code against story examples to understand intended usage.
+ *
+ * Phase 4.3 of BUOY_ROADMAP.md
+ */
+import { createStableDriftId } from "../../models/index.js";
+/**
+ * Safely get path from component source (handles discriminated union)
+ */
+function getSourcePath(source) {
+    if (source.type === "react" || source.type === "vue" || source.type === "svelte") {
+        return source.path;
+    }
+    return null;
+}
+// Patterns that identify example/story code
+const EXAMPLE_FILE_PATTERNS = [
+    /\.stories\.[jt]sx?$/,
+    /\.story\.[jt]sx?$/,
+    /\.examples?\.[jt]sx?$/,
+    /\.demo\.[jt]sx?$/,
+    /\.showcase\.[jt]sx?$/,
+    /\/stories\//,
+    /\/examples?\//,
+    /\/demos?\//,
+    /\/playground\//,
+    /\/sandbox\//,
+    /__stories__\//,
+    /__examples__\//,
+    /\/docs\//,
+    /\.mdx$/,
+];
+// Patterns that identify test code (not example, but also not production)
+const TEST_FILE_PATTERNS = [
+    /\.test\.[jt]sx?$/,
+    /\.spec\.[jt]sx?$/,
+    /\/__tests__\//,
+    /\/tests?\//,
+    /\.e2e\.[jt]sx?$/,
+];
+/**
+ * Determine if a file path is example/story code
+ */
+export function isExampleFile(path) {
+    return EXAMPLE_FILE_PATTERNS.some((p) => p.test(path));
+}
+/**
+ * Determine if a file path is test code
+ */
+export function isTestFile(path) {
+    return TEST_FILE_PATTERNS.some((p) => p.test(path));
+}
+/**
+ * Classify a component's context based on its file path
+ */
+export function classifyComponentContext(component) {
+    const path = getSourcePath(component.source) || "";
+    if (isExampleFile(path)) {
+        return "example";
+    }
+    if (isTestFile(path)) {
+        return "test";
+    }
+    if (path) {
+        return "production";
+    }
+    return "unknown";
+}
+/**
+ * Annotate components with their context and link related components
+ */
+export function annotateComponentContexts(components) {
+    const annotated = components.map((c) => ({
+        ...c,
+        context: classifyComponentContext(c),
+    }));
+    // Build lookup maps
+    const byName = new Map();
+    for (const comp of annotated) {
+        const name = comp.name.toLowerCase();
+        const existing = byName.get(name) || [];
+        existing.push(comp);
+        byName.set(name, existing);
+    }
+    // Link related components
+    for (const comp of annotated) {
+        const name = comp.name.toLowerCase();
+        const related = byName.get(name) || [];
+        if (comp.context === "production") {
+            comp.relatedExamples = related.filter((r) => r.context === "example" && r.id !== comp.id);
+        }
+        else if (comp.context === "example") {
+            comp.relatedProduction = related.filter((r) => r.context === "production" && r.id !== comp.id);
+        }
+    }
+    return annotated;
+}
+/**
+ * Analyze example coverage - which production components have examples
+ */
+export function analyzeExampleCoverage(components) {
+    const annotated = annotateComponentContexts(components);
+    const production = annotated.filter((c) => c.context === "production");
+    const withExamples = production.filter((c) => (c.relatedExamples?.length || 0) > 0);
+    const withoutExamples = production.filter((c) => (c.relatedExamples?.length || 0) === 0);
+    const exampleOnly = annotated.filter((c) => c.context === "example" && (c.relatedProduction?.length || 0) === 0);
+    return {
+        production,
+        withExamples,
+        withoutExamples,
+        exampleOnly,
+        coveragePercent: production.length > 0
+            ? Math.round((withExamples.length / production.length) * 100)
+            : 100,
+    };
+}
+/**
+ * Compare production component against its example usages
+ * Detects patterns used in examples that should be in production
+ */
+export function compareProductionToExamples(production) {
+    const issues = [];
+    if (!production.relatedExamples || production.relatedExamples.length === 0) {
+        return issues;
+    }
+    // Collect all props and variants used in examples
+    const exampleProps = new Set();
+    const exampleVariants = new Set();
+    for (const example of production.relatedExamples) {
+        for (const prop of example.props) {
+            exampleProps.add(prop.name.toLowerCase());
+        }
+        for (const variant of example.variants) {
+            exampleVariants.add(variant.name.toLowerCase());
+        }
+    }
+    // Compare against production props
+    const productionProps = new Set(production.props.map((p) => p.name.toLowerCase()));
+    const productionVariants = new Set(production.variants.map((v) => v.name.toLowerCase()));
+    // Props in examples but not in production
+    for (const prop of exampleProps) {
+        if (!productionProps.has(prop)) {
+            const exampleComp = production.relatedExamples.find((e) => e.props.some((p) => p.name.toLowerCase() === prop));
+            issues.push({
+                type: "missing-prop",
+                description: `Prop "${prop}" used in examples but not defined in production component`,
+                exampleSource: exampleComp ? getSourcePath(exampleComp.source) || "unknown" : "unknown",
+            });
+        }
+    }
+    // Variants in examples but not in production
+    for (const variant of exampleVariants) {
+        if (!productionVariants.has(variant)) {
+            const exampleComp = production.relatedExamples.find((e) => e.variants.some((v) => v.name.toLowerCase() === variant));
+            issues.push({
+                type: "missing-variant",
+                description: `Variant "${variant}" used in examples but not defined in production component`,
+                exampleSource: exampleComp ? getSourcePath(exampleComp.source) || "unknown" : "unknown",
+            });
+        }
+    }
+    return issues;
+}
+/**
+ * Check example code compliance and generate drift signals
+ */
+export function checkExampleCompliance(components) {
+    const drifts = [];
+    const coverage = analyzeExampleCoverage(components);
+    // Flag production components without examples (info level)
+    for (const comp of coverage.withoutExamples) {
+        // Skip internal/utility components that typically don't need examples
+        const name = comp.name.toLowerCase();
+        if (name.includes("context") ||
+            name.includes("provider") ||
+            name.includes("wrapper") ||
+            name.includes("internal") ||
+            name.includes("utils")) {
+            continue;
+        }
+        drifts.push({
+            id: createStableDriftId("missing-documentation", comp.name),
+            type: "missing-documentation",
+            severity: "info",
+            source: {
+                entityType: "component",
+                entityId: comp.id,
+                entityName: comp.name,
+                location: getSourcePath(comp.source) || "",
+            },
+            message: `Component "${comp.name}" has no example/story files`,
+            details: {
+                suggestions: [
+                    "Add a .stories.tsx file to document component usage",
+                    "Create examples showing common use cases",
+                    "Consider adding to Storybook for interactive documentation",
+                ],
+            },
+            detectedAt: new Date(),
+        });
+    }
+    // Compare production to examples for inconsistencies
+    const annotated = annotateComponentContexts(components);
+    for (const comp of annotated.filter((c) => c.context === "production")) {
+        const issues = compareProductionToExamples(comp);
+        for (const issue of issues) {
+            drifts.push({
+                id: createStableDriftId("semantic-mismatch", comp.name, {
+                    property: issue.type,
+                }),
+                type: "semantic-mismatch",
+                severity: "warning",
+                source: {
+                    entityType: "component",
+                    entityId: comp.id,
+                    entityName: comp.name,
+                    location: getSourcePath(comp.source) || "",
+                },
+                message: `${comp.name}: ${issue.description}`,
+                details: {
+                    expected: "Props/variants defined in production should match example usage",
+                    actual: issue.description,
+                    affectedFiles: [issue.exampleSource],
+                    suggestions: [
+                        "Add missing prop/variant to production component",
+                        "Update examples to use only defined props/variants",
+                        "Document any intentional differences",
+                    ],
+                },
+                detectedAt: new Date(),
+            });
+        }
+    }
+    // Flag example-only components (might be orphaned examples)
+    for (const comp of coverage.exampleOnly) {
+        drifts.push({
+            id: createStableDriftId("orphaned-component", `example:${comp.name}`),
+            type: "orphaned-component",
+            severity: "info",
+            source: {
+                entityType: "component",
+                entityId: comp.id,
+                entityName: comp.name,
+                location: getSourcePath(comp.source) || "",
+            },
+            message: `Example "${comp.name}" has no corresponding production component`,
+            details: {
+                suggestions: [
+                    "This might be a planned component - create the production version",
+                    "If this is a demo-only component, document it as such",
+                    "Remove if the example is outdated",
+                ],
+            },
+            detectedAt: new Date(),
+        });
+    }
+    return drifts;
+}
+//# sourceMappingURL=example-analyzer.js.map

package/dist/analysis/analyzers/example-analyzer.js.map

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

package/dist/analysis/analyzers/index.d.ts

@@ -3,4 +3,7 @@ export * from "./duplicate-detector.js";
 export * from "./prop-analyzer.js";
 export * from "./accessibility-analyzer.js";
 export * from "./pattern-analyzer.js";
+export * from "./variant-analyzer.js";
+export * from "./token-utility-analyzer.js";
+export * from "./example-analyzer.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/analysis/analyzers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analysis/analyzers/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analysis/analyzers/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AAGtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC"}

package/dist/analysis/analyzers/index.js

@@ -3,4 +3,8 @@ export * from "./duplicate-detector.js";
 export * from "./prop-analyzer.js";
 export * from "./accessibility-analyzer.js";
 export * from "./pattern-analyzer.js";
+// Phase 4 analyzers
+export * from "./variant-analyzer.js";
+export * from "./token-utility-analyzer.js";
+export * from "./example-analyzer.js";
 //# sourceMappingURL=index.js.map

package/dist/analysis/analyzers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analysis/analyzers/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analysis/analyzers/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AAEtC,oBAAoB;AACpB,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC"}

package/dist/analysis/analyzers/token-utility-analyzer.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Token Utility Analyzer - Design Token Utility Function Detection
+ *
+ * Detects design token utility functions in the codebase (e.g., getSpacing, getRadius)
+ * and flags hardcoded values that could use these utilities instead.
+ *
+ * Phase 4.2 of BUOY_ROADMAP.md
+ */
+import type { Component, DriftSignal } from "../../models/index.js";
+export declare const TOKEN_UTILITY_PATTERNS: {
+    pattern: RegExp;
+    category: string;
+    name: string;
+}[];
+export interface DetectedUtility {
+    /** Utility function name */
+    name: string;
+    /** Category of token (spacing, color, etc.) */
+    category: string;
+    /** File where utility was found */
+    file: string;
+    /** Line number if available */
+    line?: number;
+}
+export interface UtilityAnalysisResult {
+    /** Utilities detected in the codebase */
+    availableUtilities: DetectedUtility[];
+    /** Map of category -> utility names */
+    utilitiesByCategory: Map<string, string[]>;
+}
+/**
+ * Detect token utility functions from source file contents
+ *
+ * Note: Component metadata doesn't include source code, so utilities must be
+ * detected from file content provided separately (e.g., via additional theme files).
+ */
+export declare function detectTokenUtilities(_components: Component[], additionalSources?: Array<{
+    content: string;
+    file: string;
+}>): UtilityAnalysisResult;
+/**
+ * Check if hardcoded values could use available token utilities
+ */
+export declare function checkTokenUtilityUsage(components: Component[], utilityAnalysis: UtilityAnalysisResult): DriftSignal[];
+/**
+ * Generate a summary of token utility usage in the codebase
+ */
+export declare function summarizeTokenUtilityUsage(components: Component[], utilityAnalysis: UtilityAnalysisResult): {
+    totalComponents: number;
+    componentsWithHardcodedValues: number;
+    componentsUsingUtilities: number;
+    hardcodedByCategory: Map<string, number>;
+    suggestions: string[];
+};
+//# sourceMappingURL=token-utility-analyzer.d.ts.map

package/dist/analysis/analyzers/token-utility-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-utility-analyzer.d.ts","sourceRoot":"","sources":["../../../src/analysis/analyzers/token-utility-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAmB,MAAM,uBAAuB,CAAC;AAcrF,eAAO,MAAM,sBAAsB;;;;GA6ClC,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,yCAAyC;IACzC,kBAAkB,EAAE,eAAe,EAAE,CAAC;IACtC,uCAAuC;IACvC,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC5C;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,SAAS,EAAE,EACxB,iBAAiB,CAAC,EAAE,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAC3D,qBAAqB,CA6BvB;AAsBD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,SAAS,EAAE,EACvB,eAAe,EAAE,qBAAqB,GACrC,WAAW,EAAE,CA2Cf;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,SAAS,EAAE,EACvB,eAAe,EAAE,qBAAqB,GACrC;IACD,eAAe,EAAE,MAAM,CAAC;IACxB,6BAA6B,EAAE,MAAM,CAAC;IACtC,wBAAwB,EAAE,MAAM,CAAC;IACjC,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAuCA"}

package/dist/analysis/analyzers/token-utility-analyzer.js

@@ -0,0 +1,190 @@
+/**
+ * Token Utility Analyzer - Design Token Utility Function Detection
+ *
+ * Detects design token utility functions in the codebase (e.g., getSpacing, getRadius)
+ * and flags hardcoded values that could use these utilities instead.
+ *
+ * Phase 4.2 of BUOY_ROADMAP.md
+ */
+import { createStableDriftId } from "../../models/index.js";
+/**
+ * Safely get path from component source (handles discriminated union)
+ */
+function getSourcePath(source) {
+    if (source.type === "react" || source.type === "vue" || source.type === "svelte") {
+        return source.path;
+    }
+    return null;
+}
+// Common design token utility function patterns
+export const TOKEN_UTILITY_PATTERNS = [
+    // Spacing utilities
+    { pattern: /\bgetSpacing\b/, category: "spacing", name: "getSpacing" },
+    { pattern: /\bspacing\(/, category: "spacing", name: "spacing()" },
+    { pattern: /\btheme\.spacing\b/, category: "spacing", name: "theme.spacing" },
+    { pattern: /\bspace\[/, category: "spacing", name: "space[]" },
+    // Border radius utilities
+    { pattern: /\bgetRadius\b/, category: "radius", name: "getRadius" },
+    { pattern: /\bradii\(/, category: "radius", name: "radii()" },
+    { pattern: /\btheme\.radii\b/, category: "radius", name: "theme.radii" },
+    { pattern: /\bborderRadius\[/, category: "radius", name: "borderRadius[]" },
+    // Font size utilities
+    { pattern: /\bgetFontSize\b/, category: "fontSize", name: "getFontSize" },
+    { pattern: /\bfontSize\(/, category: "fontSize", name: "fontSize()" },
+    { pattern: /\btheme\.fontSizes\b/, category: "fontSize", name: "theme.fontSizes" },
+    { pattern: /\bfontSizes\[/, category: "fontSize", name: "fontSizes[]" },
+    // Color utilities
+    { pattern: /\bgetColor\b/, category: "color", name: "getColor" },
+    { pattern: /\bcolors\(/, category: "color", name: "colors()" },
+    { pattern: /\btheme\.colors\b/, category: "color", name: "theme.colors" },
+    { pattern: /\bcolors\[/, category: "color", name: "colors[]" },
+    // Shadow utilities
+    { pattern: /\bgetShadow\b/, category: "shadow", name: "getShadow" },
+    { pattern: /\bshadows\(/, category: "shadow", name: "shadows()" },
+    { pattern: /\btheme\.shadows\b/, category: "shadow", name: "theme.shadows" },
+    // Generic token utilities
+    { pattern: /\bgetToken\b/, category: "generic", name: "getToken" },
+    { pattern: /\buseToken\b/, category: "generic", name: "useToken" },
+    { pattern: /\btoken\(/, category: "generic", name: "token()" },
+    { pattern: /\bcssVar\(/, category: "generic", name: "cssVar()" },
+    { pattern: /\b--[a-z]+-[a-z]+/, category: "cssVariable", name: "CSS Variable" },
+    // Chakra-style utilities
+    { pattern: /\buseStyleConfig\b/, category: "generic", name: "useStyleConfig" },
+    { pattern: /\buseTheme\b/, category: "generic", name: "useTheme" },
+    // Mantine-style utilities
+    { pattern: /\buseMantineTheme\b/, category: "generic", name: "useMantineTheme" },
+    { pattern: /\brem\(/, category: "spacing", name: "rem()" },
+    { pattern: /\bem\(/, category: "spacing", name: "em()" },
+];
+/**
+ * Detect token utility functions from source file contents
+ *
+ * Note: Component metadata doesn't include source code, so utilities must be
+ * detected from file content provided separately (e.g., via additional theme files).
+ */
+export function detectTokenUtilities(_components, additionalSources) {
+    const utilities = [];
+    const seenUtilities = new Set();
+    // Scan additional sources (e.g., theme files, config files)
+    if (additionalSources) {
+        for (const source of additionalSources) {
+            for (const util of TOKEN_UTILITY_PATTERNS) {
+                if (util.pattern.test(source.content) && !seenUtilities.has(util.name)) {
+                    seenUtilities.add(util.name);
+                    utilities.push({
+                        name: util.name,
+                        category: util.category,
+                        file: source.file,
+                    });
+                }
+            }
+        }
+    }
+    // Group by category
+    const utilitiesByCategory = new Map();
+    for (const util of utilities) {
+        const existing = utilitiesByCategory.get(util.category) || [];
+        existing.push(util.name);
+        utilitiesByCategory.set(util.category, existing);
+    }
+    return { availableUtilities: utilities, utilitiesByCategory };
+}
+/**
+ * Map hardcoded value type to utility category
+ */
+function mapValueTypeToCategory(type) {
+    switch (type) {
+        case "spacing":
+        case "fontSize":
+            return "spacing";
+        case "color":
+            return "color";
+        case "borderRadius":
+        case "radius":
+            return "radius";
+        case "shadow":
+            return "shadow";
+        default:
+            return null;
+    }
+}
+/**
+ * Check if hardcoded values could use available token utilities
+ */
+export function checkTokenUtilityUsage(components, utilityAnalysis) {
+    const drifts = [];
+    for (const component of components) {
+        const hardcodedValues = component.metadata.hardcodedValues || [];
+        for (const hardcoded of hardcodedValues) {
+            const category = mapValueTypeToCategory(hardcoded.type);
+            if (!category)
+                continue;
+            const availableUtils = utilityAnalysis.utilitiesByCategory.get(category);
+            if (!availableUtils || availableUtils.length === 0)
+                continue;
+            // Found a hardcoded value that has a utility available
+            drifts.push({
+                id: createStableDriftId("hardcoded-value", component.name, {
+                    property: hardcoded.property,
+                    actual: hardcoded.value,
+                }),
+                type: "hardcoded-value",
+                severity: "info",
+                source: {
+                    entityType: "component",
+                    entityId: component.id,
+                    entityName: component.name,
+                    location: hardcoded.location || getSourcePath(component.source) || "",
+                },
+                message: `Component "${component.name}" has hardcoded ${hardcoded.type} value "${hardcoded.value}" that could use ${availableUtils[0]}`,
+                details: {
+                    expected: `Use token utility: ${availableUtils.join(" or ")}`,
+                    actual: `Hardcoded value: ${hardcoded.value}`,
+                    suggestions: [
+                        `Replace "${hardcoded.value}" with ${availableUtils[0]}(...)`,
+                        `Available utilities: ${availableUtils.join(", ")}`,
+                        `Check if a design token exists for this value`,
+                    ],
+                },
+                detectedAt: new Date(),
+            });
+        }
+    }
+    return drifts;
+}
+/**
+ * Generate a summary of token utility usage in the codebase
+ */
+export function summarizeTokenUtilityUsage(components, utilityAnalysis) {
+    const componentsWithHardcoded = components.filter((c) => (c.metadata.hardcodedValues?.length || 0) > 0);
+    // Count hardcoded values by category
+    const hardcodedByCategory = new Map();
+    for (const component of components) {
+        for (const h of component.metadata.hardcodedValues || []) {
+            const category = mapValueTypeToCategory(h.type);
+            if (category) {
+                hardcodedByCategory.set(category, (hardcodedByCategory.get(category) || 0) + 1);
+            }
+        }
+    }
+    // Generate suggestions
+    const suggestions = [];
+    for (const [category, count] of hardcodedByCategory) {
+        const utils = utilityAnalysis.utilitiesByCategory.get(category);
+        if (utils && utils.length > 0) {
+            suggestions.push(`${count} hardcoded ${category} values could use ${utils[0]}`);
+        }
+        else {
+            suggestions.push(`Consider adding a token utility for ${category} (${count} hardcoded values)`);
+        }
+    }
+    return {
+        totalComponents: components.length,
+        componentsWithHardcodedValues: componentsWithHardcoded.length,
+        // Note: Utility usage count requires source code analysis which is done at scan time
+        componentsUsingUtilities: 0,
+        hardcodedByCategory,
+        suggestions,
+    };
+}
+//# sourceMappingURL=token-utility-analyzer.js.map

package/dist/analysis/analyzers/token-utility-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-utility-analyzer.js","sourceRoot":"","sources":["../../../src/analysis/analyzers/token-utility-analyzer.ts"],"names":[],"mappings":"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"}

package/dist/analysis/analyzers/variant-analyzer.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Variant Analyzer - Cross-Variant Consistency Checking
+ *
+ * Detects components in variant directories (e.g., registry/default/, registry/new-york/)
+ * and flags differences between same-named components across variants.
+ *
+ * Phase 4.1 of BUOY_ROADMAP.md
+ */
+import type { Component, DriftSignal, Severity } from "../../models/index.js";
+export interface VariantGroup {
+    /** Component name (shared across variants) */
+    componentName: string;
+    /** Map of variant name -> component */
+    variants: Map<string, Component>;
+}
+export interface VariantDifference {
+    /** Type of difference */
+    type: "prop-missing" | "prop-type" | "variant-missing" | "style-value";
+    /** Affected prop or variant name */
+    field: string;
+    /** Variant A name and value */
+    variantA: {
+        name: string;
+        value: unknown;
+    };
+    /** Variant B name and value */
+    variantB: {
+        name: string;
+        value: unknown;
+    };
+    /** Severity of the difference */
+    severity: Severity;
+}
+/**
+ * Extract variant name from component path
+ * @returns variant name or null if not in a variant directory
+ */
+export declare function extractVariantName(path: string): string | null;
+/**
+ * Group components by name across variants
+ */
+export declare function groupComponentsByVariant(components: Component[]): VariantGroup[];
+/**
+ * Compare two components across variants and find differences
+ */
+export declare function compareVariants(componentA: Component, variantA: string, componentB: Component, variantB: string): VariantDifference[];
+/**
+ * Check all component variants for consistency and generate drift signals
+ */
+export declare function checkVariantConsistency(components: Component[]): DriftSignal[];
+//# sourceMappingURL=variant-analyzer.d.ts.map

package/dist/analysis/analyzers/variant-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variant-analyzer.d.ts","sourceRoot":"","sources":["../../../src/analysis/analyzers/variant-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAmB,MAAM,uBAAuB,CAAC;AA6B/F,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,IAAI,EAAE,cAAc,GAAG,WAAW,GAAG,iBAAiB,GAAG,aAAa,CAAC;IACvE,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3C,+BAA+B;IAC/B,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3C,iCAAiC;IACjC,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ9D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,YAAY,EAAE,CAkChF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,SAAS,EACrB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,SAAS,EACrB,QAAQ,EAAE,MAAM,GACf,iBAAiB,EAAE,CAsGrB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,WAAW,EAAE,CA2F9E"}

package/dist/analysis/analyzers/variant-analyzer.js

@@ -0,0 +1,258 @@
+/**
+ * Variant Analyzer - Cross-Variant Consistency Checking
+ *
+ * Detects components in variant directories (e.g., registry/default/, registry/new-york/)
+ * and flags differences between same-named components across variants.
+ *
+ * Phase 4.1 of BUOY_ROADMAP.md
+ */
+import { createStableDriftId } from "../../models/index.js";
+/**
+ * Safely get path from component source (handles discriminated union)
+ */
+function getSourcePath(source) {
+    if (source.type === "react" || source.type === "vue" || source.type === "svelte") {
+        return source.path;
+    }
+    return null;
+}
+// Common variant directory patterns
+const VARIANT_PATTERNS = [
+    // shadcn/ui registry variants
+    /registry\/([^/]+)\/ui\//,
+    /registry\/([^/]+)\/components\//,
+    /registry\/([^/]+)\/blocks\//,
+    // Generic theme/style variants
+    /themes?\/([^/]+)\//,
+    /styles?\/([^/]+)\//,
+    /variants?\/([^/]+)\//,
+    // Platform variants
+    /platforms?\/([^/]+)\//,
+    // Brand variants
+    /brands?\/([^/]+)\//,
+];
+/**
+ * Extract variant name from component path
+ * @returns variant name or null if not in a variant directory
+ */
+export function extractVariantName(path) {
+    for (const pattern of VARIANT_PATTERNS) {
+        const match = path.match(pattern);
+        if (match && match[1]) {
+            return match[1];
+        }
+    }
+    return null;
+}
+/**
+ * Group components by name across variants
+ */
+export function groupComponentsByVariant(components) {
+    const groups = new Map();
+    for (const component of components) {
+        const path = getSourcePath(component.source) || "";
+        const variantName = extractVariantName(path);
+        if (!variantName)
+            continue;
+        const normalizedName = component.name.toLowerCase();
+        let variantMap = groups.get(normalizedName);
+        if (!variantMap) {
+            variantMap = new Map();
+            groups.set(normalizedName, variantMap);
+        }
+        // Store only the first component found for each variant
+        if (!variantMap.has(variantName)) {
+            variantMap.set(variantName, component);
+        }
+    }
+    // Filter to only groups with multiple variants
+    const result = [];
+    for (const [name, variants] of groups) {
+        if (variants.size > 1) {
+            result.push({
+                componentName: name,
+                variants,
+            });
+        }
+    }
+    return result;
+}
+/**
+ * Compare two components across variants and find differences
+ */
+export function compareVariants(componentA, variantA, componentB, variantB) {
+    const differences = [];
+    // Compare props
+    const propsA = new Map(componentA.props.map((p) => [p.name.toLowerCase(), p]));
+    const propsB = new Map(componentB.props.map((p) => [p.name.toLowerCase(), p]));
+    // Props in A but not in B
+    for (const [name, prop] of propsA) {
+        if (!propsB.has(name)) {
+            differences.push({
+                type: "prop-missing",
+                field: prop.name,
+                variantA: { name: variantA, value: prop },
+                variantB: { name: variantB, value: undefined },
+                severity: prop.required ? "warning" : "info",
+            });
+        }
+        else {
+            const propB = propsB.get(name);
+            if (prop.type !== propB.type) {
+                differences.push({
+                    type: "prop-type",
+                    field: prop.name,
+                    variantA: { name: variantA, value: prop.type },
+                    variantB: { name: variantB, value: propB.type },
+                    severity: "warning",
+                });
+            }
+        }
+    }
+    // Props in B but not in A
+    for (const [name, prop] of propsB) {
+        if (!propsA.has(name)) {
+            differences.push({
+                type: "prop-missing",
+                field: prop.name,
+                variantA: { name: variantA, value: undefined },
+                variantB: { name: variantB, value: prop },
+                severity: prop.required ? "warning" : "info",
+            });
+        }
+    }
+    // Compare component variants (sizes, colors, etc.)
+    const variantsA = new Set(componentA.variants.map((v) => v.name.toLowerCase()));
+    const variantsB = new Set(componentB.variants.map((v) => v.name.toLowerCase()));
+    for (const variant of variantsA) {
+        if (!variantsB.has(variant)) {
+            differences.push({
+                type: "variant-missing",
+                field: variant,
+                variantA: { name: variantA, value: true },
+                variantB: { name: variantB, value: false },
+                severity: "info",
+            });
+        }
+    }
+    for (const variant of variantsB) {
+        if (!variantsA.has(variant)) {
+            differences.push({
+                type: "variant-missing",
+                field: variant,
+                variantA: { name: variantA, value: false },
+                variantB: { name: variantB, value: true },
+                severity: "info",
+            });
+        }
+    }
+    // Compare hardcoded values (style differences)
+    const hardcodedA = componentA.metadata.hardcodedValues || [];
+    const hardcodedB = componentB.metadata.hardcodedValues || [];
+    // Group by property for comparison
+    const styleMapA = new Map();
+    const styleMapB = new Map();
+    for (const h of hardcodedA) {
+        styleMapA.set(h.property, h.value);
+    }
+    for (const h of hardcodedB) {
+        styleMapB.set(h.property, h.value);
+    }
+    // Check for same property with different values
+    for (const [prop, valueA] of styleMapA) {
+        const valueB = styleMapB.get(prop);
+        if (valueB && valueA !== valueB) {
+            differences.push({
+                type: "style-value",
+                field: prop,
+                variantA: { name: variantA, value: valueA },
+                variantB: { name: variantB, value: valueB },
+                severity: "warning",
+            });
+        }
+    }
+    return differences;
+}
+/**
+ * Check all component variants for consistency and generate drift signals
+ */
+export function checkVariantConsistency(components) {
+    const drifts = [];
+    const groups = groupComponentsByVariant(components);
+    for (const group of groups) {
+        const variantNames = Array.from(group.variants.keys());
+        // Compare each pair of variants
+        for (let i = 0; i < variantNames.length; i++) {
+            for (let j = i + 1; j < variantNames.length; j++) {
+                const variantA = variantNames[i];
+                const variantB = variantNames[j];
+                const componentA = group.variants.get(variantA);
+                const componentB = group.variants.get(variantB);
+                const differences = compareVariants(componentA, variantA, componentB, variantB);
+                if (differences.length > 0) {
+                    // Group differences by severity
+                    const critical = differences.filter((d) => d.severity === "critical");
+                    const warnings = differences.filter((d) => d.severity === "warning");
+                    const severity = critical.length > 0 ? "critical" : warnings.length > 0 ? "warning" : "info";
+                    // Create a summary of differences
+                    const diffSummary = differences
+                        .slice(0, 5)
+                        .map((d) => {
+                        if (d.type === "prop-missing") {
+                            const hasIt = d.variantA.value ? d.variantA.name : d.variantB.name;
+                            return `${d.field} only in ${hasIt}`;
+                        }
+                        else if (d.type === "prop-type") {
+                            return `${d.field}: ${d.variantA.value} vs ${d.variantB.value}`;
+                        }
+                        else if (d.type === "style-value") {
+                            return `${d.field}: ${d.variantA.value} vs ${d.variantB.value}`;
+                        }
+                        return `${d.field} differs`;
+                    })
+                        .join(", ");
+                    const moreCount = differences.length - 5;
+                    const summary = moreCount > 0 ? `${diffSummary}, +${moreCount} more` : diffSummary;
+                    drifts.push({
+                        id: createStableDriftId("value-divergence", group.componentName, {
+                            property: `${variantA}-vs-${variantB}`,
+                        }),
+                        type: "value-divergence",
+                        severity,
+                        source: {
+                            entityType: "component",
+                            entityId: componentA.id,
+                            entityName: componentA.name,
+                            location: getSourcePath(componentA.source) || "",
+                        },
+                        target: {
+                            entityType: "component",
+                            entityId: componentB.id,
+                            entityName: componentB.name,
+                            location: getSourcePath(componentB.source) || "",
+                        },
+                        message: `Component "${group.componentName}" has ${differences.length} difference${differences.length > 1 ? "s" : ""} between ${variantA} and ${variantB} variants: ${summary}`,
+                        details: {
+                            expected: `Consistent implementation across variants`,
+                            actual: `${differences.length} differences found`,
+                            diff: JSON.stringify(differences.map((d) => ({
+                                type: d.type,
+                                field: d.field,
+                                [d.variantA.name]: d.variantA.value,
+                                [d.variantB.name]: d.variantB.value,
+                            })), null, 2),
+                            suggestions: [
+                                "Review variant differences for intentionality",
+                                "Document intentional differences in design system documentation",
+                                "Align implementations if differences are unintentional",
+                            ],
+                        },
+                        detectedAt: new Date(),
+                    });
+                }
+            }
+        }
+    }
+    return drifts;
+}
+//# sourceMappingURL=variant-analyzer.js.map

package/dist/analysis/analyzers/variant-analyzer.js.map

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

package/dist/analysis/index.d.ts

@@ -5,4 +5,7 @@ export { MATCHING_CONFIG, NAMING_CONFIG, TOKEN_SUGGESTION_CONFIG, SCANNER_CONFIG
 export { generateAuditReport, findCloseMatches, calculateHealthScore, type AuditValue, type AuditReport, type CategoryStats, type FileIssue, type CloseMatch, } from "./audit.js";
 export { DriftAggregator, createStrategy, builtInStrategies, type DriftGroup, type AggregationResult, type GroupingStrategy, type AggregatorOptions, type BuiltInStrategyType, } from "./drift-aggregator.js";
 export { detectRepeatedPatterns, normalizeClassPattern, groupPatterns, type ClassOccurrence, type PatternAnalyzerOptions, } from "./analyzers/pattern-analyzer.js";
+export { checkVariantConsistency, groupComponentsByVariant, compareVariants, extractVariantName, type VariantGroup, type VariantDifference, } from "./analyzers/variant-analyzer.js";
+export { detectTokenUtilities, checkTokenUtilityUsage, summarizeTokenUtilityUsage, TOKEN_UTILITY_PATTERNS, type DetectedUtility, type UtilityAnalysisResult, } from "./analyzers/token-utility-analyzer.js";
+export { checkExampleCompliance, analyzeExampleCoverage, annotateComponentContexts, classifyComponentContext, isExampleFile, isTestFile, type ComponentContext, type ComponentWithContext, } from "./analyzers/example-analyzer.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/analysis/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analysis/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,sBAAsB,EACtB,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,cAAc,EACd,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,aAAa,EACb,KAAK,eAAe,EACpB,KAAK,sBAAsB,GAC5B,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analysis/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,sBAAsB,EACtB,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,cAAc,EACd,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,aAAa,EACb,KAAK,eAAe,EACpB,KAAK,sBAAsB,GAC5B,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,eAAe,EACf,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,iBAAiB,GACvB,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,0BAA0B,EAC1B,sBAAsB,EACtB,KAAK,eAAe,EACpB,KAAK,qBAAqB,GAC3B,MAAM,uCAAuC,CAAC;AAG/C,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,EACzB,wBAAwB,EACxB,aAAa,EACb,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,GAC1B,MAAM,iCAAiC,CAAC"}

package/dist/analysis/index.js

@@ -11,4 +11,10 @@ export { generateAuditReport, findCloseMatches, calculateHealthScore, } from "./
 export { DriftAggregator, createStrategy, builtInStrategies, } from "./drift-aggregator.js";
 // Pattern analyzer (experimental)
 export { detectRepeatedPatterns, normalizeClassPattern, groupPatterns, } from "./analyzers/pattern-analyzer.js";
+// Variant analyzer (Phase 4.1)
+export { checkVariantConsistency, groupComponentsByVariant, compareVariants, extractVariantName, } from "./analyzers/variant-analyzer.js";
+// Token utility analyzer (Phase 4.2)
+export { detectTokenUtilities, checkTokenUtilityUsage, summarizeTokenUtilityUsage, TOKEN_UTILITY_PATTERNS, } from "./analyzers/token-utility-analyzer.js";
+// Example code analyzer (Phase 4.3)
+export { checkExampleCompliance, analyzeExampleCoverage, annotateComponentContexts, classifyComponentContext, isExampleFile, isTestFile, } from "./analyzers/example-analyzer.js";
 //# sourceMappingURL=index.js.map

package/dist/analysis/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analysis/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,GAOnB,MAAM,oBAAoB,CAAC;AAE5B,6BAA6B;AAC7B,OAAO,EACL,sBAAsB,GAEvB,MAAM,wBAAwB,CAAC;AAEhC,mBAAmB;AACnB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,yBAAyB;AACzB,OAAO,EACL,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,cAAc,EACd,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAErB,eAAe;AACf,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,GAMrB,MAAM,YAAY,CAAC;AAEpB,oBAAoB;AACpB,OAAO,EACL,eAAe,EACf,cAAc,EACd,iBAAiB,GAMlB,MAAM,uBAAuB,CAAC;AAE/B,kCAAkC;AAClC,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,aAAa,GAGd,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analysis/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,GAOnB,MAAM,oBAAoB,CAAC;AAE5B,6BAA6B;AAC7B,OAAO,EACL,sBAAsB,GAEvB,MAAM,wBAAwB,CAAC;AAEhC,mBAAmB;AACnB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,yBAAyB;AACzB,OAAO,EACL,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,cAAc,EACd,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAErB,eAAe;AACf,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,GAMrB,MAAM,YAAY,CAAC;AAEpB,oBAAoB;AACpB,OAAO,EACL,eAAe,EACf,cAAc,EACd,iBAAiB,GAMlB,MAAM,uBAAuB,CAAC;AAE/B,kCAAkC;AAClC,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,aAAa,GAGd,MAAM,iCAAiC,CAAC;AAEzC,+BAA+B;AAC/B,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,eAAe,EACf,kBAAkB,GAGnB,MAAM,iCAAiC,CAAC;AAEzC,qCAAqC;AACrC,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,0BAA0B,EAC1B,sBAAsB,GAGvB,MAAM,uCAAuC,CAAC;AAE/C,oCAAoC;AACpC,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,EACzB,wBAAwB,EACxB,aAAa,EACb,UAAU,GAGX,MAAM,iCAAiC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buoy-design/core",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Core domain models and analysis for Buoy design drift detection",
   "type": "module",
   "license": "MIT",
@@ -40,14 +40,6 @@
       "import": "./dist/analysis/index.js"
     }
   },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  },
   "dependencies": {
     "glob": "^11.0.0",
     "graphology": "^0.26.0",
@@ -57,5 +49,13 @@
   },
   "devDependencies": {
     "typescript": "^5.7.2"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
-}
+}