@buoy-design/core 0.1.1 → 0.1.2

package/dist/graph/collectors/git.js

@@ -0,0 +1,253 @@
+/**
+ * Git History Collector
+ *
+ * Extracts commit history, authors, and file changes from git.
+ * Populates commits and developers tables.
+ */
+import { simpleGit } from 'simple-git';
+import { createHash } from 'crypto';
+// ============================================================================
+// Collector
+// ============================================================================
+/**
+ * Collect git history from a repository
+ */
+export async function collectGitHistory(projectRoot, options = {}) {
+    const git = simpleGit(projectRoot);
+    // Build log options
+    const logOptions = {
+        '--date': 'iso-strict',
+    };
+    if (options.since) {
+        logOptions['--since'] = options.since.toISOString();
+    }
+    if (options.until) {
+        logOptions['--until'] = options.until.toISOString();
+    }
+    if (options.maxCount) {
+        logOptions['--max-count'] = options.maxCount;
+    }
+    // Get commit log
+    let log;
+    if (options.paths && options.paths.length > 0) {
+        log = await git.log({ ...logOptions, file: options.paths.join(' ') });
+    }
+    else {
+        log = await git.log(logOptions);
+    }
+    const commits = [];
+    const developerMap = new Map();
+    for (const entry of log.all) {
+        // Parse commit
+        const commit = {
+            sha: entry.hash,
+            message: entry.message,
+            author: entry.author_name,
+            authorEmail: entry.author_email,
+            timestamp: new Date(entry.date),
+            parentSha: entry.refs ? null : null, // Will be populated if needed
+            filesChanged: [],
+        };
+        // Get file changes if requested
+        if (options.includeStats) {
+            try {
+                const diff = await git.diffSummary([`${entry.hash}^`, entry.hash]);
+                commit.filesChanged = diff.files.map((f) => {
+                    // Handle different file types
+                    const isBinary = 'binary' in f && f.binary;
+                    const insertions = 'insertions' in f ? f.insertions : 0;
+                    const deletions = 'deletions' in f ? f.deletions : 0;
+                    return {
+                        path: f.file,
+                        status: isBinary
+                            ? 'modified'
+                            : insertions > 0 && deletions === 0
+                                ? 'added'
+                                : deletions > 0 && insertions === 0
+                                    ? 'deleted'
+                                    : 'modified',
+                        additions: insertions,
+                        deletions: deletions,
+                    };
+                });
+            }
+            catch {
+                // First commit has no parent, skip diff
+            }
+        }
+        commits.push(commit);
+        // Track developer
+        const devKey = entry.author_email.toLowerCase();
+        const existing = developerMap.get(devKey);
+        if (existing) {
+            existing.commitCount++;
+            if (commit.timestamp < existing.firstSeenAt) {
+                existing.firstSeenAt = commit.timestamp;
+            }
+            if (commit.timestamp > existing.lastSeenAt) {
+                existing.lastSeenAt = commit.timestamp;
+            }
+        }
+        else {
+            developerMap.set(devKey, {
+                id: generateDeveloperId(entry.author_email),
+                name: entry.author_name,
+                email: entry.author_email,
+                commitCount: 1,
+                firstSeenAt: commit.timestamp,
+                lastSeenAt: commit.timestamp,
+            });
+        }
+    }
+    const developers = Array.from(developerMap.values());
+    // Calculate date range
+    let dateRange = null;
+    if (commits.length > 0) {
+        const timestamps = commits.map((c) => c.timestamp.getTime());
+        dateRange = {
+            start: new Date(Math.min(...timestamps)),
+            end: new Date(Math.max(...timestamps)),
+        };
+    }
+    return {
+        commits,
+        developers,
+        stats: {
+            totalCommits: commits.length,
+            totalDevelopers: developers.length,
+            dateRange,
+        },
+    };
+}
+/**
+ * Collect commits that touched design-related files
+ */
+export async function collectDesignSystemHistory(projectRoot, options = {}) {
+    // Patterns for design-system related files
+    const designPatterns = [
+        '*.tokens.json',
+        'tokens.json',
+        '**/tokens/**',
+        '**/theme/**',
+        '**/design-system/**',
+        '*.css',
+        '*.scss',
+        '*.sass',
+        '*.less',
+        'tailwind.config.*',
+        '**/components/**/*.tsx',
+        '**/components/**/*.vue',
+        '**/components/**/*.svelte',
+    ];
+    return collectGitHistory(projectRoot, {
+        ...options,
+        paths: designPatterns,
+        includeStats: true,
+    });
+}
+/**
+ * Get file history (who changed this file)
+ */
+export async function getFileHistory(projectRoot, filePath, options = {}) {
+    const result = await collectGitHistory(projectRoot, {
+        paths: [filePath],
+        maxCount: options.maxCount ?? 50,
+        includeStats: false,
+    });
+    return result.commits;
+}
+/**
+ * Get blame information for a file
+ */
+export async function getFileBlame(projectRoot, filePath) {
+    const git = simpleGit(projectRoot);
+    const blameMap = new Map();
+    try {
+        const blame = await git.raw(['blame', '--line-porcelain', filePath]);
+        const lines = blame.split('\n');
+        let currentSha = '';
+        let currentAuthor = '';
+        let currentEmail = '';
+        let currentDate = new Date();
+        let lineNumber = 0;
+        for (const line of lines) {
+            if (line.match(/^[0-9a-f]{40}/)) {
+                currentSha = line.slice(0, 40);
+                // Parse line number from "sha origLine finalLine numLines"
+                const parts = line.split(' ');
+                if (parts[2]) {
+                    lineNumber = parseInt(parts[2], 10);
+                }
+            }
+            else if (line.startsWith('author ')) {
+                currentAuthor = line.slice(7);
+            }
+            else if (line.startsWith('author-mail ')) {
+                currentEmail = line.slice(12).replace(/[<>]/g, '');
+            }
+            else if (line.startsWith('author-time ')) {
+                currentDate = new Date(parseInt(line.slice(12), 10) * 1000);
+            }
+            else if (line.startsWith('\t')) {
+                // This is the actual line content, save the blame info
+                blameMap.set(lineNumber, {
+                    author: currentAuthor,
+                    email: currentEmail,
+                    sha: currentSha,
+                    date: currentDate,
+                });
+            }
+        }
+    }
+    catch {
+        // File might not exist or not be tracked
+    }
+    return blameMap;
+}
+/**
+ * Check if a path is inside a git repository
+ */
+export async function isGitRepository(path) {
+    const git = simpleGit(path);
+    try {
+        await git.revparse(['--git-dir']);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get the current branch name
+ */
+export async function getCurrentBranch(projectRoot) {
+    const git = simpleGit(projectRoot);
+    try {
+        const branch = await git.revparse(['--abbrev-ref', 'HEAD']);
+        return branch.trim();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get the remote URL
+ */
+export async function getRemoteUrl(projectRoot) {
+    const git = simpleGit(projectRoot);
+    try {
+        const remotes = await git.getRemotes(true);
+        const origin = remotes.find((r) => r.name === 'origin');
+        return origin?.refs.fetch ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function generateDeveloperId(email) {
+    return createHash('sha256').update(email.toLowerCase()).digest('hex').slice(0, 16);
+}
+//# sourceMappingURL=git.js.map

package/dist/graph/collectors/git.js.map

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

package/dist/graph/collectors/imports.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Import Collector
+ *
+ * Extracts ES module import relationships between files.
+ * Creates a dependency graph for impact analysis.
+ */
+export type ImportType = 'default' | 'named' | 'namespace' | 'side-effect' | 'dynamic';
+export interface FileImport {
+    sourceFile: string;
+    targetFile: string;
+    importType: ImportType;
+    importedNames: string[];
+    rawSpecifier: string;
+    isExternal: boolean;
+    lineNumber: number;
+}
+export interface ImportCollectorOptions {
+    projectRoot: string;
+    include?: string[];
+    exclude?: string[];
+    /** Resolve paths to actual files (slower but more accurate) */
+    resolvePaths?: boolean;
+    /** Include node_modules imports */
+    includeExternal?: boolean;
+}
+export interface ImportCollectorResult {
+    imports: FileImport[];
+    externalDependencies: Set<string>;
+    stats: {
+        filesScanned: number;
+        importsFound: number;
+        externalPackages: number;
+    };
+}
+/**
+ * Collect import relationships from the codebase
+ */
+export declare function collectImports(options: ImportCollectorOptions): Promise<ImportCollectorResult>;
+/**
+ * Get all files that import a specific file
+ */
+export declare function findImportersOf(projectRoot: string, targetFile: string): Promise<FileImport[]>;
+/**
+ * Get all files imported by a specific file
+ */
+export declare function findImportsOf(projectRoot: string, sourceFile: string): Promise<FileImport[]>;
+/**
+ * Build a dependency graph from imports
+ */
+export declare function buildDependencyGraph(projectRoot: string): Promise<Map<string, Set<string>>>;
+/**
+ * Find circular dependencies
+ */
+export declare function findCircularDependencies(projectRoot: string): Promise<string[][]>;
+//# sourceMappingURL=imports.d.ts.map

package/dist/graph/collectors/imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.d.ts","sourceRoot":"","sources":["../../../src/graph/collectors/imports.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,CAAC;AAEvF,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mCAAmC;IACnC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,oBAAoB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AA8CD;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CA2KhC;AAiHD;;GAEG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,EAAE,CAAC,CAWvB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,EAAE,CAAC,CAGvB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAcnC;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAgCrB"}

package/dist/graph/collectors/imports.js

@@ -0,0 +1,230 @@
+/**
+ * Import Collector
+ *
+ * Extracts ES module import relationships between files.
+ * Creates a dependency graph for impact analysis.
+ */
+import { readFile } from 'fs/promises';
+import { glob } from 'glob';
+import { join, dirname, resolve, relative } from 'path';
+import { existsSync } from 'fs';
+// ============================================================================
+// Patterns
+// ============================================================================
+// ES import patterns
+const IMPORT_PATTERNS = {
+    // import defaultExport from 'module'
+    default: /import\s+([a-zA-Z_$][a-zA-Z0-9_$]*)\s+from\s+['"]([^'"]+)['"]/g,
+    // import { named1, named2 } from 'module'
+    named: /import\s*\{([^}]+)\}\s*from\s*['"]([^'"]+)['"]/g,
+    // import * as namespace from 'module'
+    namespace: /import\s*\*\s*as\s+([a-zA-Z_$][a-zA-Z0-9_$]*)\s+from\s+['"]([^'"]+)['"]/g,
+    // import 'module' (side effect)
+    sideEffect: /import\s+['"]([^'"]+)['"]/g,
+    // import defaultExport, { named } from 'module'
+    mixed: /import\s+([a-zA-Z_$][a-zA-Z0-9_$]*)\s*,\s*\{([^}]+)\}\s*from\s*['"]([^'"]+)['"]/g,
+    // const x = await import('module') or import('module')
+    dynamic: /import\s*\(\s*['"]([^'"]+)['"]\s*\)/g,
+    // require('module') - CommonJS
+    require: /require\s*\(\s*['"]([^'"]+)['"]\s*\)/g,
+};
+// Re-export patterns
+const REEXPORT_PATTERNS = {
+    // export { named } from 'module'
+    named: /export\s*\{([^}]+)\}\s*from\s*['"]([^'"]+)['"]/g,
+    // export * from 'module'
+    all: /export\s*\*\s*from\s*['"]([^'"]+)['"]/g,
+    // export { default } from 'module'
+    default: /export\s*\{\s*default\s*(?:as\s+[a-zA-Z_$][a-zA-Z0-9_$]*)?\s*\}\s*from\s*['"]([^'"]+)['"]/g,
+};
+// ============================================================================
+// Collector
+// ============================================================================
+/**
+ * Collect import relationships from the codebase
+ */
+export async function collectImports(options) {
+    const { projectRoot, include = ['**/*.{ts,tsx,js,jsx,mjs,cjs}'], exclude = ['**/node_modules/**', '**/dist/**', '**/build/**'], resolvePaths = true, includeExternal = false, } = options;
+    const files = await glob(include, {
+        cwd: projectRoot,
+        ignore: exclude,
+        absolute: false,
+    });
+    const imports = [];
+    const externalDependencies = new Set();
+    for (const file of files) {
+        const fullPath = join(projectRoot, file);
+        let content;
+        try {
+            content = await readFile(fullPath, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        const lines = content.split('\n');
+        const fileDir = dirname(fullPath);
+        // Collect all import types
+        collectImportPattern(content, lines, file, fileDir, projectRoot, IMPORT_PATTERNS.default, 'default', imports, externalDependencies, resolvePaths, includeExternal, (match) => [match[1] ?? 'default'], (match) => match[2] ?? '');
+        collectImportPattern(content, lines, file, fileDir, projectRoot, IMPORT_PATTERNS.named, 'named', imports, externalDependencies, resolvePaths, includeExternal, (match) => parseNamedImports(match[1] ?? ''), (match) => match[2] ?? '');
+        collectImportPattern(content, lines, file, fileDir, projectRoot, IMPORT_PATTERNS.namespace, 'namespace', imports, externalDependencies, resolvePaths, includeExternal, (match) => [match[1] ?? '*'], (match) => match[2] ?? '');
+        collectImportPattern(content, lines, file, fileDir, projectRoot, IMPORT_PATTERNS.sideEffect, 'side-effect', imports, externalDependencies, resolvePaths, includeExternal, () => [], (match) => match[1] ?? '');
+        collectImportPattern(content, lines, file, fileDir, projectRoot, IMPORT_PATTERNS.mixed, 'named', imports, externalDependencies, resolvePaths, includeExternal, (match) => [match[1] ?? 'default', ...parseNamedImports(match[2] ?? '')], (match) => match[3] ?? '');
+        collectImportPattern(content, lines, file, fileDir, projectRoot, IMPORT_PATTERNS.dynamic, 'dynamic', imports, externalDependencies, resolvePaths, includeExternal, () => ['*'], (match) => match[1] ?? '');
+        // Collect re-exports
+        collectImportPattern(content, lines, file, fileDir, projectRoot, REEXPORT_PATTERNS.named, 'named', imports, externalDependencies, resolvePaths, includeExternal, (match) => parseNamedImports(match[1] ?? ''), (match) => match[2] ?? '');
+        collectImportPattern(content, lines, file, fileDir, projectRoot, REEXPORT_PATTERNS.all, 'namespace', imports, externalDependencies, resolvePaths, includeExternal, () => ['*'], (match) => match[1] ?? '');
+    }
+    return {
+        imports,
+        externalDependencies,
+        stats: {
+            filesScanned: files.length,
+            importsFound: imports.length,
+            externalPackages: externalDependencies.size,
+        },
+    };
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function collectImportPattern(content, _lines, sourceFile, fileDir, projectRoot, pattern, importType, imports, externalDependencies, resolvePaths, includeExternal, getNames, getSpecifier) {
+    // Reset pattern
+    pattern.lastIndex = 0;
+    let match;
+    while ((match = pattern.exec(content)) !== null) {
+        const rawSpecifier = getSpecifier(match);
+        if (!rawSpecifier)
+            continue;
+        const isExternal = !rawSpecifier.startsWith('.') && !rawSpecifier.startsWith('/');
+        // Track external dependencies
+        if (isExternal) {
+            const packageName = getPackageName(rawSpecifier);
+            externalDependencies.add(packageName);
+            if (!includeExternal)
+                continue;
+        }
+        // Resolve target file
+        let targetFile = rawSpecifier;
+        if (!isExternal && resolvePaths) {
+            targetFile = resolveImportPath(rawSpecifier, fileDir, projectRoot);
+        }
+        // Get line number
+        const lineNumber = getLineNumber(content, match.index);
+        imports.push({
+            sourceFile,
+            targetFile,
+            importType,
+            importedNames: getNames(match),
+            rawSpecifier,
+            isExternal,
+            lineNumber,
+        });
+    }
+}
+function parseNamedImports(namedString) {
+    return namedString
+        .split(',')
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0)
+        .map((s) => {
+        // Handle "original as alias"
+        const parts = s.split(/\s+as\s+/);
+        return parts[0]?.trim() ?? s;
+    });
+}
+function getPackageName(specifier) {
+    // Handle scoped packages: @scope/package/path -> @scope/package
+    if (specifier.startsWith('@')) {
+        const parts = specifier.split('/');
+        return parts.slice(0, 2).join('/');
+    }
+    // Regular packages: package/path -> package
+    return specifier.split('/')[0] ?? specifier;
+}
+function resolveImportPath(specifier, fromDir, projectRoot) {
+    // Resolve the path
+    const absolutePath = resolve(fromDir, specifier);
+    // Try common extensions
+    const extensions = ['', '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '/index.ts', '/index.tsx', '/index.js'];
+    for (const ext of extensions) {
+        const tryPath = absolutePath + ext;
+        if (existsSync(tryPath)) {
+            return relative(projectRoot, tryPath);
+        }
+    }
+    // Return as-is if not found
+    return relative(projectRoot, absolutePath);
+}
+function getLineNumber(content, index) {
+    const before = content.slice(0, index);
+    return (before.match(/\n/g) ?? []).length + 1;
+}
+// ============================================================================
+// Specialized Functions
+// ============================================================================
+/**
+ * Get all files that import a specific file
+ */
+export async function findImportersOf(projectRoot, targetFile) {
+    const result = await collectImports({ projectRoot });
+    const normalizedTarget = targetFile.replace(/\.(ts|tsx|js|jsx)$/, '');
+    return result.imports.filter((imp) => {
+        const normalizedImport = imp.targetFile.replace(/\.(ts|tsx|js|jsx)$/, '');
+        return (normalizedImport === normalizedTarget ||
+            normalizedImport.endsWith('/' + normalizedTarget));
+    });
+}
+/**
+ * Get all files imported by a specific file
+ */
+export async function findImportsOf(projectRoot, sourceFile) {
+    const result = await collectImports({ projectRoot });
+    return result.imports.filter((imp) => imp.sourceFile === sourceFile);
+}
+/**
+ * Build a dependency graph from imports
+ */
+export async function buildDependencyGraph(projectRoot) {
+    const result = await collectImports({ projectRoot });
+    const graph = new Map();
+    for (const imp of result.imports) {
+        if (imp.isExternal)
+            continue;
+        if (!graph.has(imp.sourceFile)) {
+            graph.set(imp.sourceFile, new Set());
+        }
+        graph.get(imp.sourceFile)?.add(imp.targetFile);
+    }
+    return graph;
+}
+/**
+ * Find circular dependencies
+ */
+export async function findCircularDependencies(projectRoot) {
+    const graph = await buildDependencyGraph(projectRoot);
+    const cycles = [];
+    const visited = new Set();
+    const stack = new Set();
+    function dfs(node, path) {
+        if (stack.has(node)) {
+            // Found a cycle
+            const cycleStart = path.indexOf(node);
+            cycles.push(path.slice(cycleStart));
+            return;
+        }
+        if (visited.has(node))
+            return;
+        visited.add(node);
+        stack.add(node);
+        const deps = graph.get(node) ?? new Set();
+        for (const dep of deps) {
+            dfs(dep, [...path, node]);
+        }
+        stack.delete(node);
+    }
+    for (const node of graph.keys()) {
+        dfs(node, []);
+    }
+    return cycles;
+}
+//# sourceMappingURL=imports.js.map

package/dist/graph/collectors/imports.js.map

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

package/dist/graph/collectors/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Graph Collectors
+ *
+ * Extract data from various sources to populate the knowledge graph.
+ */
+export { collectGitHistory, collectDesignSystemHistory, getFileHistory, getFileBlame, isGitRepository, getCurrentBranch, getRemoteUrl, type CollectedCommit, type CollectedDeveloper, type FileChange, type GitCollectorOptions, type GitCollectorResult, } from './git.js';
+export { collectUsages, findHardcodedColors, findCSSVariableUsages, findTokenUsagesInFiles, findComponentUsagesInFiles, type TokenUsage, type ComponentUsage, type UsageType, type UsageCollectorOptions, type UsageCollectorResult, } from './usages.js';
+export { collectImports, findImportersOf, findImportsOf, buildDependencyGraph, findCircularDependencies, type FileImport, type ImportType, type ImportCollectorOptions, type ImportCollectorResult, } from './imports.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/graph/collectors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/graph/collectors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,cAAc,EACd,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,cAAc,EACd,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,wBAAwB,EACxB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,GAC3B,MAAM,cAAc,CAAC"}

package/dist/graph/collectors/index.js

@@ -0,0 +1,12 @@
+/**
+ * Graph Collectors
+ *
+ * Extract data from various sources to populate the knowledge graph.
+ */
+// Git history
+export { collectGitHistory, collectDesignSystemHistory, getFileHistory, getFileBlame, isGitRepository, getCurrentBranch, getRemoteUrl, } from './git.js';
+// Token and component usages
+export { collectUsages, findHardcodedColors, findCSSVariableUsages, findTokenUsagesInFiles, findComponentUsagesInFiles, } from './usages.js';
+// Import relationships
+export { collectImports, findImportersOf, findImportsOf, buildDependencyGraph, findCircularDependencies, } from './imports.js';
+//# sourceMappingURL=index.js.map

package/dist/graph/collectors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/graph/collectors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc;AACd,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,cAAc,EACd,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,YAAY,GAMb,MAAM,UAAU,CAAC;AAElB,6BAA6B;AAC7B,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,GAM3B,MAAM,aAAa,CAAC;AAErB,uBAAuB;AACvB,OAAO,EACL,cAAc,EACd,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,wBAAwB,GAKzB,MAAM,cAAc,CAAC"}