@omfalos/mokosh 0.1.7 → 0.1.9

package/dist/index.d.mts

@@ -143,6 +143,14 @@ interface MokoshConfig {
     testPatterns?: string[];
     /** Additional import specifiers that indicate a test file (e.g. `"@my-org/test-utils"`). */
     testLibraries?: string[];
+    /**
+     * Explicit path-alias map for import resolution, same shape as tsconfig's
+     * `compilerOptions.paths` (e.g. `{ "@app/*": ["src/app/*"] }`). Takes precedence over
+     * any aliases declared in `tsconfig.json`. Useful for JS-only projects without a
+     * tsconfig, or to mirror Vite/webpack alias configs. Substitution paths are resolved
+     * relative to the project root.
+     */
+    pathAliases?: Record<string, string[]>;
     /** Ratio of export-statements to total statements required for `"barrel"` classification. Default: `0.8`. */
     barrelThreshold?: number;
     /** When true, enriches each node with `commitCount90d` and `lastAuthor` via git log. Only fetched for new/modified files. */
@@ -204,6 +212,20 @@ declare function loadMokoshConfig(rootDirOrPath: string, { allowJs, isExplicitPa
  * @param {MokoshConfig} config - The loaded config whose matchers, patterns, libraries, and thresholds are registered.
  */
 declare function applyConfig(config: MokoshConfig): void;
+/**
+ * @description Extracts the subset of `MokoshConfig` fields that affect graph
+ *   construction (`gitStats`, `parallelParsing`, `pathAliases`) into a plain options
+ *   object, ready to spread into `createImportMap`/`createWorkspaceGraph` calls. Single
+ *   source of truth for this mapping so every graph-building call site — CLI, MCP,
+ *   and secondary command-level rebuilds — stays in sync as new config fields are added.
+ * @param config - The loaded config, or `undefined` when none has been loaded yet.
+ * @returns Graph-build options with defaults applied (`gitStats` defaults to `false`).
+ */
+declare function configToGraphOptions(config: MokoshConfig | undefined): {
+    gitStats: boolean;
+    parallelParsing: ParallelParsingOption | undefined;
+    pathAliases: Record<string, string[]> | undefined;
+};
 
 declare const DEFAULT_IGNORE_DIRS: readonly string[];
 declare const DEFAULT_EXTENSIONS: readonly string[];
@@ -1174,7 +1196,7 @@ declare function proposeAffectedTests(graph: Graph, changedFiles: string[], opti
  * @param rootDir - Absolute or relative path to the project root; resolved internally.
  * @param entryPoints - File paths (relative to `rootDir`) that seed the graph walk.
  * @param previousGraph - An earlier graph to diff against for incremental builds; pass `null` for a full build.
- * @param options - `silent` suppresses progress output; `gitStats` attaches git churn data; `coverageMap` maps file paths to line-coverage percentages; `parallelParsing` controls worker-pool offloading of file parsing (see {@link ParallelParsingOption}).
+ * @param options - `silent` suppresses progress output; `gitStats` attaches git churn data; `coverageMap` maps file paths to line-coverage percentages; `parallelParsing` controls worker-pool offloading of file parsing (see {@link ParallelParsingOption}); `pathAliases` overrides/extends tsconfig path-alias resolution (see `MokoshConfig.pathAliases`).
  * @returns The fully-built Graph with all reachable nodes and import edges populated.
  */
 declare function createImportMap(rootDir: string, entryPoints: string[], previousGraph?: Graph | null, options?: {
@@ -1182,12 +1204,13 @@ declare function createImportMap(rootDir: string, entryPoints: string[], previou
     gitStats?: boolean;
     coverageMap?: Map<string, number>;
     parallelParsing?: ParallelParsingOption | undefined;
+    pathAliases?: Record<string, string[]> | undefined;
 }): Promise<Graph>;
 /**
  * @description Auto-detects the monorepo layout under `rootDir` and builds a per-package
  *   dependency graph, stitching them together into a single WorkspaceGraph.
  * @param rootDir - Absolute path to the monorepo root.
- * @param options - `packages` filters to a named subset of packages; `silent` suppresses progress; `gitStats` attaches git churn data per file; `parallelParsing` controls worker-pool offloading of file parsing per package (see {@link ParallelParsingOption}).
+ * @param options - `packages` filters to a named subset of packages; `silent` suppresses progress; `gitStats` attaches git churn data per file; `parallelParsing` controls worker-pool offloading of file parsing per package (see {@link ParallelParsingOption}); `pathAliases` overrides/extends tsconfig path-alias resolution for every package (see `MokoshConfig.pathAliases`).
  * @returns A WorkspaceGraph where each package has its own Graph and cross-package edges are resolved.
  */
 declare function createWorkspaceGraph(rootDir: string, options?: {
@@ -1195,6 +1218,7 @@ declare function createWorkspaceGraph(rootDir: string, options?: {
     silent?: boolean;
     gitStats?: boolean;
     parallelParsing?: ParallelParsingOption | undefined;
+    pathAliases?: Record<string, string[]> | undefined;
 }): Promise<WorkspaceGraph>;
 /**
  * @description Recursively walks `rootDir` and returns paths of every file whose extension
@@ -1205,4 +1229,4 @@ declare function createWorkspaceGraph(rootDir: string, options?: {
  */
 declare function getAllProjectFiles(rootDir: string, options?: ScanOptions): string[];
 
-export { type ApiSurface, type ApplyTagsFileResult, type ApplyTagsResult, CallEdge, type CalleeEntry, type CallerEntry$1 as CallerEntry, type ChangeImpactCache, type ComplexFunctionEntry, DEFAULT_EXTENSIONS, DEFAULT_IGNORE_DIRS, type DependencyGraph, type ExportKind, type FeatureDetectionOptions, type FeatureDomain, type FeatureGraph, type FeatureGraphOptions, type FeatureInfo, FileNode, FileType, type FindComplexFunctionsOptions, type FunctionCallInfo, type GetAffectedOptions, type GetCallersOptions, Graph, type CallerEntry as GraphCallerEntry, type GraphExporter, ImportEdge, MermaidExporter, type ModuleResponsibility, type ModuleRole, type MokoshConfig, type MonorepoDetector, type MonorepoLayout, type NodeQuery, type ParallelParsingOption, type PathWithSymbols, type ProposeTagsOptions, type PublicExport, type ResponsibilityGraph, type ScanOptions, type SerializedGraph, type SerializedWorkspaceGraph, type SlimNode, type SlimSerializedGraph, StructuredTag, SymbolTraversalContext, type TestNodeIdentifier, type TraversalOptions, type TraversalVisitor, type TypeEdge, type TypeGraph, type TypeKind, type TypeNode, type TypeQueryResult, WorkspaceGraph, type WorkspacePackage, type WorkspacePackageSummary, type WorkspacePackagesSummary, applyConfig, applyTags, buildApiSurface, buildChangeImpactCache, buildFeatureGraph, buildResponsibilityGraph, buildTypeGraph, computeGraphHash, createImportMap, createWorkspaceGraph, detectAllEntryPoints, detectEntryPoint, detectFeatures, detectMonorepo, filterGraph, findComplexFunctions, getAffected, getAllProjectFiles, getCallers, getDependencies, getDependents, hasCoverageData, isChangeImpactCacheValid, loadChangeImpactCache, loadCoverageMap, loadMokoshConfig, parseQuery, proposeAffectedTests, proposeTags, queryCallGraph, queryChangeImpact, queryTypeGraph, registerConfigMatcher, registerMonorepoDetector, registerParser, registerTestLibrary, registerTestPattern, saveChangeImpactCache, slimSerialize, summarizeWorkspacePackages, toMermaid };
+export { type ApiSurface, type ApplyTagsFileResult, type ApplyTagsResult, CallEdge, type CalleeEntry, type CallerEntry$1 as CallerEntry, type ChangeImpactCache, type ComplexFunctionEntry, DEFAULT_EXTENSIONS, DEFAULT_IGNORE_DIRS, type DependencyGraph, type ExportKind, type FeatureDetectionOptions, type FeatureDomain, type FeatureGraph, type FeatureGraphOptions, type FeatureInfo, FileNode, FileType, type FindComplexFunctionsOptions, type FunctionCallInfo, type GetAffectedOptions, type GetCallersOptions, Graph, type CallerEntry as GraphCallerEntry, type GraphExporter, ImportEdge, MermaidExporter, type ModuleResponsibility, type ModuleRole, type MokoshConfig, type MonorepoDetector, type MonorepoLayout, type NodeQuery, type ParallelParsingOption, type PathWithSymbols, type ProposeTagsOptions, type PublicExport, type ResponsibilityGraph, type ScanOptions, type SerializedGraph, type SerializedWorkspaceGraph, type SlimNode, type SlimSerializedGraph, StructuredTag, SymbolTraversalContext, type TestNodeIdentifier, type TraversalOptions, type TraversalVisitor, type TypeEdge, type TypeGraph, type TypeKind, type TypeNode, type TypeQueryResult, WorkspaceGraph, type WorkspacePackage, type WorkspacePackageSummary, type WorkspacePackagesSummary, applyConfig, applyTags, buildApiSurface, buildChangeImpactCache, buildFeatureGraph, buildResponsibilityGraph, buildTypeGraph, computeGraphHash, configToGraphOptions, createImportMap, createWorkspaceGraph, detectAllEntryPoints, detectEntryPoint, detectFeatures, detectMonorepo, filterGraph, findComplexFunctions, getAffected, getAllProjectFiles, getCallers, getDependencies, getDependents, hasCoverageData, isChangeImpactCacheValid, loadChangeImpactCache, loadCoverageMap, loadMokoshConfig, parseQuery, proposeAffectedTests, proposeTags, queryCallGraph, queryChangeImpact, queryTypeGraph, registerConfigMatcher, registerMonorepoDetector, registerParser, registerTestLibrary, registerTestPattern, saveChangeImpactCache, slimSerialize, summarizeWorkspacePackages, toMermaid };

package/dist/index.d.ts

@@ -143,6 +143,14 @@ interface MokoshConfig {
     testPatterns?: string[];
     /** Additional import specifiers that indicate a test file (e.g. `"@my-org/test-utils"`). */
     testLibraries?: string[];
+    /**
+     * Explicit path-alias map for import resolution, same shape as tsconfig's
+     * `compilerOptions.paths` (e.g. `{ "@app/*": ["src/app/*"] }`). Takes precedence over
+     * any aliases declared in `tsconfig.json`. Useful for JS-only projects without a
+     * tsconfig, or to mirror Vite/webpack alias configs. Substitution paths are resolved
+     * relative to the project root.
+     */
+    pathAliases?: Record<string, string[]>;
     /** Ratio of export-statements to total statements required for `"barrel"` classification. Default: `0.8`. */
     barrelThreshold?: number;
     /** When true, enriches each node with `commitCount90d` and `lastAuthor` via git log. Only fetched for new/modified files. */
@@ -204,6 +212,20 @@ declare function loadMokoshConfig(rootDirOrPath: string, { allowJs, isExplicitPa
  * @param {MokoshConfig} config - The loaded config whose matchers, patterns, libraries, and thresholds are registered.
  */
 declare function applyConfig(config: MokoshConfig): void;
+/**
+ * @description Extracts the subset of `MokoshConfig` fields that affect graph
+ *   construction (`gitStats`, `parallelParsing`, `pathAliases`) into a plain options
+ *   object, ready to spread into `createImportMap`/`createWorkspaceGraph` calls. Single
+ *   source of truth for this mapping so every graph-building call site — CLI, MCP,
+ *   and secondary command-level rebuilds — stays in sync as new config fields are added.
+ * @param config - The loaded config, or `undefined` when none has been loaded yet.
+ * @returns Graph-build options with defaults applied (`gitStats` defaults to `false`).
+ */
+declare function configToGraphOptions(config: MokoshConfig | undefined): {
+    gitStats: boolean;
+    parallelParsing: ParallelParsingOption | undefined;
+    pathAliases: Record<string, string[]> | undefined;
+};
 
 declare const DEFAULT_IGNORE_DIRS: readonly string[];
 declare const DEFAULT_EXTENSIONS: readonly string[];
@@ -1174,7 +1196,7 @@ declare function proposeAffectedTests(graph: Graph, changedFiles: string[], opti
  * @param rootDir - Absolute or relative path to the project root; resolved internally.
  * @param entryPoints - File paths (relative to `rootDir`) that seed the graph walk.
  * @param previousGraph - An earlier graph to diff against for incremental builds; pass `null` for a full build.
- * @param options - `silent` suppresses progress output; `gitStats` attaches git churn data; `coverageMap` maps file paths to line-coverage percentages; `parallelParsing` controls worker-pool offloading of file parsing (see {@link ParallelParsingOption}).
+ * @param options - `silent` suppresses progress output; `gitStats` attaches git churn data; `coverageMap` maps file paths to line-coverage percentages; `parallelParsing` controls worker-pool offloading of file parsing (see {@link ParallelParsingOption}); `pathAliases` overrides/extends tsconfig path-alias resolution (see `MokoshConfig.pathAliases`).
  * @returns The fully-built Graph with all reachable nodes and import edges populated.
  */
 declare function createImportMap(rootDir: string, entryPoints: string[], previousGraph?: Graph | null, options?: {
@@ -1182,12 +1204,13 @@ declare function createImportMap(rootDir: string, entryPoints: string[], previou
     gitStats?: boolean;
     coverageMap?: Map<string, number>;
     parallelParsing?: ParallelParsingOption | undefined;
+    pathAliases?: Record<string, string[]> | undefined;
 }): Promise<Graph>;
 /**
  * @description Auto-detects the monorepo layout under `rootDir` and builds a per-package
  *   dependency graph, stitching them together into a single WorkspaceGraph.
  * @param rootDir - Absolute path to the monorepo root.
- * @param options - `packages` filters to a named subset of packages; `silent` suppresses progress; `gitStats` attaches git churn data per file; `parallelParsing` controls worker-pool offloading of file parsing per package (see {@link ParallelParsingOption}).
+ * @param options - `packages` filters to a named subset of packages; `silent` suppresses progress; `gitStats` attaches git churn data per file; `parallelParsing` controls worker-pool offloading of file parsing per package (see {@link ParallelParsingOption}); `pathAliases` overrides/extends tsconfig path-alias resolution for every package (see `MokoshConfig.pathAliases`).
  * @returns A WorkspaceGraph where each package has its own Graph and cross-package edges are resolved.
  */
 declare function createWorkspaceGraph(rootDir: string, options?: {
@@ -1195,6 +1218,7 @@ declare function createWorkspaceGraph(rootDir: string, options?: {
     silent?: boolean;
     gitStats?: boolean;
     parallelParsing?: ParallelParsingOption | undefined;
+    pathAliases?: Record<string, string[]> | undefined;
 }): Promise<WorkspaceGraph>;
 /**
  * @description Recursively walks `rootDir` and returns paths of every file whose extension
@@ -1205,4 +1229,4 @@ declare function createWorkspaceGraph(rootDir: string, options?: {
  */
 declare function getAllProjectFiles(rootDir: string, options?: ScanOptions): string[];
 
-export { type ApiSurface, type ApplyTagsFileResult, type ApplyTagsResult, CallEdge, type CalleeEntry, type CallerEntry$1 as CallerEntry, type ChangeImpactCache, type ComplexFunctionEntry, DEFAULT_EXTENSIONS, DEFAULT_IGNORE_DIRS, type DependencyGraph, type ExportKind, type FeatureDetectionOptions, type FeatureDomain, type FeatureGraph, type FeatureGraphOptions, type FeatureInfo, FileNode, FileType, type FindComplexFunctionsOptions, type FunctionCallInfo, type GetAffectedOptions, type GetCallersOptions, Graph, type CallerEntry as GraphCallerEntry, type GraphExporter, ImportEdge, MermaidExporter, type ModuleResponsibility, type ModuleRole, type MokoshConfig, type MonorepoDetector, type MonorepoLayout, type NodeQuery, type ParallelParsingOption, type PathWithSymbols, type ProposeTagsOptions, type PublicExport, type ResponsibilityGraph, type ScanOptions, type SerializedGraph, type SerializedWorkspaceGraph, type SlimNode, type SlimSerializedGraph, StructuredTag, SymbolTraversalContext, type TestNodeIdentifier, type TraversalOptions, type TraversalVisitor, type TypeEdge, type TypeGraph, type TypeKind, type TypeNode, type TypeQueryResult, WorkspaceGraph, type WorkspacePackage, type WorkspacePackageSummary, type WorkspacePackagesSummary, applyConfig, applyTags, buildApiSurface, buildChangeImpactCache, buildFeatureGraph, buildResponsibilityGraph, buildTypeGraph, computeGraphHash, createImportMap, createWorkspaceGraph, detectAllEntryPoints, detectEntryPoint, detectFeatures, detectMonorepo, filterGraph, findComplexFunctions, getAffected, getAllProjectFiles, getCallers, getDependencies, getDependents, hasCoverageData, isChangeImpactCacheValid, loadChangeImpactCache, loadCoverageMap, loadMokoshConfig, parseQuery, proposeAffectedTests, proposeTags, queryCallGraph, queryChangeImpact, queryTypeGraph, registerConfigMatcher, registerMonorepoDetector, registerParser, registerTestLibrary, registerTestPattern, saveChangeImpactCache, slimSerialize, summarizeWorkspacePackages, toMermaid };
+export { type ApiSurface, type ApplyTagsFileResult, type ApplyTagsResult, CallEdge, type CalleeEntry, type CallerEntry$1 as CallerEntry, type ChangeImpactCache, type ComplexFunctionEntry, DEFAULT_EXTENSIONS, DEFAULT_IGNORE_DIRS, type DependencyGraph, type ExportKind, type FeatureDetectionOptions, type FeatureDomain, type FeatureGraph, type FeatureGraphOptions, type FeatureInfo, FileNode, FileType, type FindComplexFunctionsOptions, type FunctionCallInfo, type GetAffectedOptions, type GetCallersOptions, Graph, type CallerEntry as GraphCallerEntry, type GraphExporter, ImportEdge, MermaidExporter, type ModuleResponsibility, type ModuleRole, type MokoshConfig, type MonorepoDetector, type MonorepoLayout, type NodeQuery, type ParallelParsingOption, type PathWithSymbols, type ProposeTagsOptions, type PublicExport, type ResponsibilityGraph, type ScanOptions, type SerializedGraph, type SerializedWorkspaceGraph, type SlimNode, type SlimSerializedGraph, StructuredTag, SymbolTraversalContext, type TestNodeIdentifier, type TraversalOptions, type TraversalVisitor, type TypeEdge, type TypeGraph, type TypeKind, type TypeNode, type TypeQueryResult, WorkspaceGraph, type WorkspacePackage, type WorkspacePackageSummary, type WorkspacePackagesSummary, applyConfig, applyTags, buildApiSurface, buildChangeImpactCache, buildFeatureGraph, buildResponsibilityGraph, buildTypeGraph, computeGraphHash, configToGraphOptions, createImportMap, createWorkspaceGraph, detectAllEntryPoints, detectEntryPoint, detectFeatures, detectMonorepo, filterGraph, findComplexFunctions, getAffected, getAllProjectFiles, getCallers, getDependencies, getDependents, hasCoverageData, isChangeImpactCacheValid, loadChangeImpactCache, loadCoverageMap, loadMokoshConfig, parseQuery, proposeAffectedTests, proposeTags, queryCallGraph, queryChangeImpact, queryTypeGraph, registerConfigMatcher, registerMonorepoDetector, registerParser, registerTestLibrary, registerTestPattern, saveChangeImpactCache, slimSerialize, summarizeWorkspacePackages, toMermaid };