@toon/converter

Multi-format converter (JSON/TOON/CSV/YAML) with smart format selection and auto-detection.

Installation

``bash
npm install @toon/converter


or

pnpm add @toon/converter

or

yarn add @toon/converter
`

Usage

$3

`typescript
import { convert } from '@toon/converter';

const json = JSON.stringify({ user: { id: 123, name: 'Ada' } });

const result = convert(json, {
from: 'json',
to: 'toon',
});

console.log(result.content);
console.log(result.metadata.tokenSavings); // Token savings percentage
`

$3

`typescript
import { convertFile } from '@toon/converter';

const result = convertFile(content, 'data.json', {
to: 'toon',
// from is auto-detected from filename and content
});
`

$3

`typescript
import { selectOptimalFormat } from '@toon/converter';

const data = [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }];
const selection = selectOptimalFormat(data);

console.log(selection.recommended); // 'csv' or 'toon'
`

$3

`typescript
import { batchConvert } from '@toon/converter';

const result = await batchConvert(
[
{ input: 'data1.json' },
{ input: 'data2.json', output: 'data2.toon' },
],
{ to: 'toon' }
);

console.log(result.summary);
``

API Reference

$3

Convert between formats.

$3

Convert with auto-detection from filename.

$3

Auto-detect format from filename and content.

$3

Select optimal format for data structure.

$3

Compare all formats and show savings.

License

MIT