Thoth / server /synctex.js
mfirat007's picture
Upload 46 files
f41aded verified
Raw History Blame Contribute Delete
7.34 kB
// SyncTeX: PDF'teki bir nokta ile kaynak dosyadaki satır arasında iki yönlü eşleme.
// Biçim: https://github.com/jlaurens/synctex (synctex_parser.c). Koordinatlar, sayfanın sol üst
// köşesinden itibaren PDF noktası (bp) cinsine çevrilir; y aşağı doğru artar.
import { readFileSync } from 'node:fs';
import { gunzipSync } from 'node:zlib';
const SP_PER_BP = 65781.76;
// Önek, etiket, satır, (isteğe bağlı sütun), yatay, düşey, ardından genişlik ve kutularda yükseklik/derinlik.
const RECORD = /^([[(vhxkg$])(\d+),(\d+)(?:,-?\d+)?:(-?\d+),(-?\d+)(?::(-?\d+)(?:,(-?\d+),(-?\d+))?)?$/;
const BOX_OPEN = new Set(['[', '(']);
const HBOX = new Set(['(', 'h']);
/**
* SyncTeX metnini ayrıştırır.
* @param {string} text Açılmış .synctex içeriği
* @param {(inputPath: string) => string | null} mapPath Girdi yolunu proje içi yola çevirir; proje dışıysa null
*/
export function parseSynctex(text, mapPath) {
const files = new Map(); // etiket -> proje içi yol
const records = [];
const stack = [];
let preamble = true;
let unit = 1;
let magnification = 1000;
let xOffset = 0;
let yOffset = 0;
let page = 0;
for (const line of text.split(/\r?\n/)) {
if (line.startsWith('Input:')) {
const m = line.match(/^Input:(\d+):(.*)$/);
const mapped = m && m[2] ? mapPath(m[2]) : null;
if (mapped) files.set(Number(m[1]), mapped);
continue;
}
if (preamble) {
const m = line.match(/^(Unit|Magnification|X Offset|Y Offset):(-?[\d.]+)$/);
if (m) {
const v = Number(m[2]);
if (m[1] === 'Unit') unit = v || 1;
else if (m[1] === 'Magnification') magnification = v || 1000;
else if (m[1] === 'X Offset') xOffset = v;
else yOffset = v;
}
if (line === 'Content:') preamble = false;
continue;
}
const c = line[0];
if (c === '{') page = Number(line.slice(1));
else if (c === '}') stack.length = 0;
else if (c === ']' || c === ')') stack.pop();
else {
const m = line.match(RECORD);
if (!m) continue;
const scale = (unit * magnification) / 1000 / SP_PER_BP;
const index = records.length;
records.push({
kind: m[1],
page,
tag: Number(m[2]),
line: Number(m[3]),
x: (Number(m[4]) + xOffset) * scale,
y: (Number(m[5]) + yOffset) * scale,
w: m[6] != null ? Number(m[6]) * scale : 0,
h: m[7] != null ? Number(m[7]) * scale : 0,
d: m[8] != null ? Number(m[8]) * scale : 0,
parent: stack.length ? stack[stack.length - 1] : -1,
});
if (BOX_OPEN.has(m[1])) stack.push(index);
}
}
return { files, records };
}
/** Sıkıştırılmış .synctex.gz dosyasını okur; `srcDir` altındaki yolları proje içi yollara çevirir. */
export function loadSynctex(file, srcDir) {
const norm = (p) => p.replace(/\\/g, '/');
const prefix = `${norm(srcDir).replace(/\/$/, '')}/`.toLowerCase();
const mapPath = (input) => {
let p = norm(input);
if (p.toLowerCase().startsWith(prefix)) p = p.slice(prefix.length);
else if (/^([a-z]:)?\//i.test(p)) return null; // proje dışındaki mutlak yol
p = p.replace(/^(\.\/)+/, '');
return p && !p.startsWith('../') ? p : null;
};
return parseSynctex(gunzipSync(readFileSync(file)).toString('utf8'), mapPath);
}
const hasArea = (r) => r.w > 0 && r.h + r.d > 0;
const rectOf = (r) => ({ x: r.x, y: r.y - r.h, w: r.w, h: r.h + r.d });
/**
* Kaynaktan PDF'e: `path` dosyasının `line` satırının yer aldığı sayfa ve dikdörtgenler.
* Satırın kendisi PDF'te iz bırakmadıysa (boş satır, yorum) yakın satırlara bakılır.
*/
export function forwardSearch({ files, records }, path, line) {
const tags = new Set([...files].filter(([, p]) => p === path).map(([t]) => t));
if (!tags.size) return null;
for (let step = 0; step <= 40; step++) {
const target = line + (step % 2 ? Math.ceil(step / 2) : -step / 2);
const matches = records.filter((r) => r.line === target && tags.has(r.tag));
if (!matches.length) continue;
const page = Math.min(...matches.map((r) => r.page));
const seen = new Set();
const rects = [];
for (const r of matches) {
if (r.page !== page) continue;
// Kutu değilse içinde bulunduğu satırın (yatay kutunun) dikdörtgeni kullanılır.
const box = HBOX.has(r.kind) ? r : records[r.parent];
if (!box || !HBOX.has(box.kind) || !hasArea(box)) continue;
const rect = rectOf(box);
const key = [rect.x, rect.y, rect.w, rect.h].map(Math.round).join();
if (!seen.has(key)) {
seen.add(key);
rects.push(rect);
}
}
// Başka bir dikdörtgenin içinde kalanlar atılır (ör. denklemin iç kutuları).
const contains = (a, b) => a !== b && b.x >= a.x - 0.5 && b.y >= a.y - 0.5 && b.x + b.w <= a.x + a.w + 0.5 && b.y + b.h <= a.y + a.h + 0.5;
const outer = rects.filter((r) => !rects.some((other) => contains(other, r)));
// Hiç kutu yoksa ilk kaydın konumu işaretlenir.
if (!outer.length) outer.push({ x: matches[0].x, y: matches[0].y - 10, w: 20, h: 12 });
return { page, line: target, rects: outer.slice(0, 40) };
}
return null;
}
/** PDF'ten kaynağa: `page` sayfasındaki (x, y) noktasına karşılık gelen dosya ve satır. */
export function inverseSearch({ files, records }, page, x, y) {
const onPage = records.filter((r) => r.page === page);
const mapped = (r) => files.has(r.tag);
const result = (r) => ({ file: files.get(r.tag), line: r.line });
// Noktayı içeren en küçük yatay kutu: tıklanan satır.
let box = null;
for (const r of onPage) {
if (!HBOX.has(r.kind) || !hasArea(r)) continue;
const { x: bx, y: by, w, h } = rectOf(r);
if (x >= bx && x <= bx + w && y >= by - 1 && y <= by + h + 1 && (!box || w * h < box.w * (box.h + box.d))) box = r;
}
if (box) {
// Satırdaki (iç içe kutular dahil) kayıtlardan tıklanan yerin solunda kalan en yakın olanı;
// bir satır birden fazla kaynak satırından gelen sözcükleri içerebilir.
const boxIndex = records.indexOf(box);
const within = (r) => {
for (let p = r.parent; p !== -1; p = records[p].parent) if (p === boxIndex) return true;
return false;
};
const inside = onPage.filter((r) => mapped(r) && within(r));
const before = inside.filter((r) => r.x <= x).sort((a, b) => b.x - a.x)[0];
const pick = before ?? inside.sort((a, b) => a.x - b.x)[0] ?? (mapped(box) ? box : null);
if (pick) return result(pick);
}
// Yedek: sayfadaki en yakın kayıt (düşey uzaklık daha ağır basar). Satır içi kayıtlar öne
// alınır; sayfa düzeninden kalan düşey boşluklar (ör. sonraki \chapter'ın sayfa sonu) yanıltıcıdır.
const inLine = (r) => HBOX.has(r.kind) || records[r.parent]?.kind === '(';
const candidates = onPage.filter((r) => mapped(r) && inLine(r));
let best = null;
let bestDistance = Infinity;
for (const r of candidates.length ? candidates : onPage.filter(mapped)) {
const dx = Math.max(0, r.x - x, x - (r.x + r.w));
const dy = Math.max(0, r.y - r.h - y, y - (r.y + r.d));
const distance = dx + 4 * dy;
if (distance < bestDistance) {
bestDistance = distance;
best = r;
}
}
return best ? result(best) : null;
}