gitbreathing

1import fs from 'node:fs/promises';
2import path from 'node:path';
3import sharp from 'sharp';
4import { GIFEncoder, quantize, applyPalette } from 'gifenc';
5import { svg } from 'ascii.rest/svg';
6import { createBreathingPiece } from '../src/breathing';
7import { IDS, STYLES, type StyleId } from '../src/styles';
8 
9type Config = {
10  username: string;
11  platform?: 'github' | 'gitlab' | 'custom';
12  styles?: StyleId[];
13  maxContributions?: number;
14  contributions?: number;
15  resolution?: number;
16  frames?: number;
17  fps?: number;
18  powerCurve?: number;
19  background?: 'transparent' | 'dark';
20  seed?: string;
21  styleWeights?: Partial<Record<StyleId, number>>;
22  styleColors?: Partial<Record<StyleId, string[]>>;
23  effects?: { glow?: boolean; particles?: boolean; secondaryCuts?: boolean; motion?: boolean; particleDensity?: number; strokeScale?: number };
24  outputDir?: string;
25};
26 
27const configPath = process.env.GITBREATHING_CONFIG || 'gitbreathing.json';
28const config = JSON.parse(await fs.readFile(configPath, 'utf8')) as Config;
29const username = (config.username || process.env.GITBREATHING_USERNAME || 'anonymous').trim();
30const contributions = Number(process.env.CONTRIBUTIONS ?? config.contributions ?? 0);
31if (!Number.isFinite(contributions) || contributions < 0) throw new Error('CONTRIBUTIONS must be a non-negative number.');
32const max = Math.max(1, Number(config.maxContributions ?? 5000));
33const curve = Math.max(0.1, Math.min(4, Number(config.powerCurve ?? 1)));
34const power = Math.pow(Math.min(1, contributions / max), curve);
35const styles = (config.styles ?? ['sun', 'water', 'mist']).filter((value): value is StyleId => IDS.includes(value));
36if (!styles.length) throw new Error(`Choose at least one supported style: ${IDS.join(', ')}.`);
37const frames = Math.max(4, Math.min(60, Math.round(Number(config.frames ?? 24))));
38const fps = Math.max(4, Math.min(30, Math.round(Number(config.fps ?? 12))));
39const seed = config.seed || `${config.platform || 'custom'}:${username.toLowerCase()}:${styles.join(',')}`;
40const outputDir = config.outputDir || 'dist';
41await fs.mkdir(outputDir, { recursive: true });
42 
43const piece = createBreathingPiece({
44  styles,
45  power,
46  seed,
47  styleWeights: config.styleWeights,
48  styleColors: config.styleColors,
49});
50const animatedSvg = svg(piece, {
51  dark: true,
52  seconds: frames / fps,
53  fps,
54  scale: 9,
55  label: `GitBreathing animated ASCII slash for ${username}`,
56});
57await fs.writeFile(path.join(outputDir, 'slash.svg'), animatedSvg, 'utf8');
58 
59const draw = piece.default();
60const width = piece.meta.cols * 12;
61const height = piece.meta.rows * 19;
62const palette = piece.meta.palette ?? [];
63 
64function escapeXml(value: string) {
65  return value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&apos;');
66}
67 
68function frameSvg(time: number) {
69  const colorIndexes = new Uint8Array(piece.meta.cols * piece.meta.rows);
70  const text = draw(time, { color: colorIndexes });
71  const lines = text.split('\n');
72  const spans: string[] = [];
73  for (let y = 0; y < lines.length; y++) {
74    const row = lines[y] ?? '';
75    let x = 0;
76    while (x < row.length) {
77      const index = colorIndexes[y * piece.meta.cols + x] ?? 0;
78      let end = x + 1;
79      while (end < row.length && colorIndexes[y * piece.meta.cols + end] === index) end++;
80      const content = row.slice(x, end);
81      if (content.trim()) {
82        spans.push(`<text x="${x * 12}" y="${(y + 1) * 19 - 3}" fill="${palette[index] ?? '#ffffff'}">${escapeXml(content)}</text>`);
83      }
84      x = end;
85    }
86  }
87  return `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}"><rect width="100%" height="100%" fill="#080a10"/><g font-family="ui-monospace,SFMono-Regular,Consolas,monospace" font-size="15" font-weight="600" xml:space="preserve">${spans.join('')}</g></svg>`;
88}
89 
90const firstFrame = Buffer.from(frameSvg(0));
91await sharp(firstFrame).png().toFile(path.join(outputDir, 'slash.png'));
92await fs.writeFile(path.join(outputDir, 'slash.txt'), draw(0), 'utf8');
93 
94const rgbaFrames: Uint8Array[] = [];
95const combined = new Uint8Array(width * height * 4 * frames);
96for (let frame = 0; frame < frames; frame++) {
97  const { data } = await sharp(Buffer.from(frameSvg(frame / fps)))
98    .resize(width, height)
99    .ensureAlpha()
100    .raw()
101    .toBuffer({ resolveWithObject: true });
102  const rgba = new Uint8Array(data);
103  rgbaFrames.push(rgba);
104  combined.set(rgba, frame * width * height * 4);
105}
106 
107const gifPalette = quantize(combined, 256);
108const gif = GIFEncoder();
109for (const rgba of rgbaFrames) {
110  gif.writeFrame(applyPalette(rgba, gifPalette), width, height, {
111    palette: gifPalette,
112    delay: Math.round(1000 / fps),
113    repeat: 0,
114  });
115}
116gif.finish();
117await fs.writeFile(path.join(outputDir, 'slash.gif'), Buffer.from(gif.bytes()));
118 
119const metadata = {
120  generator: 'GitBreathing',
121  version: '1.1.0',
122  username,
123  platform: config.platform || 'custom',
124  contributions,
125  power: Number(power.toFixed(4)),
126  styles,
127  lineage: Object.fromEntries(styles.map((id) => [id, STYLES[id].parent])),
128  resolution: { columns: piece.meta.cols, rows: piece.meta.rows },
129  frames,
130  fps,
131  seed,
132  outputs: ['slash.svg', 'slash.gif', 'slash.png', 'slash.txt'],
133};
134await fs.writeFile(path.join(outputDir, 'metadata.json'), `${JSON.stringify(metadata, null, 2)}\n`);
135console.log(`GitBreathing ASCII renderer generated ${styles.join(' + ')} for ${username}: ${contributions} contributions, ${Math.round(power * 100)}% power.`);
136console.log(`Wrote ${path.join(outputDir, 'slash.svg')}, slash.gif, slash.png, slash.txt and metadata.json.`);
137