gui.panels.yaml_editor

  1from pathlib import Path
  2
  3import yaml
  4
  5from PySide6.QtWidgets import (
  6    QWidget, QVBoxLayout, QHBoxLayout, QPlainTextEdit,
  7    QPushButton, QLabel, QLineEdit, QTextEdit,
  8)
  9from PySide6.QtGui import (
 10    QFont, QTextCursor, QKeySequence, QShortcut,
 11    QTextCharFormat, QColor, QBrush,
 12)
 13from PySide6.QtCore import Signal, Qt, QTimer
 14
 15from gui.panels.slide_assistant import SLIDE_TYPES, SlideAssistant
 16
 17
 18class _AutoIndentEditor(QPlainTextEdit):
 19    """QPlainTextEdit con auto-indentado: Enter replica la indentación de la línea actual."""
 20
 21    def keyPressEvent(self, event) -> None:
 22        if event.key() in (Qt.Key.Key_Return, Qt.Key.Key_Enter):
 23            cursor = self.textCursor()
 24            block_text = cursor.block().text()
 25            indent = len(block_text) - len(block_text.lstrip(' '))
 26            super().keyPressEvent(event)
 27            self.textCursor().insertText(' ' * indent)
 28        else:
 29            super().keyPressEvent(event)
 30from gui.theme import c, signal as theme_signal
 31from gui.utils.dropdown_button import DropdownButton
 32from gui.utils.yaml_highlighter import YamlHighlighter
 33from lib.i18n import _
 34
 35
 36class YamlEditorPanel(QWidget):
 37    content_changed = Signal()
 38    saved = Signal(Path)
 39
 40    def __init__(self, parent=None):
 41        super().__init__(parent)
 42        self._path: Path | None = None
 43        self._dirty = False
 44        self._matches: list[QTextCursor] = []
 45        self._match_idx: int = -1
 46        self._search_sels: list = []
 47        self._error_sels:  list = []
 48
 49        self._validate_timer = QTimer(self)
 50        self._validate_timer.setSingleShot(True)
 51        self._validate_timer.setInterval(400)
 52        self._validate_timer.timeout.connect(self._validate_yaml)
 53
 54        from lib.slides_config import get_autosave_seconds
 55        _autosave_secs = get_autosave_seconds()
 56        self._autosave_timer: QTimer | None = None
 57        if _autosave_secs > 0:
 58            self._autosave_timer = QTimer(self)
 59            self._autosave_timer.setInterval(_autosave_secs * 1000)
 60            self._autosave_timer.timeout.connect(self._autosave)
 61            self._autosave_timer.start()
 62
 63        self._build_ui()
 64
 65        theme_signal().changed.connect(self._on_theme_changed)
 66
 67    # ── Construcción ─────────────────────────────────────────────────────────
 68
 69    def _build_ui(self) -> None:
 70        layout = QVBoxLayout(self)
 71        layout.setContentsMargins(0, 0, 0, 0)
 72        layout.setSpacing(0)
 73
 74        layout.addWidget(self._make_editor_bar())
 75
 76        self._error_bar_widget = self._make_error_bar()
 77        self._error_bar_widget.setVisible(False)
 78        layout.addWidget(self._error_bar_widget)
 79
 80        self._search_bar_widget = self._make_search_bar()
 81        self._search_bar_widget.setVisible(False)
 82        layout.addWidget(self._search_bar_widget)
 83
 84        self._editor = _AutoIndentEditor()
 85        self._editor.setObjectName('yaml_editor')
 86        self._editor.setFont(QFont('Liberation Mono', 12))
 87        self._editor.textChanged.connect(self._on_text_changed)
 88        layout.addWidget(self._editor)
 89
 90        from gui import theme as _t
 91        self._highlighter = YamlHighlighter(self._editor.document(), _t.get())
 92
 93        QShortcut(QKeySequence('Ctrl+S'), self).activated.connect(self.save)
 94        QShortcut(QKeySequence('Ctrl+F'), self).activated.connect(self._open_search)
 95        QShortcut(QKeySequence('Escape'), self._editor).activated.connect(self._close_search)
 96
 97    def _make_editor_bar(self) -> QWidget:
 98        bar = QWidget()
 99        bar.setObjectName('file_bar')
100        bar.setFixedHeight(40)
101        hlay = QHBoxLayout(bar)
102        hlay.setContentsMargins(10, 0, 10, 0)
103        hlay.setSpacing(6)
104
105        # Zona izquierda — tipo de snippet + insertar
106        self._tipo_combo = DropdownButton()
107        self._tipo_combo.addItems(SLIDE_TYPES)
108        self._tipo_combo.setFixedWidth(150)
109        hlay.addWidget(self._tipo_combo)
110
111        btn_insert = QPushButton(_('Insertar'))
112        btn_insert.setObjectName('insert_btn')
113        btn_insert.setFixedHeight(26)
114        btn_insert.setToolTip(_('Insertar snippet en el cursor  (↩)'))
115        btn_insert.clicked.connect(self._insert_snippet)
116        hlay.addWidget(btn_insert)
117
118        hlay.addStretch(1)
119
120        # Zona central — nombre de fichero (anchor visual)
121        self._lbl_file = QLabel('—')
122        self._lbl_file.setObjectName('file_name_label')
123        self._lbl_file.setAlignment(Qt.AlignmentFlag.AlignCenter)
124        self._lbl_file.setMinimumWidth(100)
125        hlay.addWidget(self._lbl_file)
126
127        hlay.addStretch(1)
128
129        # Zona derecha — Revertir (ghost sutil, activo solo cuando hay cambios)
130        self._btn_revert = QPushButton(_('Revertir'))
131        self._btn_revert.setObjectName('revert_btn')
132        self._btn_revert.setFixedHeight(26)
133        self._btn_revert.setToolTip(_('Descartar cambios desde el último guardado'))
134        self._btn_revert.setEnabled(False)
135        self._btn_revert.clicked.connect(self.revert)
136        hlay.addWidget(self._btn_revert)
137
138        return bar
139
140    def _make_error_bar(self) -> QWidget:
141        bar = QWidget()
142        bar.setObjectName('yaml_error_bar')
143        bar.setFixedHeight(24)
144        hlay = QHBoxLayout(bar)
145        hlay.setContentsMargins(12, 2, 12, 2)
146        hlay.setSpacing(4)
147        self._error_label = QLabel('')
148        self._error_label.setObjectName('yaml_error_label')
149        hlay.addWidget(self._error_label)
150        hlay.addStretch()
151        return bar
152
153    def _make_search_bar(self) -> QWidget:
154        bar = QWidget()
155        bar.setObjectName('search_bar')
156        bar.setFixedHeight(44)
157        hlay = QHBoxLayout(bar)
158        hlay.setContentsMargins(12, 6, 12, 6)
159        hlay.setSpacing(8)
160
161        self._search_input = QLineEdit()
162        self._search_input.setObjectName('search_input')
163        self._search_input.setPlaceholderText(_('Buscar…  (Intro=siguiente, Shift+Intro=anterior)'))
164        self._search_input.setFixedWidth(320)
165        self._search_input.textChanged.connect(self._update_search)
166        self._search_input.returnPressed.connect(self._search_next)
167        hlay.addWidget(self._search_input)
168
169        self._search_info = QLabel('')
170        self._search_info.setObjectName('search_info')
171        self._search_info.setMinimumWidth(52)
172        self._search_info.setAlignment(Qt.AlignmentFlag.AlignCenter)
173        hlay.addWidget(self._search_info)
174
175        for text, tip, slot in (
176            ('↑', _('Anterior  (Shift+Intro)'), self._search_prev),
177            ('↓', _('Siguiente  (Intro)'),      self._search_next),
178        ):
179            btn = QPushButton(text)
180            btn.setObjectName('bar_btn')
181            btn.setFixedSize(28, 28)
182            btn.setToolTip(tip)
183            btn.clicked.connect(slot)
184            hlay.addWidget(btn)
185
186        btn_close = QPushButton('✕')
187        btn_close.setObjectName('bar_btn')
188        btn_close.setFixedSize(28, 28)
189        btn_close.setToolTip(_('Cerrar  (Esc)'))
190        btn_close.clicked.connect(self._close_search)
191        hlay.addWidget(btn_close)
192
193        hlay.addStretch()
194
195        QShortcut(QKeySequence('Shift+Return'), self._search_input).activated.connect(
196            self._search_prev
197        )
198        QShortcut(QKeySequence('Escape'), self._search_input).activated.connect(
199            self._close_search
200        )
201        return bar
202
203    # ── API pública ───────────────────────────────────────────────────────────
204
205    def open_file(self, path: Path) -> None:
206        self._path = path
207        self._editor.blockSignals(True)
208        self._editor.setPlainText(path.read_text(encoding='utf-8'))
209        self._editor.blockSignals(False)
210        self._set_dirty(False)
211        self._validate_yaml()
212        if self._search_bar_widget.isVisible():
213            self._update_search()
214
215    def save(self) -> None:
216        if self._path is None:
217            return
218        self._path.write_text(self._editor.toPlainText(), encoding='utf-8')
219        self._set_dirty(False)
220        self.saved.emit(self._path)
221
222    def revert(self) -> None:
223        if self._path is None:
224            return
225        self._editor.blockSignals(True)
226        self._editor.setPlainText(self._path.read_text(encoding='utf-8'))
227        self._editor.blockSignals(False)
228        self._set_dirty(False)
229
230    def scroll_to_slide(self, section_idx: int, slide_idx: int) -> None:
231        line = self._find_line(section_idx, slide_idx)
232        self._go_to_line(line)
233
234    def scroll_to_field(self, field: str) -> None:
235        lines = self._editor.toPlainText().splitlines()
236        for i, ln in enumerate(lines):
237            if ln.startswith(f'{field}:'):
238                self._go_to_line(i)
239                return
240
241    def toPlainText(self) -> str:
242        return self._editor.toPlainText()
243
244    def set_text(self, text: str) -> None:
245        self._editor.setPlainText(text)
246
247    # ── Búsqueda ─────────────────────────────────────────────────────────────
248
249    def _open_search(self) -> None:
250        self._search_bar_widget.setVisible(True)
251        selected = self._editor.textCursor().selectedText().strip()
252        if selected and '\n' not in selected:
253            self._search_input.setText(selected)
254        self._search_input.setFocus()
255        self._search_input.selectAll()
256        self._update_search()
257
258    def _close_search(self) -> None:
259        if not self._search_bar_widget.isVisible():
260            return
261        self._search_bar_widget.setVisible(False)
262        self._search_sels = []
263        self._matches = []
264        self._match_idx = -1
265        self._update_extra_selections()
266        self._editor.setFocus()
267
268    def _update_search(self) -> None:
269        query = self._search_input.text()
270        self._matches = []
271        self._match_idx = -1
272        self._search_sels = []
273
274        if not query:
275            self._search_info.setText('')
276            self._search_input.setStyleSheet('')
277            self._update_extra_selections()
278            return
279
280        doc = self._editor.document()
281        cursor = QTextCursor(doc)
282        while True:
283            cursor = doc.find(query, cursor)
284            if cursor.isNull():
285                break
286            self._matches.append(QTextCursor(cursor))
287
288        if self._matches:
289            self._search_input.setStyleSheet('')
290            self._match_idx = 0
291            self._apply_highlights()
292            self._goto_match(0)
293        else:
294            self._search_info.setText(_('—'))
295            self._search_input.setStyleSheet(f'border-color: {c("error")};')
296            self._update_extra_selections()
297
298    def _apply_highlights(self) -> None:
299        fmt_all = QTextCharFormat()
300        fmt_all.setBackground(QBrush(QColor(245, 158, 11, 80)))
301
302        fmt_current = QTextCharFormat()
303        fmt_current.setBackground(QBrush(QColor(59, 130, 246, 160)))
304        fmt_current.setForeground(QBrush(QColor('#ffffff')))
305
306        self._search_sels = []
307        for i, cur in enumerate(self._matches):
308            sel = QTextEdit.ExtraSelection()
309            sel.cursor = cur
310            sel.format = fmt_current if i == self._match_idx else fmt_all
311            self._search_sels.append(sel)
312
313        self._update_extra_selections()
314        n = len(self._matches)
315        self._search_info.setText(f'{self._match_idx + 1}/{n}')
316
317    def _goto_match(self, idx: int) -> None:
318        if not self._matches:
319            return
320        self._match_idx = idx % len(self._matches)
321        self._apply_highlights()
322        self._editor.setTextCursor(self._matches[self._match_idx])
323        self._editor.ensureCursorVisible()
324
325    def _search_next(self) -> None:
326        if self._matches:
327            self._goto_match(self._match_idx + 1)
328
329    def _search_prev(self) -> None:
330        if self._matches:
331            self._goto_match(self._match_idx - 1)
332
333    # ── Validación YAML ───────────────────────────────────────────────────────
334
335    def _validate_yaml(self) -> None:
336        text = self._editor.toPlainText()
337        self._error_sels = []
338        try:
339            yaml.safe_load(text)
340            self._error_bar_widget.setVisible(False)
341        except yaml.YAMLError as exc:
342            line = -1
343            msg  = str(exc).split('\n')[0]
344            if hasattr(exc, 'problem_mark') and exc.problem_mark:
345                line = exc.problem_mark.line
346                msg  = f'Línea {line + 1}: {exc.problem or msg}'
347            self._error_label.setText(msg)
348            self._error_bar_widget.setVisible(True)
349            if line >= 0:
350                block  = self._editor.document().findBlockByLineNumber(line)
351                cursor = QTextCursor(block)
352                cursor.select(QTextCursor.SelectionType.LineUnderCursor)
353                fmt = QTextCharFormat()
354                fmt.setBackground(QBrush(QColor(239, 68, 68, 55)))
355                fmt.setUnderlineStyle(QTextCharFormat.UnderlineStyle.WaveUnderline)
356                fmt.setUnderlineColor(QColor('#ef4444'))
357                sel = QTextEdit.ExtraSelection()
358                sel.cursor = cursor
359                sel.format  = fmt
360                self._error_sels = [sel]
361        self._update_extra_selections()
362
363    def _update_extra_selections(self) -> None:
364        self._editor.setExtraSelections(self._search_sels + self._error_sels)
365
366    # ── Snippets ─────────────────────────────────────────────────────────────
367
368    def _insert_snippet(self) -> None:
369        tipo    = self._tipo_combo.currentText()
370        snippet = SlideAssistant.get_snippet(tipo)
371        cursor  = self._editor.textCursor()
372
373        current_line = cursor.block().text()
374        indent = self._detect_slide_indent(cursor)
375        adjusted = self._adjust_indent(snippet, indent)
376
377        if current_line.strip():
378            # Línea con contenido: insertar al final en nueva línea
379            cursor.movePosition(QTextCursor.MoveOperation.EndOfLine)
380            cursor.insertText('\n' + adjusted)
381        else:
382            # Línea en blanco: reemplazar respetando la indentación del contexto
383            cursor.select(QTextCursor.SelectionType.BlockUnderCursor)
384            cursor.insertText(adjusted.rstrip('\n'))
385
386        self._editor.setTextCursor(cursor)
387        self._editor.ensureCursorVisible()
388
389    def _detect_slide_indent(self, cursor: QTextCursor) -> int:
390        """Busca hacia arriba el nivel de indentación correcto para insertar un slide.
391
392        Ignora la línea actual (que puede ser una propiedad con más indent)
393        y sube hasta encontrar un marcador semántico de contexto.
394        """
395        b = cursor.block()
396        while b.isValid():
397            text = b.text()
398            stripped = text.lstrip()
399            if stripped.startswith('- tipo:'):
400                return len(text) - len(stripped)
401            if stripped.startswith('slides:'):
402                return (len(text) - len(stripped)) + 2
403            if stripped.startswith('- indice:') or stripped.startswith('- titulo:'):
404                return (len(text) - len(stripped)) + 4
405            b = b.previous()
406        return 6  # fallback: indentación estándar del formato
407
408    @staticmethod
409    def _adjust_indent(snippet: str, to_indent: int, from_indent: int = 6) -> str:
410        """Reindenta el snippet de from_indent a to_indent espacios."""
411        if from_indent == to_indent:
412            return snippet
413        delta = to_indent - from_indent
414        result = []
415        for line in snippet.split('\n'):
416            if not line.strip():
417                result.append(line)
418            elif delta > 0:
419                result.append(' ' * delta + line)
420            else:
421                strip = min(-delta, len(line) - len(line.lstrip()))
422                result.append(line[strip:])
423        return '\n'.join(result)
424
425    # ── Búsqueda de línea ─────────────────────────────────────────────────────
426
427    def _find_line(self, section_idx: int, slide_idx: int) -> int:
428        lines = self._editor.toPlainText().splitlines()
429        section_starts = [
430            i for i, ln in enumerate(lines)
431            if ln.lstrip().startswith('- indice:') or ln.lstrip().startswith('- titulo:')
432        ]
433        if section_idx < 0 or section_idx >= len(section_starts):
434            return 0
435        sec_start = section_starts[section_idx]
436        sec_end = (
437            section_starts[section_idx + 1]
438            if section_idx + 1 < len(section_starts)
439            else len(lines)
440        )
441        if slide_idx == -1:
442            return sec_start
443        count = 0
444        for i in range(sec_start, sec_end):
445            if lines[i].lstrip().startswith('- tipo:'):
446                if count == slide_idx:
447                    return i
448                count += 1
449        return sec_start
450
451    def _go_to_line(self, line: int) -> None:
452        block  = self._editor.document().findBlockByLineNumber(line)
453        cursor = QTextCursor(block)
454        self._editor.setTextCursor(cursor)
455        self._editor.ensureCursorVisible()
456
457    # ── Estado dirty ──────────────────────────────────────────────────────────
458
459    def _on_text_changed(self) -> None:
460        self._set_dirty(True)
461        self.content_changed.emit()
462        self._validate_timer.start()
463        if self._search_bar_widget.isVisible() and self._search_input.text():
464            self._update_search()
465
466    def _set_dirty(self, dirty: bool, _force: bool = False) -> None:
467        state_changed = dirty != self._dirty or _force
468        self._dirty = dirty
469        if self._path:
470            self._lbl_file.setText(f'{self._path.name}  ●' if dirty else self._path.name)
471            if state_changed:
472                color = c('text') if dirty else c('text_muted')
473                self._lbl_file.setStyleSheet(
474                    f'color:{color}; font-size:13px; font-weight:500;'
475                )
476        else:
477            self._lbl_file.setText('—')
478            if state_changed:
479                self._lbl_file.setStyleSheet(
480                    f'color:{c("text_muted")}; font-size:13px; font-weight:500;'
481                )
482        self._btn_revert.setEnabled(bool(dirty and self._path))
483
484    def _autosave(self) -> None:
485        if self._dirty and self._path is not None:
486            self.save()
487
488    def _on_theme_changed(self) -> None:
489        self._set_dirty(self._dirty, _force=True)
490        from gui import theme as _t
491        self._highlighter.set_theme(_t.get())