export-kerning/README.md

Export kernings of a Opentype font

# export-kerning

Export kernings of a Opentype font. Works with (ttf, otf and woff)

## Installation

```bash
npm install
```

## Usage

You can use the tool in two ways:

### Using npx (recommended)
```bash
npx export-kerning <font-file> [options]
```

### Using node directly
```bash
node index.js <font-file> [options]
```

### Options

- `-o, --output <file>` - Output file path (default: "kerning.json")
- `-t, --text <text>` - Text to analyze for kerning pairs
- `-r, --ranges <ranges>` - Unicode ranges to analyze
- `-h, --help` - Display help information

### Examples

Export kerning to JSON:
```bash
npx export-kerning LibreBaskerville.ttf
```

Optimized export with ranges : 
```bash
npx export-kerning LibreBaskerville.ttf -r U+0020-007E 
```

Optimized export with text : 
```bash
npx export-kerning LibreBaskerville.ttf -t "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum."
```

## Exported format

```
{
  "unitsPerEm": 1000,
  "kerningPairs": [
    { "left": ["f"], "right": ["í", "ı"], "value": 1 },
    { "left": ["ď", "ĩ", "ľ", "ť"], "right": ["ß"], "value": 1 },
    { "left": ["ff"], "right": ["í", "ı", "ȷ"], "value": 1 },
    { "left": ["ĩ"], "right": ["]"], "value": 4 },
    { "left": ["("], "right": ["W", "Ŵ", "Ẁ", "Ẃ", "Ẅ"], "value": 5 },
    {
      "left": ["U", "Ù", "Ú", "Û", "Ü", "Ũ", "Ū", "Ŭ", "Ů", "Ű", "Ų", "Ụ"],
      "right": ["b", "þ"],
      "value": 5
    }
  ]
}
```

## License

ISC