Megi es un motor de navegación web moderno, open source e independiente desarrollado desde cero en Rust (Edición 2024), sin bifurcar (fork) Blink, WebKit ni Gecko. Su diseño se rige estrictamente por las especificaciones formales vivas de WHATWG y W3C, con verificación continua en bucle cerrado (closed-loop testing) contra Web Platform Tests (WPT) y
html5lib-tests.
Navegador interactivo Megi (crates/browser): chrome nativo con barra de navegación, pestañas, motor tipográfico y renderizado determinista de HTML/CSS de extremo a extremo. Para más ejemplos y capturas de renderizado, consulta la Galería de Renders.
· Progress map (checklist histórico)
Pre-Alpha v0.1.0 · cobertura de capacidades verificable: ver PROGRESS.md y coverage.html · tests y líneas de Rust actualizados en PROGRESS.md (badges superiores) · gate de conformidad PASS (4 suites) · 17 crates · 17/17 crates con #![forbid(unsafe_code)].
Estado Pre-Alpha (
v0.1.0): Megi ya es compilable y ejecutable como navegador de escritorio (megi) y pipeline CLI (render), con HTML5, CSS3 (Flexbox/Grid/Container Queries/Layers/bidi), JS (Boa 0.22 + ES modules +fetch), SVG/SMIL e imágenes (PNG/JPEG/GIF/WebP). Aún en fase Pre-Alpha: animaciones CSS@keyframes/transitionen runtime, shaping de scripts complejos (árabe/hebreo/tailandés/CJK) y aislamiento multiproceso por pestaña llegarán en la fase Alpha. El porcentaje del antiguo mapa de fases era un promedio de estimaciones y no indicaba si el navegador es usable. Ahora el titular escapacidades implementadas / conocidas, con evidencia verificable y la lista de pendientes encoverage.html(reglas enCOVERAGE.md). El aspecto real en webs se comprueba conreal_site_check.pyy se publica enreal-sites.html(capturas y avisos reales derender). Las métricas exactas se actualizan automáticamente enPROGRESS.md. Para consultar el historial de versiones, revisa elCHANGELOG.md.
Megi es pre-alpha y hay trabajo acotado para empezar hoy mismo:
- Issues
good first issue— cambios pequeños y verificables con un comando local. - Issues
help wanted— alcance algo mayor, con evidencia y repro incluidos. - Guía de contribución — convenciones, DCO, TDD y gates obligatorios.
- Prompt para agentes de IA — arranque rápido para Claude Code, Codex, OpenCode u otro harness.
- Web del proyecto — arquitectura, estado y hoja de ruta.
Si vas a trabajar en una issue, comenta en ella primero para evitar duplicados. Los cambios de seguridad se reportan en privado según SECURITY.md.
- Conformidad Estricta con Estándares:
- HTML5 100 %: Tokenizador (7.050/7.050), árbol DOM (3.904/3.904) y serializador (230/230) verificados contra
html5lib-tests. - CSS Syntax & Selectors: CSS Syntax WPT (30/30), Selectors L4 con poda por filtros Bloom de ancestros, Cascade Layers (
@layer) y Container Queries (@container). - Rendimiento y Ligereza:
- Arena DOM contigua con identificadores
NodeIdgeneracionales (4 bytes) y resolución de ciclo seguro. - Motor de rasterizado CPU optimizado y codificador/decodificador PNG propio con compresión adaptativa.
- Pipeline de render determinista de bajo consumo de memoria.
- Red y Protocolos Modernos (
crates/net): - Soporte completo HTTP/1.0/1.1 y HTTP/2 multiplexado con control de flujo por ventana y priorización de push.
- Cifrado seguro con TLS 1.2/1.3 en Rust puro (
rustls+webpki-roots). - Caché HTTP (RFC 9111), gestión de Cookies (RFC 6265), CORS, Referrer-Policy, Range y proxies HTTP/HTTPS/SOCKS5. PAC/WPAD es opt-in (feature
pacdenet, sin habilitar en los binarios publicados): sin ella se usan proxies directos/estáticos. - Ejecución de JavaScript (
crates/js): - Integración nativa con el motor ECMAScript Boa 0.22.
- Bindings completos para manipulación del DOM, eventos, temporizadores y Web Workers cooperativos.
- Shell de Escritorio Usable (
crates/browser): - Ventana interactiva nativa (X11/Wayland vía
winit), soporte para múltiples pestañas, zoom dinámico, historial navegable y modo screenshot headless para CI. Chrome oscuro con acento, pestañas redondeadas y barra tipo pill; el mismo binario sirve para X11 y Wayland.
Guía detallada: docs/GETTING-STARTED.md
- Rust: Edición 2024 (MSRV 1.91 o superior; lo exige
boa_engine0.22). - (Opcional para ventana gráfica): Servidor gráfico X11 o Wayland en Linux (ver dependencias en la guía).
# Abrir una URL o archivo HTML en el navegador gráfico
cargo run --release -p megi-browser -- https://example.com
# Modo headless: generar captura PNG de una página sin levantar servidor gráfico
cargo run --release -p megi-browser -- https://example.com --screenshot output.png --width 1024 --height 768# Ejecutar los tests del workspace
cargo test --workspace
# Ejecutar el gate oficial de conformidad (HTML5 + CSS)
cargo run --release -p megi-test-harness -- --summary
# Modo estricto de conformidad
cargo run --release -p megi-test-harness -- --summary --strict# Renderizar un documento HTML local a PNG mediante el pipeline de Fase 5
cargo run --release -p megi-render -- tests/fixtures/render/basic.html /tmp/render.png --width 800 --height 600El proyecto está diseñado como un Grafo Acíclico Dirigido (DAG) desacoplado en 17 crates especializados:
graph TD
render["crates/render (Pipeline Orquestador)"]
render --> html["crates/html (Parser WHATWG)"]
render --> css["crates/css (Syntax, Cascade & Layers)"]
render --> layout["crates/layout (BFC, IFC, Grid & Tables)"]
render --> display["crates/display (Contrato de Display List)"]
render --> raster["crates/raster (Rasterizador & PNG)"]
render --> paint["crates/paint (Construcción de Display List)"]
render --> net["crates/net (HTTP/2, TLS & Cache)"]
render --> js["crates/js (Boa Runtime & DOM Bindings)"]
render --> fonts["crates/fonts (Tipografía & WOFF2)"]
render --> image["crates/image (PNG, JPEG, GIF, WebP)"]
render --> svg["crates/svg (Parser & Rasterizer)"]
webview["crates/webview (API embebible)"] --> render
browser["crates/browser (UI & Ventana)"] --> webview
html --> dom["crates/core (Arena de Nodos)"]
layout --> dom
paint --> image
| Crate | Responsabilidad | Concurrencia / Seguridad |
|---|---|---|
crates/core |
Arena de nodos DOM contigua con NodeId generacional libre de ciclos. |
#![forbid(unsafe_code)] |
crates/html |
Tokenizador y árbol WHATWG HTML5 con conformidad 100%. | #![forbid(unsafe_code)] |
crates/css |
Parser CSS Syntax L3, Cascade Layers, Selectors L4 y Bloom pruning. | #![forbid(unsafe_code)] |
crates/layout |
Árbol de cajas, BFC, IFC, CSS Grid, Flexbox y Container Queries. | #![forbid(unsafe_code)] |
crates/display |
Contrato puro de DisplayList compartido por paint y raster. | #![forbid(unsafe_code)] |
crates/paint |
Construcción de DisplayList y orden de pintado CSS 2.2. | #![forbid(unsafe_code)] |
crates/raster |
Rasterizado 2D AA y codificación PNG determinista. | #![forbid(unsafe_code)] |
crates/webview |
API embebible sin ventana: load/frame/eventos/hit-test. | #![forbid(unsafe_code)] |
crates/image |
Decodificadores y codificador PNG, JPEG, GIF y WebP deterministas. | #![forbid(unsafe_code)] |
crates/fonts |
Shaping de texto, integración de fuentes del sistema y WOFF2. | #![forbid(unsafe_code)] |
crates/svg |
Parser XML de SVG y rasterizador vectorial analítico scanline. | #![forbid(unsafe_code)] |
crates/net |
Stack de red: URL WHATWG, HTTP/1.1, HTTP/2 multiplexado y TLS puro. | #![forbid(unsafe_code)] |
crates/js |
Motor JS ECMAScript basado en Boa, bindings DOM y Web Workers. | #![forbid(unsafe_code)] |
crates/render |
Orquestador del pipeline completo de renderizado web de extremo a extremo. | #![forbid(unsafe_code)] |
crates/browser |
Aplicación de escritorio nativa con pestañas, address bar y hotkeys. | #![forbid(unsafe_code)] |
crates/bench |
Arnés de benchmarks reproducibles para medir latencias del pipeline. | #![forbid(unsafe_code)] |
crates/test_harness |
Runner de verificación oficial frente a suites de conformidad WPT. | #![forbid(unsafe_code)] |
docs/ARCHITECTURE.md: Arquitectura detallada, modelo de memoria del DOM y política de dependencias.docs/SHOWCASE.md: Galería de capturas, fixtures y pruebas visuales de render.docs/ROADMAP.md: Plan de fases (WP-*) y estado del desarrollo a largo plazo.docs/PERFORMANCE.md: Metodología de benchmarks y mediciones de rendimiento.docs/FUZZING.md: Targets de fuzzing continuo y política de triaje de fallos.SECURITY.md: Modelo de seguridad de memoria, límites anti-DoS y políticas de reporte.CONTRIBUTING.md: Guía de contribución, convenciones de código y workflows de CI.docs/AI-QUICKSTART.md: Prompt pegable para empezar a trabajar en el repo con Claude Code, Codex, OpenCode u otro harness de IA.CHANGELOG.md: Registro histórico de versiones, hitos y optimizaciones por ronda.docs/MILESTONES.md: Histórico exhaustivo de micro-hitos, benchmarks y optimizaciones (rondas 1–32).
Para reportar vulnerabilidades, no abras un issue público. Usa un aviso de seguridad privado en GitHub o contacta al mantenedor:
- GitHub Security Advisories: Abrir aviso privado
- Política, severidad (CVSS 3.1) y plazos de divulgación: consulta
SECURITY.md
Megi se distribuye bajo doble licencia, a tu elección:
- Licencia MIT (
LICENSE-MIT) - Licencia Apache 2.0 (
LICENSE-APACHE)
(La fuente DejaVu Sans incluida en los recursos de pruebas conserva su propia licencia en crates/fonts/tests/fixtures/LICENSE-DejaVu.txt).