@character-foundry/exporter

Universal character card exporter with loss detection.

Installation

npm install @character-foundry/exporter

Features

• Multi-format export - PNG, CharX, Voxta
• Loss detection - Preview data loss before conversion
• Asset handling - Embed or extract assets
• V2/V3 support - Export PNG as v2 for compatibility

Quick Start

import { exportCard, checkExportLoss } from '@character-foundry/exporter';

// Check for data loss before export
const loss = checkExportLoss(card, assets, 'png');
if (!loss.isLossless) {
  console.warn('Fields lost:', loss.lostFields);
  console.warn('Assets lost:', loss.lostAssets);
}

// Export to different formats
const pngBuffer = exportCard(card, assets, 'png');
const charxBuffer = exportCard(card, assets, 'charx');
const voxtaBuffer = exportCard(card, assets, 'voxta');

// Export PNG as v2 for maximum compatibility
const v2Png = exportCard(card, assets, 'png', { exportAsV2: true });

Documentation

See docs/exporter.md for full API documentation.

License

MIT