import type { DataData } from '@dosgato/templating';
import { DateTime } from 'luxon';
import { type DGContext } from '../internal.js';
/**
 * This function represents the process of migrating a piece from one schema version
 * to another.
 *
 * Schema versions are represented as Dates so that templates built by different authors
 * can be mixed and matched and have their migrations placed on a single timeline. It
 * could still get complicated if a third party template is not upgraded for some time and
 * the data entry has been migrated and saved in the time between the template's
 * migration date and bringing the update into the project. It may be necessary to manipulate
 * the template's migrations to alter the desired date to the date of the update.
 * Otherwise the template's migration would be skipped because it's too old.
 */
export declare function migrateData(ctx: DGContext, data: DataData, dataRootId: string, dataFolderId?: string, dataId?: string, toSchemaVersion?: DateTime<true>): Promise<DataData>;