Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

feat: completar la experiencia de integración WSL en Ajustes

Abierto
  • ¿Algo no está bien?
#93 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
25/100
Tipo de issue
Nueva funcionalidad
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
react, typescript
Área
desktop, developer-experience

Línea de trabajo

Start with src/Settings.tsx and src/lib/types.ts, then read the existing configuration save/dirty flow and CLI diagnostics; check the contracts in issues #90–#92 and coordinate copy with #66. The scope spans UI, backend integration, accessibility, documentation, and Windows/WSL validation. Done means meeting the listed acceptance criteria, including rendered Windows/WSL checks and evidence for all four milestone units.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

odd type:feature
Pre-flight checks
  • I searched existing issues and found no duplicate.
  • I understand that this proposal requires product review before implementation.

La búsqueda de duplicados abiertos y cerrados fue realizada por el asistente. El mantenedor confirmó el principio de revisión de producto y aprobó la propuesta quorb-wsl-v1 y su publicación. La publicación no inicia implementación ni asigna trabajo.

Problem to solve

Una integración WSL sin controles y estados coherentes deja al usuario interpretando rutas UNC, diagnósticos Windows y logins que pueden operar en otra distribución. La elección debe ser comprensible, persistente y recuperable desde la UI existente.

Proposed solution

Añadir en Ajustes, solo en Windows, «Integración WSL» con toggle, selector de distribución, usuario/home detectados y diagnóstico por proveedor. Mostrar entorno efectivo y excepciones avanzadas, integrar login/reintento y documentar el flujo completo.

Affected area

Application behavior

Scope and non-goals
Objetivo y alcance

Experiencia completa para activar, configurar, comprobar y desactivar WSL desde Ajustes sin escribir rutas UNC en el caso estándar. Reutilizar componentes/estilo de Quorb, estados de guardado y diagnóstico existentes. Documentación integrada con la unidad y comprobación end-to-end del milestone.

Dependencias y decisiones

La integración completa depende de issue-environment, issue-sessions y issue-login; diseño y pruebas con mocks pueden avanzar con el contrato acordado. Coordinar textos propios ES/EN y errores con #66: no crear otro sistema de traducción ni exigir terminar toda la internacionalización para investigar WSL. Preservar la prioridad de #66.

Criterios de aceptación
  • Sección visible solo en Windows; toggle y distribución seleccionada persisten.
  • Se muestran usuario/home y entorno efectivo; cada excepción de ruta avanzada indica explícitamente que tiene prioridad sobre el modo elegido.
  • Estados diferenciados: carga, WSL ausente, sin distribuciones, detenida, no disponible, timeout, CLI ausente, falta login, credenciales encontradas y error. Detectar archivo no se anuncia como sesión autenticada.
  • Acciones de comprobar, reintentar y login reflejan el entorno elegido; informar antes de despertar una distribución detenida.
  • Cambios del toggle/selector son borrador hasta Guardar; cerrarlos sin guardar no cambia el entorno operativo. Diagnóstico del borrador se identifica como tal.
  • Sin cambios no se activa Guardar; reversión, errores de guardado y ediciones durante una operación conservan el comportamiento actual y no pierden cambios.
  • Tras guardar el entorno, diagnósticos/datos de sesión se actualizan sin mostrar otra cuenta como actual; desactivar recupera Windows sin borrar credenciales ni ajustes manuales.
  • No se ofrece una instalación Windows para resolver una CLI WSL ni se muestra fallback silencioso a otra cuenta.
  • Navegación por teclado, labels accesibles, foco y estados de carga/error cumplen el patrón existente. Textos propios coordinados con ES/EN sin traducir rutas, nombres de distribución o contenido del usuario.
  • Guía de uso y solución de problemas en documentación ES/EN: activar/desactivar, distribución detenida, excepciones avanzadas y límites.
  • Tests de UI con mocks más prueba renderizada real Windows/WSL: CLI solo WSL, varias distribuciones, credenciales ausentes, rutas con espacios, cuenta adicional y cambio Windows↔WSL.
  • Cierre del milestone exige aceptación y evidencia de las cuatro unidades; no se acredita WSL desde tests Linux ni se promete una versión/release.
Orientación y ODD progresivo

Entradas: src/Settings.tsx, src/lib/types.ts, flujo de configuración/dirty/save y diagnóstico CLI, README ES/EN y guías vigentes. Observar UX actual → acordar estados y copy con contratos backend → implementar componentes/tests por resultado → verificar accesibilidad, guardado y flujo Windows/WSL real.

Exclusiones

No rediseño general de Ajustes, sistema de traducción paralelo, selección por proveedor de múltiples distribuciones, soporte nativo Linux, Antigravity ni publicación de instaladores/releases.

Coordinación y entrega

Parte de quorb-wsl-v1, milestone «Integración WSL en Windows» e índice #45. Estado: planificada; no anunciar lista para implementar mientras falten las decisiones o dependencias indicadas. Sin assignee inicial. Revalidar issue, comentarios, responsables y PR antes de un inicio explícito; asignación no es un lock. Se conserva la prioridad vigente del roadmap: #66 sigue siendo el primer objetivo nuevo recomendado y WSL puede investigarse independientemente sin desplazar compromisos existentes.

Tests y documentación con cada unidad. Seguir CONTRIBUTING y entregar cambios revisables; checks planificados, no ejecutados durante esta planificación: npm test, npm run typecheck, npm run build y cargo test en src-tauri, según superficie. Linux no acredita ejecución Windows/WSL. Commit, push, PR, merge, firma, release y asignaciones requieren sus autorizaciones propias.

Alternatives considered

Botón aislado de búsqueda y rutas UNC manuales: no expresan un entorno coherente para lectura/login. Un modo independiente por cada proveedor/distribución: amplía innecesariamente la primera integración; las rutas avanzadas actuales siguen como excepciones explícitas.

Lenguaje dominante
TypeScript
Estrellas
10
Forks
2
Merge medio
21 min
PR fusionados (30 d)
52

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de egdev6/quorb

Todos los issues de egdev6/quorb

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.