Serialize

[blond]

The reverse process of normalization. The method serialize should process declaration specific to each format.

BEMDECL 1.0

var serialize = require('bem-decl').serialize,
    decl = [
        { name: 'block', elems: [{ name: 'elem-1' }] }],
        { name: 'block', elems: [{ name: 'elem-2' }] }]
    ];

serialize(decl, { version: '1.0' });
// [{ name: 'block', elems: [{ name: 'elem-1' }, { name: 'elem-2' }] }]

BEMDECL 2.0

var serialize = require('bem-decl').serialize,
    decl = [
        { block: 'block' }],
        { block: 'block', elem: 'elem-1' }],
        { block: 'block', elem: 'elem-2' }]
    ];

serialize(decl, { version: '2.0' });
// [{ block: 'block', elems: ['elem-1', 'elem-2'] }]

BEMDECL next

var serialize = require('bem-decl').serialize,
    decl = [
        { block: 'block' }],
        { scope: 'block', elem: 'elem-1' }],
        { scope: 'block', elem: 'elem-2' }]
    ];

serialize(decl, { version: 'next' });
// [{ block: 'block', elems: ['elem-1', 'elem-2'] }]

[qfox]

Can we rename this to stringify?

[blond]

No, serialize is method inverse normilize.

Input type for serialize is Array, and output is Array.

Input type for stringify is Array, but output is String.

[qfox]

Ah, true. So this issue blocking stringify method.

[blond]

So this issue blocking stringify method.

For v1 and next formats only.

[qfox]

If we decide to hide away normalize method, should we have serialize in public API?