feat(view sub-generator): add inserting a new view's sass file `@impo…

…rt` to at an ordered position in '_views.sass'

Add documentation to '_views.sass'

generators/app/templates/src/sass/_views.sass

@@ -1 +1,10 @@
+//
+//  Please note that this file is likely to be modified by bat:view sub-generator runs .
+//
+//  You are, however, welcome to edit this file.
+//
+//  When doing so, it will probably be best to stick to a one-`@import`-statement-per-line discipline and not much else.
+//  Even though the sub-generator will take care not to break things, it likely isn't /f(?:ul|oo)l-proof/.
+//
+
 @import "views/_index"

generators/view/index.js

@@ -130,9 +130,25 @@ var ViewGenerator = generators.Base.extend(
                 //
                 this.conflicter.force = true;
 
-                var pad = (( views.length && views.slice( -1 ) !== '\n' ) ? '\n' : '' );
+                //  Look for a place to insert, preferably at an alfanumerically ordered position.
+                //
+                var insertAt, match, matcher = /^@import.*/mg;
 
-                this.write( viewsPath, views + pad + statement + '\n' );
+                while ( (( match = matcher.exec( views ) )) )
+                {
+                    if ( statement < match[ 0 ] ) { insertAt = match.index; }
+                }
+
+                if ( insertAt == null )
+                {
+                    var pad = (( views.length && views.slice( -1 ) !== '\n' ) ? '\n' : '' );
+
+                    this.write( viewsPath, views + pad + statement + '\n' );
+                }
+                else
+                {
+                    this.write( viewsPath, views.slice( 0, insertAt ) + statement + '\n' + views.slice( insertAt ) );
+                }
             }
         }
     }