@gehdoc/svg-to-video 0.23.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,76 @@
1
+ import path from 'path';
2
+ import fs from 'fs';
3
+ import { mergeMetadataComments } from '#shared/metadata.js';
4
+ import { injectGifMetadata } from '#shared/gifMetadataInjector.js';
5
+ export class GifFormatGenerator {
6
+ id = 'gif';
7
+ extensions = ['.gif'];
8
+ supportsAlpha = true;
9
+ buildFfmpegArgs(options) {
10
+ const { fps, hold, outDir, transparent, metadata, inputPattern, pkgVersion, outputFileName, } = options;
11
+ const args = [
12
+ '-hide_banner',
13
+ '-loglevel',
14
+ 'warning',
15
+ '-y',
16
+ '-framerate',
17
+ String(fps),
18
+ '-i',
19
+ inputPattern,
20
+ ];
21
+ let userComment;
22
+ let title;
23
+ if (metadata) {
24
+ metadata.forEach((m) => {
25
+ if (m.startsWith('comment=')) {
26
+ userComment = m.split('=')[1];
27
+ }
28
+ else if (m.startsWith('title=')) {
29
+ title = m.split('=')[1];
30
+ args.push('-metadata', m);
31
+ }
32
+ else {
33
+ args.push('-metadata', m);
34
+ }
35
+ });
36
+ }
37
+ const finalComment = mergeMetadataComments(userComment, pkgVersion);
38
+ const filters = [];
39
+ if (hold && hold > 0) {
40
+ filters.push(`tpad=stop_mode=clone:stop_duration=${hold}`);
41
+ }
42
+ const reserveTrans = transparent ? 1 : 0;
43
+ let filterComplex;
44
+ if (filters.length > 0) {
45
+ filterComplex = `${filters.join(',')},split[a][b];[a]palettegen=reserve_transparent=${reserveTrans}[p];[b][p]paletteuse`;
46
+ }
47
+ else {
48
+ filterComplex = `split[a][b];[a]palettegen=reserve_transparent=${reserveTrans}[p];[b][p]paletteuse`;
49
+ }
50
+ args.push('-filter_complex', filterComplex);
51
+ args.push('-loop', '0');
52
+ const gifComment = title ? `${title} - ${finalComment}` : finalComment;
53
+ args.push('-metadata', `comment=${gifComment}`);
54
+ const outputFullPath = path.join(outDir, outputFileName);
55
+ args.push('-f', 'gif', outputFullPath);
56
+ return args;
57
+ }
58
+ postProcess(outputFilePath, options) {
59
+ const { metadata, pkgVersion } = options;
60
+ let userComment;
61
+ let title;
62
+ if (metadata) {
63
+ metadata.forEach((m) => {
64
+ if (m.startsWith('comment=')) {
65
+ userComment = m.split('=')[1];
66
+ }
67
+ else if (m.startsWith('title=')) {
68
+ title = m.split('=')[1];
69
+ }
70
+ });
71
+ }
72
+ const fileBuf = fs.readFileSync(outputFilePath);
73
+ const updatedBuf = injectGifMetadata(fileBuf, { title, comment: userComment }, pkgVersion);
74
+ fs.writeFileSync(outputFilePath, updatedBuf);
75
+ }
76
+ }
@@ -0,0 +1,49 @@
1
+ import path from 'path';
2
+ import { mergeMetadataComments } from '#shared/metadata.js';
3
+ export class MkvFormatGenerator {
4
+ id = 'mkv';
5
+ extensions = ['.mkv'];
6
+ supportsAlpha = true;
7
+ buildFfmpegArgs(options) {
8
+ const { fps, hold, outDir, transparent, metadata, inputPattern, pkgVersion, outputFileName, } = options;
9
+ const args = [
10
+ '-hide_banner',
11
+ '-loglevel',
12
+ 'warning',
13
+ '-y',
14
+ '-framerate',
15
+ String(fps),
16
+ '-i',
17
+ inputPattern,
18
+ ];
19
+ let userComment;
20
+ if (metadata) {
21
+ metadata.forEach((m) => {
22
+ if (m.startsWith('comment=')) {
23
+ userComment = m.split('=')[1];
24
+ }
25
+ else {
26
+ args.push('-metadata', m);
27
+ }
28
+ });
29
+ }
30
+ const finalComment = mergeMetadataComments(userComment, pkgVersion);
31
+ const filters = [];
32
+ if (hold && hold > 0) {
33
+ filters.push(`tpad=stop_mode=clone:stop_duration=${hold}`);
34
+ }
35
+ if (filters.length) {
36
+ args.push('-vf', filters.join(','));
37
+ }
38
+ args.push('-metadata', `comment=${finalComment}`);
39
+ if (transparent) {
40
+ args.push('-c:v', 'libvpx-vp9', '-pix_fmt', 'yuva420p');
41
+ }
42
+ else {
43
+ args.push('-c:v', 'libx264', '-crf', '20', '-preset', 'slow', '-pix_fmt', 'yuv420p');
44
+ }
45
+ const outputFullPath = path.join(outDir, outputFileName);
46
+ args.push(outputFullPath);
47
+ return args;
48
+ }
49
+ }
@@ -0,0 +1,49 @@
1
+ import path from 'path';
2
+ import { mergeMetadataComments } from '#shared/metadata.js';
3
+ export class MovFormatGenerator {
4
+ id = 'mov';
5
+ extensions = ['.mov'];
6
+ supportsAlpha = true;
7
+ buildFfmpegArgs(options) {
8
+ const { fps, hold, outDir, transparent, metadata, inputPattern, pkgVersion, outputFileName, } = options;
9
+ const args = [
10
+ '-hide_banner',
11
+ '-loglevel',
12
+ 'warning',
13
+ '-y',
14
+ '-framerate',
15
+ String(fps),
16
+ '-i',
17
+ inputPattern,
18
+ ];
19
+ let userComment;
20
+ if (metadata) {
21
+ metadata.forEach((m) => {
22
+ if (m.startsWith('comment=')) {
23
+ userComment = m.split('=')[1];
24
+ }
25
+ else {
26
+ args.push('-metadata', m);
27
+ }
28
+ });
29
+ }
30
+ const finalComment = mergeMetadataComments(userComment, pkgVersion);
31
+ const filters = [];
32
+ if (hold && hold > 0) {
33
+ filters.push(`tpad=stop_mode=clone:stop_duration=${hold}`);
34
+ }
35
+ if (filters.length) {
36
+ args.push('-vf', filters.join(','));
37
+ }
38
+ args.push('-metadata', `comment=${finalComment}`);
39
+ if (transparent) {
40
+ args.push('-c:v', 'png', '-pix_fmt', 'rgba');
41
+ }
42
+ else {
43
+ args.push('-c:v', 'libx264', '-crf', '20', '-preset', 'slow', '-pix_fmt', 'yuv420p');
44
+ }
45
+ const outputFullPath = path.join(outDir, outputFileName);
46
+ args.push(outputFullPath);
47
+ return args;
48
+ }
49
+ }
@@ -0,0 +1,43 @@
1
+ import path from 'path';
2
+ import { mergeMetadataComments } from '#shared/metadata.js';
3
+ export class Mp4FormatGenerator {
4
+ id = 'mp4';
5
+ extensions = ['.mp4'];
6
+ supportsAlpha = false;
7
+ buildFfmpegArgs(options) {
8
+ const { fps, hold, outDir, metadata, inputPattern, pkgVersion, outputFileName, } = options;
9
+ const args = [
10
+ '-hide_banner',
11
+ '-loglevel',
12
+ 'warning',
13
+ '-y',
14
+ '-framerate',
15
+ String(fps),
16
+ '-i',
17
+ inputPattern,
18
+ ];
19
+ let userComment;
20
+ if (metadata) {
21
+ metadata.forEach((m) => {
22
+ if (m.startsWith('comment=')) {
23
+ userComment = m.split('=')[1];
24
+ }
25
+ else {
26
+ args.push('-metadata', m);
27
+ }
28
+ });
29
+ }
30
+ const finalComment = mergeMetadataComments(userComment, pkgVersion);
31
+ const filters = [];
32
+ if (hold && hold > 0) {
33
+ filters.push(`tpad=stop_mode=clone:stop_duration=${hold}`);
34
+ }
35
+ if (filters.length) {
36
+ args.push('-vf', filters.join(','));
37
+ }
38
+ args.push('-metadata', `comment=${finalComment}`, '-c:v', 'libx264', '-crf', '20', '-preset', 'slow', '-pix_fmt', 'yuv420p', '-movflags', '+faststart');
39
+ const outputFullPath = path.join(outDir, outputFileName);
40
+ args.push(outputFullPath);
41
+ return args;
42
+ }
43
+ }
@@ -0,0 +1,45 @@
1
+ import path from 'path';
2
+ import { mergeMetadataComments } from '#shared/metadata.js';
3
+ export class WebmFormatGenerator {
4
+ id = 'webm';
5
+ extensions = ['.webm'];
6
+ supportsAlpha = true;
7
+ buildFfmpegArgs(options) {
8
+ const { fps, hold, outDir, transparent, metadata, inputPattern, pkgVersion, outputFileName, } = options;
9
+ const args = [
10
+ '-hide_banner',
11
+ '-loglevel',
12
+ 'warning',
13
+ '-y',
14
+ '-framerate',
15
+ String(fps),
16
+ '-i',
17
+ inputPattern,
18
+ ];
19
+ let userComment;
20
+ if (metadata) {
21
+ metadata.forEach((m) => {
22
+ if (m.startsWith('comment=')) {
23
+ userComment = m.split('=')[1];
24
+ }
25
+ else {
26
+ args.push('-metadata', m);
27
+ }
28
+ });
29
+ }
30
+ const finalComment = mergeMetadataComments(userComment, pkgVersion);
31
+ const filters = [];
32
+ if (hold && hold > 0) {
33
+ filters.push(`tpad=stop_mode=clone:stop_duration=${hold}`);
34
+ }
35
+ if (filters.length) {
36
+ args.push('-vf', filters.join(','));
37
+ }
38
+ args.push('-metadata', `comment=${finalComment}`);
39
+ const pixFmt = transparent ? 'yuva420p' : 'yuv420p';
40
+ args.push('-c:v', 'libvpx-vp9', '-pix_fmt', pixFmt, '-f', 'webm');
41
+ const outputFullPath = path.join(outDir, outputFileName);
42
+ args.push(outputFullPath);
43
+ return args;
44
+ }
45
+ }
@@ -0,0 +1,71 @@
1
+ import { Mp4FormatGenerator } from './generators/Mp4FormatGenerator.js';
2
+ import { WebmFormatGenerator } from './generators/WebmFormatGenerator.js';
3
+ import { GifFormatGenerator } from './generators/GifFormatGenerator.js';
4
+ import { ApngFormatGenerator } from './generators/ApngFormatGenerator.js';
5
+ import { MkvFormatGenerator } from './generators/MkvFormatGenerator.js';
6
+ import { MovFormatGenerator } from './generators/MovFormatGenerator.js';
7
+ export class CLIFormatRegistry {
8
+ generators = new Map();
9
+ constructor() {
10
+ this.registerDefaults();
11
+ }
12
+ register(generator) {
13
+ this.generators.set(generator.id.toLowerCase(), generator);
14
+ for (const ext of generator.extensions) {
15
+ const lower = ext.toLowerCase();
16
+ this.generators.set(lower, generator);
17
+ if (lower.startsWith('.')) {
18
+ this.generators.set(lower.slice(1), generator);
19
+ }
20
+ }
21
+ }
22
+ get(formatOrExtension) {
23
+ const key = formatOrExtension.toLowerCase().trim();
24
+ return this.generators.get(key);
25
+ }
26
+ getAll() {
27
+ const unique = new Set();
28
+ for (const gen of this.generators.values()) {
29
+ unique.add(gen);
30
+ }
31
+ return Array.from(unique);
32
+ }
33
+ isSupported(formatOrExtension) {
34
+ return this.get(formatOrExtension) !== undefined;
35
+ }
36
+ getSupportedFormatNames() {
37
+ const names = new Set();
38
+ for (const gen of this.getAll()) {
39
+ names.add(gen.id);
40
+ for (const ext of gen.extensions) {
41
+ names.add(ext.startsWith('.') ? ext.slice(1) : ext);
42
+ }
43
+ }
44
+ return Array.from(names);
45
+ }
46
+ resolveFormatAndExtension(rawFormat, transparent) {
47
+ const selectedFormat = rawFormat
48
+ ? rawFormat.toLowerCase().trim()
49
+ : transparent
50
+ ? 'webm'
51
+ : 'mp4';
52
+ const generator = this.get(selectedFormat);
53
+ if (!generator) {
54
+ const supported = this.getSupportedFormatNames().join(', ');
55
+ throw new Error(`Invalid format "${rawFormat}". Supported formats are: ${supported}.`);
56
+ }
57
+ const extension = selectedFormat.startsWith('.')
58
+ ? selectedFormat
59
+ : generator.extensions[0];
60
+ return { generator, format: generator.id, extension };
61
+ }
62
+ registerDefaults() {
63
+ this.register(new Mp4FormatGenerator());
64
+ this.register(new WebmFormatGenerator());
65
+ this.register(new GifFormatGenerator());
66
+ this.register(new ApngFormatGenerator());
67
+ this.register(new MkvFormatGenerator());
68
+ this.register(new MovFormatGenerator());
69
+ }
70
+ }
71
+ export const formatRegistry = new CLIFormatRegistry();
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,291 @@
1
+ #!/usr/bin/env node
2
+ import fs from 'fs';
3
+ import child_process from 'child_process';
4
+ import puppeteer from 'puppeteer';
5
+ import { Command } from 'commander';
6
+ import path from 'path';
7
+ import { seekAnimations } from '../shared/animation-engine.js';
8
+ import { validateOptions } from './utils/validateOptions.js';
9
+ import { analyzeSvgAnimation } from '../shared/analyzeSvgAnimation.js';
10
+ import { formatRegistry } from './formats/registry.js';
11
+ import { getPackageJson } from './utils/packageInfo.js';
12
+ const pkg = getPackageJson(import.meta.url);
13
+ import { JSDOM } from 'jsdom'; // For duration detection in Node environment
14
+ import { Logger } from './utils/logger.js';
15
+ const frameFileExtension = 'png';
16
+ async function main() {
17
+ const program = new Command();
18
+ program
19
+ .name('svg-to-video')
20
+ .version(pkg.version)
21
+ .description(`svg-to-video v${pkg.version} - Render a CSS-animated SVG to a high-quality video or animated image (MP4, WebM, MKV, MOV, GIF, aPNG)`)
22
+ .usage('<svgPath> <fps> <outDir> [options]')
23
+ .addHelpText('after', `
24
+ Resources:
25
+ GitHub: ${pkg.homepage}
26
+ Support: ${pkg.funding.url} (Buy me a coffee! \u2615)`)
27
+ .argument('<svgPath>', 'input animated SVG file')
28
+ .argument('<fps>', 'frames per second', (v) => parseInt(v, 10))
29
+ .argument('<outDir>', 'output directory')
30
+ .option('-d, --duration <seconds>', 'desired animation duration (seconds)', (v) => parseFloat(v))
31
+ .option('-h, --hold <seconds>', 'additional seconds to freeze last frame', (v) => {
32
+ const num = parseFloat(v);
33
+ if (isNaN(num) || num < 0) {
34
+ console.warn(`Warning: Invalid hold value "${v}". Defaulting to 0.`);
35
+ return 0;
36
+ }
37
+ return num;
38
+ }, 0)
39
+ .option('--keep-frames', 'keep temporary frames after creating video', false)
40
+ .option('-f, --force', 'overwrite existing output files without asking', false)
41
+ .option('--resolution <preset>', 'resolution preset: 720p, 1080p, or original', 'original')
42
+ .option('--scale <number>', 'scale factor for original resolution (1-4)', (v) => parseFloat(v), 1)
43
+ .option('--transparent', 'render with a transparent background', false)
44
+ .option('--bg-color <hex>', 'background color for the video (e.g., #FFFFFF)', '#ffffff')
45
+ .option('--metadata <items...>', 'metadata tags (e.g., --metadata title="My Video" author="Me")')
46
+ .option('--format <format>', `output format: ${formatRegistry.getSupportedFormatNames().join(', ')}`)
47
+ .option('-q, --quiet', 'suppress interactive progress output', false)
48
+ .option('--silent', 'alias for --quiet', false)
49
+ .option('--json', 'output final conversion result as JSON (implies quiet mode)', false)
50
+ .action(run);
51
+ program
52
+ .command('mcp')
53
+ .description('Start Model Context Protocol (MCP) server over stdio')
54
+ .action(async () => {
55
+ await import('./mcp.js');
56
+ });
57
+ program.parse(process.argv);
58
+ }
59
+ /**
60
+ * main function to run the conversion process
61
+ */
62
+ async function run(svgPath, fps, outDir, options) {
63
+ const logger = new Logger({
64
+ quiet: options.quiet || options.silent,
65
+ json: options.json,
66
+ homepage: pkg.homepage,
67
+ });
68
+ // Resolve format generator and output file extension via format registry
69
+ const { format, extension } = formatRegistry.resolveFormatAndExtension(options.format, options.transparent);
70
+ const inputBasename = path.basename(svgPath, path.extname(svgPath));
71
+ const ext = extension.startsWith('.') ? extension : `.${extension}`;
72
+ const outputFileName = `${inputBasename}${ext}`;
73
+ const outputFullPath = path.join(outDir, outputFileName);
74
+ if (fs.existsSync(outputFullPath) && !options.force) {
75
+ throw logger.fatal(`Output file "${outputFullPath}" already exists. Use the --force (-f) flag to overwrite it.`);
76
+ }
77
+ try {
78
+ validateOptions(options);
79
+ }
80
+ catch (error) {
81
+ throw logger.fatal(error instanceof Error ? error.message : String(error));
82
+ }
83
+ if (!fs.existsSync(svgPath)) {
84
+ throw logger.fatal(`Input SVG file "${svgPath}" does not exist.`);
85
+ }
86
+ const svg = fs.readFileSync(svgPath, 'utf-8');
87
+ let duration = options.duration;
88
+ if (duration === undefined) {
89
+ logger.info('๐Ÿ” Duration not provided, attempting to auto-detect...');
90
+ const dom = new JSDOM('');
91
+ duration = analyzeSvgAnimation(svg, dom.window.DOMParser);
92
+ if (duration === undefined) {
93
+ throw logger.fatal('Could not detect duration. Please provide a duration using -d or --duration.');
94
+ }
95
+ logger.info(`โœ… Auto-detected duration: ${duration}s`);
96
+ }
97
+ const puppeteerArgs = (process.env.PUPPETEER_ARGS || '')
98
+ .split(' ')
99
+ .filter((arg) => arg.trim().length > 0);
100
+ const totalFrames = Math.ceil(fps * duration);
101
+ const padWidth = Math.floor(Math.log10(totalFrames)) + 1;
102
+ logger.info('๐Ÿš€ Starting conversion:');
103
+ logger.info(` Source: ${svgPath}`);
104
+ logger.info(` Target: ${path.join(outDir, outputFileName)}`);
105
+ logger.info(` Settings: ${duration}s @ ${fps}fps (Format: ${format}, Hold: ${options.hold}s, Resolution: ${options.resolution}, Scale: ${options.scale}x, Transparent: ${options.transparent}, BGColor: ${options.bgColor || 'default'})`);
106
+ if (puppeteerArgs.length > 0) {
107
+ logger.info(` Puppeteer: ${puppeteerArgs.join(' ')}`);
108
+ }
109
+ logger.info(` Frames: ${totalFrames} total`);
110
+ logger.info('---');
111
+ fs.mkdirSync(outDir, { recursive: true });
112
+ await createFrames(svg, fps, totalFrames, padWidth, outDir, puppeteerArgs, options.resolution, options.scale, options.transparent, options.bgColor, logger);
113
+ convertToOutput(outputFileName, format, fps, padWidth, options.hold, outDir, options.transparent, options.metadata, logger);
114
+ if (!options.keepFrames) {
115
+ cleanupFrames(totalFrames, padWidth, outDir, logger);
116
+ }
117
+ logger.done(outputFullPath, {
118
+ duration,
119
+ fps,
120
+ format,
121
+ totalFrames,
122
+ resolution: options.resolution,
123
+ transparent: options.transparent,
124
+ });
125
+ }
126
+ /**
127
+ * create frame images by rendering the SVG in a headless browser and advancing the animation to the correct timestamp for each frame
128
+ */
129
+ async function createFrames(svg, fps, totalFrames, padWidth, outDir, puppeteerArgs, resolutionPreset, scaleFactor, transparent, bgColor, logger) {
130
+ logger.info('๐Ÿ“ธ Rendering frames with Puppeteer...');
131
+ let width = 0;
132
+ let height = 0;
133
+ if (resolutionPreset === '1080p') {
134
+ width = 1920;
135
+ height = 1080;
136
+ }
137
+ else if (resolutionPreset === '720p') {
138
+ width = 1280;
139
+ height = 720;
140
+ }
141
+ else if (resolutionPreset === 'original') {
142
+ const dom = new JSDOM(svg);
143
+ const svgEl = dom.window.document.querySelector('svg');
144
+ if (!svgEl) {
145
+ throw new Error('Invalid SVG: No <svg> root element found.');
146
+ }
147
+ const viewBox = svgEl.getAttribute('viewBox');
148
+ const widthAttr = svgEl.getAttribute('width');
149
+ const heightAttr = svgEl.getAttribute('height');
150
+ if (viewBox) {
151
+ const parts = viewBox.trim().split(/[\s,]+/);
152
+ if (parts.length === 4) {
153
+ width = parseFloat(parts[2]);
154
+ height = parseFloat(parts[3]);
155
+ }
156
+ }
157
+ if ((!width || !height) && widthAttr && heightAttr) {
158
+ width = parseFloat(widthAttr);
159
+ height = parseFloat(heightAttr);
160
+ }
161
+ if (!width || !height) {
162
+ logger.warn('โš ๏ธ Warning: Could not detect SVG dimensions. Defaulting to 1280x720.');
163
+ width = 1280;
164
+ height = 720;
165
+ }
166
+ width = Math.round(width * scaleFactor);
167
+ height = Math.round(height * scaleFactor);
168
+ }
169
+ else {
170
+ throw new Error(`Invalid resolution preset: ${resolutionPreset}. Expected '1080p', '720p', or 'original'.`);
171
+ }
172
+ logger.info('๐Ÿš€ Preparing Puppeteer browser...');
173
+ const launchOptions = {
174
+ headless: true,
175
+ args: ['--no-sandbox', '--disable-setuid-sandbox', ...puppeteerArgs],
176
+ };
177
+ if (process.env.PUPPETEER_EXECUTABLE_PATH) {
178
+ launchOptions.executablePath = process.env.PUPPETEER_EXECUTABLE_PATH;
179
+ }
180
+ let browser;
181
+ try {
182
+ browser = await puppeteer.launch(launchOptions);
183
+ }
184
+ catch (initialError) {
185
+ if (launchOptions.executablePath) {
186
+ throw initialError;
187
+ }
188
+ logger.info('๐Ÿ” Bundled Chrome not found, attempting system Chrome...');
189
+ try {
190
+ browser = await puppeteer.launch({ ...launchOptions, channel: 'chrome' });
191
+ }
192
+ catch {
193
+ throw initialError;
194
+ }
195
+ }
196
+ const page = await browser.newPage();
197
+ await page.setViewport({ width, height });
198
+ await page.setContent(svg, { waitUntil: 'domcontentloaded' });
199
+ const bgStyle = transparent
200
+ ? 'html, body { background: transparent !important; }'
201
+ : bgColor
202
+ ? `html, body { background-color: ${bgColor} !important; }`
203
+ : '';
204
+ await page.addStyleTag({
205
+ content: `
206
+ * { margin: 0; padding: 0; box-sizing: border-box; }
207
+ svg { width: 100%; height: 100%; display: block; }
208
+ ${bgStyle}
209
+ `.trim(),
210
+ });
211
+ const screenshotOptions = {
212
+ omitBackground: transparent,
213
+ };
214
+ logger.info('๐Ÿ“ธ Rendering frames with Puppeteer...');
215
+ for (let frame = 1; frame <= totalFrames; ++frame) {
216
+ logger.writeProgress(`\r๐Ÿ“ธ Rendering frame ${frame}/${totalFrames}`);
217
+ const timeMs = ((frame - 1) / fps) * 1000;
218
+ await page.evaluate(seekAnimations, timeMs);
219
+ const filename = path.join(outDir, getFrameFilename(frame, padWidth));
220
+ await page.screenshot({
221
+ path: filename,
222
+ ...screenshotOptions,
223
+ });
224
+ }
225
+ logger.info('');
226
+ await browser.close();
227
+ }
228
+ /**
229
+ * convert the generated frames to an output format using ffmpeg
230
+ */
231
+ function convertToOutput(outputFileName, format, fps, padWidth, hold, outDir, transparent, metadata, logger) {
232
+ logger.info('๐Ÿ“ฆ Encoding output with FFmpeg...');
233
+ const normalizedFormat = format.toLowerCase();
234
+ const generator = formatRegistry.get(normalizedFormat);
235
+ if (!generator) {
236
+ throw new Error(`Unsupported format: ${format}`);
237
+ }
238
+ const inputPattern = path.join(outDir, `%0${padWidth}d.${frameFileExtension}`);
239
+ const formatOptions = {
240
+ outputFileName,
241
+ fps,
242
+ padWidth,
243
+ hold: hold || 0,
244
+ outDir,
245
+ transparent: !!transparent,
246
+ metadata,
247
+ inputPattern,
248
+ pkgVersion: pkg.version,
249
+ };
250
+ const args = generator.buildFfmpegArgs(formatOptions);
251
+ try {
252
+ const output = child_process.execFileSync('ffmpeg', args, {
253
+ encoding: 'utf8',
254
+ });
255
+ if (output)
256
+ logger.info(output);
257
+ const outputFullPath = path.join(outDir, outputFileName);
258
+ if (generator.postProcess) {
259
+ generator.postProcess(outputFullPath, formatOptions);
260
+ }
261
+ }
262
+ catch (error) {
263
+ throw logger.fatal('FFmpeg execution failed', error instanceof Error ? error.message : String(error));
264
+ }
265
+ }
266
+ /**
267
+ * delete the generated frames
268
+ */
269
+ function cleanupFrames(totalFrames, padWidth, outDir, logger) {
270
+ logger.info('๐Ÿงน Cleaning up temporary frames...');
271
+ for (let frame = 1; frame <= totalFrames; ++frame) {
272
+ const filename = path.join(outDir, getFrameFilename(frame, padWidth));
273
+ try {
274
+ fs.unlinkSync(filename);
275
+ }
276
+ catch (error) {
277
+ logger.error(`โŒ Failed to delete frame: ${filename}`, error);
278
+ }
279
+ }
280
+ }
281
+ /**
282
+ * Generates a padded filename for a given frame number.
283
+ */
284
+ function getFrameFilename(frame, padWidth) {
285
+ const prefix = ('' + frame).padStart(padWidth, '0');
286
+ return `${prefix}.${frameFileExtension}`;
287
+ }
288
+ main().catch((err) => {
289
+ console.error(err);
290
+ process.exit(1);
291
+ });