summaryrefslogtreecommitdiffhomepage
path: root/jsdoc/c-transpiler.js
blob: 3360c7e09603c699a40221e3b82150c2f61a8c09 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
/*
 * c-transpiler.js - transpile C to JS while retaining line numbers.
 *
 * Copyright (C) 2023 Jo-Philipp Wich <jo@mein.io>
 *
 * Permission to use, copy, modify, and/or distribute this software for any
 * purpose with or without fee is hereby granted, provided that the above
 * copyright notice and this permission notice appear in all copies.
 *
 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */

'use strict';

function isCommentStart(source, offset) {
	if (source[offset++] != '\n')
		return false;

	while (source[offset] == ' ' || source[offset] == '\t')
		offset++;

	return (
		source[offset++] == '/' &&
		source[offset++] == '*' &&
		source[offset++] == '*'
	);
}

exports.handlers = {
  beforeParse: function(e) {
	if (!e.filename.match(/\.(c|h)$/))
		return;

	let chunks = [ { start: 0, end: -1, comment: false } ];
	let chunk = chunks[0];
	let i = 0;

	for (i = 0; i < e.source.length; i++) {
		if (!chunk.comment && isCommentStart(e.source, i)) {
			chunk.end = i;
			chunk = { start: i, end: -1, comment: true };
			chunks.push(chunk);
			i += 3;
		}
		else if (chunk.comment && e.source[i] == '*' && e.source[i+1] == '/') {
			chunk.end = i + 1;
			chunk = { start: i + 1, end: -1, comment: false };
			chunks.push(chunk);
			i += 1;
		}
	}

	chunk.end = i;

	let source = '';

	for (chunk of chunks) {
		if (chunk.comment)
			source += e.source.substring(chunk.start, chunk.end);
		else
			source += e.source.substring(chunk.start, chunk.end).replace(/(^|\n)/g, '$1//');
	}

	e.source = source;
  }
};