Function saveTo

src/engine/persistence.ts:36–105

(engine: VisualNovelEngine, prefix = 'SaveLabel', id: number | null = null, name: string | null = null)

// ============================================================================

export async function saveTo (engine: VisualNovelEngine, prefix = 'SaveLabel', id: number | null = null, name: string | null = null): Promise<unknown> {
	// Check if the player is actually playing
	if (!engine.global ('playing')) {
		return;
	}

	const now = DateTime.now();
	const date = now.toISO();
	const timestamp = now.toMillis();
	const gameData = gameObject(engine);

	if (name === null || name.trim () === '') {
		name = date;
	}

	let image = '';

	const backgroundState = engine.state ('background');
	const sceneState = engine.state ('scene');

	if (backgroundState) {
		image = backgroundState.split (' ')[2];
	} else if (sceneState) {
		image = sceneState.split (' ')[2];
	}

	const slotKey = `${engine.setting (prefix)}_${id || timestamp}`;

	let screenshot: string | undefined;

	if (engine.setting ('Screenshots')) {
		try {
			// Prefer the screenshot captured when the save screen was opened.
			// Auto-saves fire during gameplay, so they fall back to capturing the still-visible game screen.
			let blob: Blob | null = null;

			if (engine._pendingScreenshot) {
				blob = await engine._pendingScreenshot;
				engine._pendingScreenshot = null;
			} else {
				blob = await captureGameScreenshot (engine);
			}

			if (blob) {
				screenshot = await engine.onSaveScreenshot (slotKey, blob);
			}
		} catch (e) {
			engine.debug.warn ('Screenshot capture failed:', e);
		}
	}

	const saveData: Record<string, unknown> = {
		name,
		date,
		image,
		game: gameData
	};