twblue/context.md

Contexto de trabajo

Objetivo final

Igualar la experiencia de Bluesky con Mastodon en la interfaz (menús, diálogos, buffers y accesos), manteniendo las diferencias sólo cuando el protocolo lo exige. Mastodon es la referencia.

Estado actual

Se completaron todos los puntos de falta.md. Ahora se está trabajando en igualar características de accesibilidad comparando con el código original de Mastodon en srcantiguo/.

Cambios recientes (sesión actual)

• Accesibilidad mejorada en Bluesky:

  • Implementado método onFocus() para: actualizar tiempos relativos, leer posts largos en GUI, reproducir sonidos indicadores de audio/imagen.
  • Implementado método auto_read() para lectura automática de nuevos items.
  • Implementado menú contextual (show_menu(), show_menu_by_key()).
  • Añadido método open_in_browser() para abrir posts en navegador.
  • Añadido método add_new_item() para streaming.
  • Añadido método update_item() para actualizar items existentes.
  • Añadido método get_buffer_name() para nombres de buffer legibles.
  • Añadido método copy() para copiar al portapapeles.

• Nuevos archivos creados:

  • src/sessions/blueski/utils.py - Funciones utilitarias (is_audio_or_video, is_image, get_media_urls, find_urls).
  • src/wxUI/dialogs/blueski/menus.py - Menús contextuales (baseMenu, notificationMenu, userMenu, chatMenu).

• Correcciones de sonido:

  • Arreglado bug en base.py donde self.sound = sound usaba variable indefinida.
  • Añadido self.sound a todos los buffers (Conversation, chat, user, etc.).

Cambios anteriores

• Perfil de usuario mejorado: imágenes de avatar/banner, botones de timeline (posts, followers, following).
• Acciones de usuario en perfil: follow, unfollow, mute, unmute, block, unblock.
• Autocompletado añadido al diálogo de acciones de usuario.
• Atajos de teclado (&) añadidos a botones del perfil.
• Persistencia de búsquedas implementada (se guardan y restauran al reiniciar).
• Paginación completa en todos los buffers: HomeTimeline, FollowingTimeline, NotificationBuffer, LikesBuffer, MentionsBuffer, SentBuffer, UserTimeline, SearchBuffer.
• Activado autocompletado en el diálogo "Ver timeline..." y validación de usuario.
• Reposts/Likes ahora abren buffers con paginación bajo "Timelines".
• Restauración de followers/following propios sin duplicar.
• Estructura del árbol: se añadió "Searches" en Bluesky.
• Menús: para Bluesky, las opciones no aplicables se ocultan usando el sentinel "HIDE".

Puntos pendientes

• Verificar funcionamiento completo de onFocus con la aplicación en ejecución.
• Implementar soporte de templates para usuarios y notificaciones (como Mastodon).
• Considerar OCR para imágenes si es necesario.

Notas técnicas

• onFocus() se conecta via self.buffer.set_focus_function(self.onFocus) en bind_events().
• auto_read() se llama desde process_items() automáticamente si hay nuevos items.
• Menú contextual aparece con clic derecho o tecla de menú (WXK_WINDOWS_MENU).
• utils.is_audio_or_video() y utils.is_image() detectan multimedia en posts de Bluesky.
• Los sonidos indicadores (indicate_audio, indicate_img) ya están en blueski.defaults.
• update_menus en src/controller/mainController.py interpreta "HIDE" para ocultar entradas.
• Buffers de Reposts/Likes usan PostUserListBuffer con cursor para paginación.
• Las búsquedas ahora se guardan en session.settings["other_buffers"]["searches"].
• Perfil de usuario descarga imágenes en thread separado para no bloquear UI.
• Paginación usa patrón: self.next_cursor guardado en start_stream(), usado en get_more_items().
• El menú "load_previous_items" activa get_more_items() en el buffer actual.