@hyperfrontend/project-scope 0.2.1 → 0.2.2

package/heuristics/dependencies/index.d.ts

@@ -1,2 +1,99 @@
-export * from './analyze';
-//# sourceMappingURL=index.d.ts.map
+import { DependencyGraph } from '../../models';
+
+/**
+ * Circular dependency information.
+ */
+interface CircularDependency {
+    /** Ordered list of files in cycle */
+    cycle: string[];
+    /** Cycle length */
+    length: number;
+}
+/**
+ * Project dependencies categorized.
+ */
+interface ProjectDependencies {
+    /** Production dependencies */
+    runtime: string[];
+    /** Development dependencies */
+    development: string[];
+    /** Peer dependencies */
+    peer: string[];
+    /** Optional dependencies */
+    optional: string[];
+    /** Total count */
+    total: number;
+}
+/**
+ * Options for dependency graph building.
+ */
+interface BuildGraphOptions {
+    /** Maximum depth to traverse */
+    maxDepth?: number;
+    /** Include node_modules imports */
+    includeExternal?: boolean;
+    /** File extensions to analyze */
+    extensions?: string[];
+}
+/**
+ * Build dependency graph from source files.
+ *
+ * Analyzes imports/exports in source files to build a graph of
+ * internal dependencies.
+ *
+ * @param projectPath - Absolute path to project root
+ * @param options - Configuration for graph building
+ * @returns Dependency graph with nodes, roots, and leaves
+ *
+ * @example Building a dependency graph
+ * ```typescript
+ * import { buildDependencyGraph } from '@hyperfrontend/project-scope'
+ *
+ * const graph = buildDependencyGraph('./my-lib')
+ * console.log('Root files:', graph.roots)   // Files not imported by anything
+ * console.log('Leaf files:', graph.leaves)  // Files that don't import anything
+ * console.log('Total nodes:', graph.nodes.size)
+ *
+ * // Examine a specific node's dependencies
+ * const node = graph.nodes.get('src/utils/helper.ts')
+ * console.log('Depends on:', node?.dependencies)
+ * console.log('Used by:', node?.dependents)
+ * ```
+ */
+declare function buildDependencyGraph(projectPath: string, options?: BuildGraphOptions): DependencyGraph;
+/**
+ * Find circular dependencies in graph using DFS.
+ *
+ * @param graph - Dependency graph
+ * @returns Array of circular dependencies found
+ *
+ * @example Finding circular dependencies
+ * ```typescript
+ * import { buildDependencyGraph, findCircularDependencies } from '@hyperfrontend/project-scope'
+ *
+ * const graph = buildDependencyGraph('/workspace')
+ * const cycles = findCircularDependencies(graph)
+ * cycles.forEach(c => console.log(`Cycle: ${c.cycle.join(' -> ')}`))
+ * ```
+ */
+declare function findCircularDependencies(graph: DependencyGraph): CircularDependency[];
+/**
+ * Collect all dependencies from package.json grouped by category.
+ *
+ * @param projectPath - Project directory
+ * @returns Dependencies grouped by runtime, dev, peer, and optional
+ *
+ * @example Getting project dependencies
+ * ```typescript
+ * import { getProjectDependencies } from '@hyperfrontend/project-scope'
+ *
+ * const deps = getProjectDependencies('/path/to/project')
+ * console.log('Runtime:', deps.runtime)     // ['express', 'lodash']
+ * console.log('Dev:', deps.development)     // ['jest', 'typescript']
+ * console.log('Total:', deps.total)         // 15
+ * ```
+ */
+declare function getProjectDependencies(projectPath: string): ProjectDependencies;
+
+export { buildDependencyGraph, findCircularDependencies, getProjectDependencies };
+export type { BuildGraphOptions, CircularDependency, ProjectDependencies };

package/heuristics/dependencies/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/project-scope/src/heuristics/dependencies/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/project-scope/src/heuristics/dependencies/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAC3F,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA"}