@brad-frost-web/eddie-brain 0.32.0

package/dist/types.d.ts

@@ -0,0 +1,351 @@
+/**
+ * Eddie's Brain — Core Type Definitions
+ *
+ * The type system for the agentic intelligence layer of the Eddie Design System.
+ */
+/** Atomic design classification */
+export type AtomicLevel = 'atom' | 'molecule' | 'organism' | 'recipe' | 'page';
+/** Which Eddie package a component belongs to */
+export type EddiePackage = 'eddie-web-components' | 'eddie-recipes' | 'eddie-icons' | 'eddie-pages' | 'eddie-charts';
+/** A component property definition */
+export interface PropertyEntry {
+    name: string;
+    type: string;
+    default?: string;
+    description: string;
+    /** Allowed values for enum-like props */
+    options?: string[];
+    required: boolean;
+}
+/** A component slot definition */
+export interface SlotEntry {
+    name: string;
+    description: string;
+}
+/** A component event definition */
+export interface EventEntry {
+    name: string;
+    detail?: string;
+    description: string;
+}
+/** Full component registry entry */
+export interface ComponentEntry {
+    /** Tag name, e.g. "ed-button" */
+    tagName: string;
+    /** Human-readable name, e.g. "Button" */
+    displayName: string;
+    /** CSS class name, e.g. "ed-c-button" */
+    cssClassName: string;
+    /** Atomic design level */
+    atomicLevel: AtomicLevel;
+    /** Package it belongs to */
+    package: EddiePackage;
+    /** What this component is FOR (intent, not just what it looks like) */
+    intent: string;
+    /** Base class: EdElement or EdFormElement */
+    baseClass: 'EdElement' | 'EdFormElement';
+    /** All public properties */
+    properties: PropertyEntry[];
+    /** Named slots */
+    slots: SlotEntry[];
+    /** CSS custom properties it exposes */
+    cssCustomProperties: string[];
+    /** Events it dispatches */
+    events: EventEntry[];
+    /** Components it commonly composes with */
+    composesWith: string[];
+    /** Parent compound component (if child) */
+    parentComponent?: string;
+    /** Child compound components */
+    childComponents?: string[];
+    /** Usage guidelines */
+    guidelines: {
+        use: string[];
+        dontUse: string[];
+        accessibility: string[];
+    };
+    /**
+     * Override points intended for consumer customization.
+     *
+     * Distinct from `properties` (which lists everything the class declares)
+     * and `slots` (which lists every slot that exists). This field is the
+     * structured answer to "how do I customize this component?" — populated
+     * from `@overridableSlot` and `@overridableProp` JSDoc tags on the
+     * component's class-level comment.
+     */
+    overridableSurface?: {
+        slots: Array<{
+            name: string;
+            purpose: string;
+            exampleMarkup?: string;
+        }>;
+        props: Array<{
+            name: string;
+            purpose: string;
+            values?: string[];
+        }>;
+    };
+    /**
+     * Canonical invocation shape. `default` is the minimal markup a consumer
+     * should paste to "get the default" — extracted from the component's
+     * `Default` Storybook story template. `note` is optional prose from a
+     * `@canonicalUsage` JSDoc tag on the class.
+     */
+    canonicalUsage?: {
+        default?: string;
+        note?: string;
+    };
+    /**
+     * Structural answer to "where does this component's content come from?".
+     * Surfaces the prop-vs-slot path so consumers (human or AI) don't reach for
+     * HTML muscle memory and silently drop content. Populated from a
+     * `@contentApi { ... }` JSDoc tag on the class. See #627.
+     *
+     *   contentVia       — how the user supplies the component's primary content
+     *   labelVia         — how the user supplies the field label (form components)
+     *   labelVisibility  — whether that label renders visibly or is a11y-only
+     */
+    contentApi?: {
+        contentVia?: string;
+        labelVia?: 'prop' | 'slot' | 'none';
+        labelVisibility?: 'visible' | 'hidden' | 'accessible-only';
+    };
+    /** File paths relative to package root */
+    paths: {
+        component: string;
+        styles?: string;
+        stories?: string;
+        test?: string;
+    };
+}
+/** Token tier in the 3-tier architecture */
+export type TokenTier = 'definition' | 'usage' | 'component';
+/** Token category */
+export type TokenCategory = 'color' | 'spacing' | 'typography' | 'border' | 'shadow' | 'motion' | 'breakpoint' | 'z-index' | 'opacity';
+/** A design token entry */
+export interface TokenEntry {
+    /** Full token name, e.g. "--ed-theme-color-background-default" */
+    name: string;
+    /** Tier */
+    tier: TokenTier;
+    /** Category */
+    category: TokenCategory;
+    /** Raw value */
+    value: string;
+    /** Token it references (for tier 2/3) */
+    references?: string;
+    /** What this token is for */
+    intent: string;
+    /** Which components use it */
+    usedBy: string[];
+    /** Theme this token belongs to */
+    theme: string;
+    /** Whether this token is deprecated */
+    deprecated: boolean;
+    /**
+     * For color tokens: the subcategory that determines which CSS properties
+     * the token may be applied to. One of "background", "content", "border",
+     * or undefined for non-color tokens. Derived from the token name segment
+     * immediately after `color-` (e.g., `--ed-theme-color-background-default`
+     * → "background"). See #631.
+     */
+    subcategory?: 'background' | 'content' | 'border';
+    /**
+     * CSS properties this token is valid to apply to, derived from
+     * category/subcategory. For color tokens only:
+     *   background → ["background", "background-color"]
+     *   content    → ["color", "fill"]
+     *   border     → ["border-color"] (matches the whole border-*-color family)
+     * Crossing the boundary (e.g., `background: var(--ed-theme-color-content-*)`)
+     * is a `token-category-mismatch` violation in eddie_validate_file. See #631.
+     */
+    validProperties?: string[];
+}
+/** A component's role in a composition recipe */
+export interface RecipeComponent {
+    tagName: string;
+    role: string;
+    variant?: string;
+    required: boolean;
+    slotTarget?: string;
+}
+/** A canonical composition recipe */
+export interface CompositionRecipe {
+    /** Recipe name, e.g. "destructive-confirmation" */
+    name: string;
+    /** What this recipe accomplishes */
+    intent: string;
+    /** Components involved */
+    components: RecipeComponent[];
+    /** Design token mappings */
+    tokens: Record<string, string>;
+    /** Rules that must hold */
+    rules: string[];
+    /** Match confidence when detected in the wild (0-1) */
+    confidence?: number;
+    /** Whether this recipe is approved as canonical */
+    status: 'candidate' | 'canonical' | 'deprecated';
+}
+/** Source of a signal */
+export type SignalSource = 'figma' | 'git' | 'storybook' | 'ci' | 'usage' | 'manual';
+/** Signal severity */
+export type SignalSeverity = 'info' | 'warning' | 'error' | 'critical';
+/** A signal from any monitored source */
+export interface Signal {
+    id: string;
+    timestamp: string;
+    source: SignalSource;
+    severity: SignalSeverity;
+    /** What kind of signal */
+    type: string;
+    /** Human-readable description */
+    message: string;
+    /** Affected component/token/file */
+    target?: string;
+    /** Raw data from the source */
+    payload?: Record<string, unknown>;
+}
+/** Health score category */
+export type HealthCategory = 'tokens' | 'naming' | 'coverage' | 'documentation' | 'accessibility' | 'consistency';
+/** A single health score */
+export interface HealthScore {
+    category: HealthCategory;
+    score: number;
+    issues: HealthIssue[];
+}
+/** A specific health issue found */
+export interface HealthIssue {
+    id: string;
+    category: HealthCategory;
+    severity: SignalSeverity;
+    message: string;
+    /** File path where the issue was found */
+    file: string;
+    /** Line number */
+    line?: number;
+    /** Column */
+    column?: number;
+    /** The problematic value */
+    actual?: string;
+    /** What it should be */
+    expected?: string;
+    /** Can this be auto-fixed? */
+    autoFixable: boolean;
+    /** Suggested fix */
+    suggestion?: string;
+}
+/** Full health report */
+export interface HealthReport {
+    timestamp: string;
+    /** Overall score (weighted average) */
+    overall: number;
+    /** Scores by category */
+    categories: HealthScore[];
+    /** Total issue count */
+    totalIssues: number;
+    /** Breakdown by severity */
+    issueCounts: Record<SignalSeverity, number>;
+}
+/** Trust level (L1 = lowest, L5 = highest) */
+export type TrustLevel = 'L1_INTERN' | 'L2_JUNIOR' | 'L3_MID' | 'L4_SENIOR' | 'L5_PRINCIPAL';
+/** What kind of action the agent can take */
+export type ActionType = 'suggest' | 'draft_pr' | 'create_pr' | 'auto_fix' | 'auto_merge' | 'update_docs' | 'notify' | 'escalate';
+/** Risk level of a proposed action */
+export type RiskLevel = 'low' | 'medium' | 'high' | 'critical';
+/** A planned action */
+export interface PlannedAction {
+    id: string;
+    timestamp: string;
+    /** What triggered this action */
+    signal: Signal;
+    /** What the agent wants to do */
+    actionType: ActionType;
+    /** Risk assessment */
+    risk: RiskLevel;
+    /** Confidence score (0-1) */
+    confidence: number;
+    /** Current trust level */
+    trustLevel: TrustLevel;
+    /** Whether this action is permitted at the current trust level */
+    permitted: boolean;
+    /** Human-readable description of the planned action */
+    description: string;
+    /** The actual changes to make */
+    changes: PlannedChange[];
+    /** Status */
+    status: 'pending' | 'approved' | 'rejected' | 'executed' | 'failed';
+}
+/** A specific file change */
+export interface PlannedChange {
+    file: string;
+    type: 'create' | 'modify' | 'delete';
+    description: string;
+    /** For modify: the diff */
+    diff?: string;
+}
+/** Audit log entry */
+export interface AuditEntry {
+    id: string;
+    timestamp: string;
+    action: PlannedAction;
+    /** Who approved (or 'auto' if within trust level) */
+    approvedBy: string;
+    /** Outcome */
+    outcome: 'success' | 'failure' | 'partial';
+    /** Any error messages */
+    errors?: string[];
+}
+/** A learning entry from human feedback */
+export interface LearningEntry {
+    id: string;
+    timestamp: string;
+    /** What the agent suggested */
+    suggestion: {
+        type: string;
+        target: string;
+        proposed: string;
+    };
+    /** What the human decided */
+    decision: 'accepted' | 'rejected' | 'modified';
+    /** If modified, what they changed it to */
+    modification?: string;
+    /** Why (if provided) */
+    reason?: string;
+    /** Tags for categorization */
+    tags: string[];
+}
+/** Trust promotion requirements */
+export interface TrustPromotion {
+    from: TrustLevel;
+    to: TrustLevel;
+    requirements: {
+        minCompletions: number;
+        maxRejectionRate: number;
+        minDaysAtLevel: number;
+    };
+}
+/** Eddie Brain configuration */
+export interface BrainConfig {
+    /** Path to the Eddie monorepo root */
+    rootDir: string;
+    /** Current trust level */
+    trustLevel: TrustLevel;
+    /** Which watchers to enable */
+    watchers: {
+        figma: boolean;
+        git: boolean;
+        storybook: boolean;
+        usage: boolean;
+    };
+    /** Health score weights (must sum to 1) */
+    healthWeights: Record<HealthCategory, number>;
+    /** Governance rules file path */
+    governanceRulesPath?: string;
+    /** MCP server port */
+    mcpPort?: number;
+    /** Whether to auto-fix within trust level */
+    autoFix: boolean;
+}
+/** Default configuration */
+export declare const DEFAULT_CONFIG: BrainConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,26 @@
+/**
+ * Eddie's Brain — Core Type Definitions
+ *
+ * The type system for the agentic intelligence layer of the Eddie Design System.
+ */
+/** Default configuration */
+export const DEFAULT_CONFIG = {
+    rootDir: '.',
+    trustLevel: 'L1_INTERN',
+    watchers: {
+        figma: false,
+        git: true,
+        storybook: false,
+        usage: false,
+    },
+    healthWeights: {
+        tokens: 0.25,
+        naming: 0.20,
+        coverage: 0.15,
+        documentation: 0.15,
+        accessibility: 0.15,
+        consistency: 0.10,
+    },
+    autoFix: false,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAwaH,4BAA4B;AAC5B,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,OAAO,EAAE,GAAG;IACZ,UAAU,EAAE,WAAW;IACvB,QAAQ,EAAE;QACR,KAAK,EAAE,KAAK;QACZ,GAAG,EAAE,IAAI;QACT,SAAS,EAAE,KAAK;QAChB,KAAK,EAAE,KAAK;KACb;IACD,aAAa,EAAE;QACb,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,IAAI;QACZ,QAAQ,EAAE,IAAI;QACd,aAAa,EAAE,IAAI;QACnB,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,IAAI;KAClB;IACD,OAAO,EAAE,KAAK;CACf,CAAC"}

package/dist/utils/anthropic.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Shared Anthropic API utilities — rate-limit retry, sleep, etc.
+ * Used by both the pipeline agent-runner and the loop fix-agent.
+ */
+import Anthropic from '@anthropic-ai/sdk';
+/**
+ * Sleep for a given number of milliseconds.
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Call the Anthropic API with retry/backoff for rate limit (429) errors.
+ * Retries up to MAX_RATE_LIMIT_RETRIES times with exponential backoff.
+ */
+export declare function createWithRetry(client: Anthropic, params: Anthropic.MessageCreateParamsNonStreaming, callerName: string): Promise<Anthropic.Message>;
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/utils/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/utils/anthropic.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAS1C;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,SAAS,CAAC,+BAA+B,EACjD,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAuB5B"}

package/dist/utils/anthropic.js

@@ -0,0 +1,40 @@
+/**
+ * Shared Anthropic API utilities — rate-limit retry, sleep, etc.
+ * Used by both the pipeline agent-runner and the loop fix-agent.
+ */
+import Anthropic from '@anthropic-ai/sdk';
+import chalk from 'chalk';
+/** Maximum retries for rate limit (429) errors */
+const MAX_RATE_LIMIT_RETRIES = 3;
+/** Base delay in ms for exponential backoff on rate limits */
+const RATE_LIMIT_BASE_DELAY_MS = 30_000;
+/**
+ * Sleep for a given number of milliseconds.
+ */
+export function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Call the Anthropic API with retry/backoff for rate limit (429) errors.
+ * Retries up to MAX_RATE_LIMIT_RETRIES times with exponential backoff.
+ */
+export async function createWithRetry(client, params, callerName) {
+    for (let attempt = 0; attempt <= MAX_RATE_LIMIT_RETRIES; attempt++) {
+        try {
+            return await client.messages.create(params);
+        }
+        catch (err) {
+            const isRateLimit = err instanceof Anthropic.RateLimitError ||
+                (err instanceof Error && err.message.includes('rate_limit'));
+            if (!isRateLimit || attempt === MAX_RATE_LIMIT_RETRIES) {
+                throw err;
+            }
+            const delayMs = RATE_LIMIT_BASE_DELAY_MS * Math.pow(2, attempt);
+            const delaySec = Math.round(delayMs / 1000);
+            console.log(chalk.yellow(`  [${callerName}] Rate limited (attempt ${attempt + 1}/${MAX_RATE_LIMIT_RETRIES}). Retrying in ${delaySec}s...`));
+            await sleep(delayMs);
+        }
+    }
+    throw new Error('Rate limit retries exhausted');
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/utils/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/utils/anthropic.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,kDAAkD;AAClD,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAEjC,8DAA8D;AAC9D,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAExC;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAiB,EACjB,MAAiD,EACjD,UAAkB;IAElB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,sBAAsB,EAAE,OAAO,EAAE,EAAE,CAAC;QACnE,IAAI,CAAC;YACH,OAAO,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,WAAW,GACf,GAAG,YAAY,SAAS,CAAC,cAAc;gBACvC,CAAC,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;YAE/D,IAAI,CAAC,WAAW,IAAI,OAAO,KAAK,sBAAsB,EAAE,CAAC;gBACvD,MAAM,GAAG,CAAC;YACZ,CAAC;YAED,MAAM,OAAO,GAAG,wBAAwB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;YAC5C,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,MAAM,CAAC,MAAM,UAAU,2BAA2B,OAAO,GAAG,CAAC,IAAI,sBAAsB,kBAAkB,QAAQ,MAAM,CAAC,CAC/H,CAAC;YACF,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;AAClD,CAAC"}

package/dist/utils/id.d.ts

@@ -0,0 +1,8 @@
+/**
+ * ID generation utilities
+ */
+/**
+ * Generate a unique ID (UUID v4 format)
+ */
+export declare function generateId(): string;
+//# sourceMappingURL=id.d.ts.map

package/dist/utils/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAMnC"}

package/dist/utils/id.js

@@ -0,0 +1,14 @@
+/**
+ * ID generation utilities
+ */
+/**
+ * Generate a unique ID (UUID v4 format)
+ */
+export function generateId() {
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
+        const r = (Math.random() * 16) | 0;
+        const v = c === 'x' ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+//# sourceMappingURL=id.js.map

package/dist/utils/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,sCAAsC,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC;QACxE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QAC1C,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@brad-frost-web/eddie-brain",
+  "version": "0.32.0",
+  "description": "The agentic intelligence layer for the Eddie Design System — monitors, validates, and evolves your design system with AI-powered automation and human oversight.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "eddie-brain": "dist/cli/brain.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./mcp": {
+      "import": "./dist/mcp/index.js",
+      "types": "./dist/mcp/index.d.ts"
+    },
+    "./cli": {
+      "import": "./dist/cli/index.js",
+      "types": "./dist/cli/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc && node scripts/copy-data.js",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "init": "node dist/cli/brain.js init",
+    "scan": "node dist/cli/brain.js scan",
+    "health": "node dist/cli/brain.js health",
+    "validate": "node dist/cli/brain.js validate",
+    "mcp": "node dist/mcp/server.js",
+    "pipeline": "node dist/cli/brain.js --root ../.. pipeline run"
+  },
+  "keywords": [
+    "design-system",
+    "agentic",
+    "mcp",
+    "design-tokens",
+    "lint",
+    "validation"
+  ],
+  "author": "Brad Frost and Ian Frost",
+  "license": "MIT",
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.80.0",
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "chalk": "^5.4.0",
+    "chokidar": "^4.0.0",
+    "commander": "^13.1.0",
+    "fast-glob": "^3.3.0",
+    "postcss": "^8.5.0",
+    "postcss-scss": "^4.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.0"
+  },
+  "peerDependencies": {
+    "@brad-frost-web/eddie-design-tokens": ">=0.19.0",
+    "@brad-frost-web/eddie-web-components": ">=0.19.0"
+  },
+  "peerDependenciesMeta": {
+    "@brad-frost-web/eddie-web-components": {
+      "optional": true
+    },
+    "@brad-frost-web/eddie-design-tokens": {
+      "optional": true
+    }
+  }
+}