// 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; }