Function: convert()

function convert(
   templateBuffer, 
   sourceBuffer, 
options?): Promise<OutputFile[]>;

Defined in: src/index.ts:232

Run full conversion: template + source → output files.

Reads the XTL template workbook, applies its directives over the source workbook, and returns one OutputFile per emitted file group.

Parameters

Parameter	Type
templateBuffer	ArrayBuffer
sourceBuffer	ArrayBuffer
options?	ConvertOptions

Returns

Promise<OutputFile[]>

Stable

Frozen at 1.0 per spec/STABILITY.md "Public API surface". Signature changes are 2.0-only.

Example

const outputs = await convert(templateBuffer, sourceBuffer, {
  inputs: { month: '2026-05' },
});