docs: update readme

Author: fengzilong

README.md

@@ -9,6 +9,8 @@ Answer to "Why that package is in the bundle"
 
 <img src="media/screenshot.jpg" alt="screenshot" width="450" />
 
+Show the whole `issuer chain` and tell you why that package is in your bundle
+
 ## Installation
 
 ```bash

lib/analyze.js

@@ -77,6 +77,17 @@ module.exports = function analyze( stats = {} ) {
         const packageName = getPkgName( mod.name )
         const relativePathInPackage = getRelativePathInPackage( mod.name )
         const issuerPackageName = getPkgName( mod.issuerName )
+        const issuerPath = ( mod.issuerPath || [] )
+          .map( path => normalizePath( path.name ) )
+          .filter( ( name, i, issuers ) => {
+            const nextName = issuers[ i + 1 ]
+            if ( name === nextName ) {
+              return false
+            }
+
+            return true
+          } )
+        issuerPath.reverse()
 
         return {
           name: mod.name,
@@ -89,7 +100,7 @@ module.exports = function analyze( stats = {} ) {
           isSelfIssued: packageName && ( packageName === issuerPackageName ),
           issuer: mod.issuer,
           issuerName: normalizePath( mod.issuerName ),
-          issuerPath: mod.issuerPath,
+          issuerPath,
         }
       } )
     }

lib/format.js

@@ -25,28 +25,13 @@ module.exports = function format( assets ) {
             out = out + `  ${ chalk.blue( pkg.name ) } ${ chalk.dim( 'is issued by' ) }\n`
 
             if ( pkg.externalIssuers.length > 0 ) {
-              pkg.externalIssuers.sort( ( a, b ) => {
-                if ( containsNodeModules( a.name ) && !containsNodeModules( b.name ) ) {
-                  return 1
-                }
-
-                if ( !containsNodeModules( a.name ) && containsNodeModules( b.name ) ) {
-                  return -1
-                }
-
-                if ( containsAt( a.name ) && !containsAt( b.name ) ) {
-                  return -1
-                }
-
-                if ( !containsAt( a.name ) && containsAt( b.name ) ) {
-                  return 1
-                }
-
-                return a.name.replace( atReg, '' ).localeCompare( b.name.replace( atReg, '' ) )
-              } )
+              pkg.externalIssuers.sort( ( a, b ) => sortIssuer( a.name, b.name ) )
 
               out = out + pkg.externalIssuers.map( issuer => {
-                return `\n    → ${ prettyPath( issuer.name ) }`
+                return `\n    → ` + prettyPath( issuer.trace[ 0 ] ) +
+                  issuer.trace.slice( 1 ).map( ( parentIssuer, i ) => {
+                    return '\n\n' + ' '.repeat( i * 2 + 5 ) + chalk.dim( ' ↳ ' ) + prettyPath( parentIssuer )
+                  } ).join( '' )
               } ).join( '\n' )
             } else {
               out = out + `\n    → ${ chalk.bold( 'Self' ) } ${ chalk.dim( '( As Entrypoint )' ) }`
@@ -74,3 +59,23 @@ function containsNodeModules( path ) {
 function containsAt( path ) {
   return path.includes( '@' )
 }
+
+function sortIssuer( aName, bName ) {
+  if ( containsNodeModules( aName ) && !containsNodeModules( bName ) ) {
+    return 1
+  }
+
+  if ( !containsNodeModules( aName ) && containsNodeModules( bName ) ) {
+    return -1
+  }
+
+  if ( containsAt( aName ) && !containsAt( bName ) ) {
+    return -1
+  }
+
+  if ( !containsAt( aName ) && containsAt( bName ) ) {
+    return 1
+  }
+
+  return aName.replace( atReg, '' ).localeCompare( bName.replace( atReg, '' ) )
+}

lib/shared.js

@@ -31,7 +31,7 @@ function prettyPath( path ) {
   if ( nodeModulesReg.test( path ) ) {
     const packageName = getPackageName( path )
     path = path.replace( nodeModulesReg, '' )
-    path = chalk.bold( `${ packageName }` ) + path.slice( packageName.length )
+    path = chalk.bold( `${ packageName }` ) + chalk.dim( path.slice( packageName.length ) )
   }
 
   return path