@buoy-design/core
Core domain models and drift detection engine for Buoy.
Installation
npm install @buoy-design/core
Usage
import { SemanticDiffEngine } from '@buoy-design/core/analysis';
import { generateFixes } from '@buoy-design/core';
import type { Component, DriftSignal, Fix } from '@buoy-design/core';
const engine = new SemanticDiffEngine();
const result = engine.analyzeComponents(components, {
checkDeprecated: true,
checkNaming: true,
});
console.log(result.drifts);
const fixes = generateFixes(drifts, tokens);
console.log(fixes);
Models
- Component - UI components from any framework
- DesignToken - Color, spacing, typography values
- DriftSignal - Detected inconsistencies
- Fix - Proposed fix with confidence score
Confidence Levels
Fix suggestions include a confidence level:
exact | 100% | Value exactly matches a design token |
high | 95-99% | Very close match, safe to auto-apply |
medium | 70-94% | Close match, review recommended |
low | <70% | Ambiguous, manual review required |
Links