Files Mode

[blond]

Now we can get info about files that relate to entity parts. But we don't know anything about other files.

Example:

blocks/
  button/
    button.css # file relate to button with css tech
    icon.png   # unknown file

We could emit about icon.png file with

{
    entity: undefined,
    tech: undefined,
    level: 'blocks',
    path: 'blocks/button/icon.png'
}

For example such information may be useful for bemhint-fs-naming plugin to warn about such files.

API

We can split walk method to walk.files() and walk.bemFiles().

const walk = require('bem-walk');
const stringify = require('JSONStream').stringify;

walk.files(['path/to/level'], config)
    .pipe(stringify())
    .pipe(process.stdout);

// [{
//     entity: { block: 'button' },
//     tech: 'css',
//     level: 'blocks',
//     path: 'blocks/button/button.css'
// },
// {
//     entity: undefined,
//     tech: undefined,
//     level: 'blocks',
//     path: 'blocks/button/icon.png'
// }]

walk.bemFiles(['path/to/level'], config);

// [{
//     entity: { block: 'button' },
//     tech: 'css',
//     level: 'blocks',
//     path: 'blocks/button/button.css'
// }]

Implementation

I think no need add this logic to schemes.

If release #37 we can run scheme on each file:

const nested = require('...');

const files = getAllFilesList();

files.forEach(file => {
    let isAdded = false;

    nested(file, () =>  isAdded = true, (err, res) => {
        if (isAdded) {
            /* provide res */ 
        } else {
            /* provide object with only `path` and `level` fields */ 
        }
    });
});

[tadatuta]

I'd prefer an option instead of different method.
E.g. { emitUnknown: true } for walk.files().