Para desenvolvedores
Cartografia como saída estruturada.
Gere e edite o documento DSL deterministicamente, depois renderize para PNG ou SVG. Via HTTP, MCP ou CLI — para integrar em seus pipelines e agentes.
Abrir o Studio →exemplo · MCP
> validate_gesta_map(doc)
{ "valid": true, "errors": [] }
> render_gesta_map(doc, format="svg")
{ "image_base64": "PD94…",
"mime": "image/svg+xml" }Três superfícies, um motor.
HTTP API
Endpoints REST
POST /api/generate → DSL + PNG/SVG POST /api/edit → typed ops POST /api/apply-ops → deterministic patch POST /api/rerender → re-render POST /api/render-svg → SVG, id-tagged layers POST /api/geocode → names → coordinates
MCP
Ferramentas para agentes
render_gesta_map(doc, format, dpi)
validate_gesta_map(doc) → {valid, errors}
extract_draft_from_prose(prose)
how_to(feature) → self-explain
engine_version()CLI
Linha de comando
$ gesta validate map.gesta.yaml $ gesta render map.gesta.yaml -o out.svg $ gesta geocode map.gesta.yaml --apply $ gesta resolve map.gesta.yaml $ gesta-serve # HTTP · gesta-mcp
Edição determinística
Dez operações tipadas no documento.
Edições são operações na AST, não regenerações — sem regressões, e edições manuais persistem.
create_layermodify_layerdelete_layeradd_memberremove_membermodify_arrowmodify_annotationchange_viewapply_classset_disambiguation
- Determinístico
- Mesmo documento → mesmo mapa, ao pixel. Geocodificação online é capturada.
- Validado
- Todo documento é verificado contra o JSON Schema do formato V1.
- Saída
- PNG, SVG (com um <g> por camada), PDF, JPG. SVG editável a jusante.
- Um motor
- API, MCP e CLI são wrappers finos sobre o mesmo pipeline de renderização.
As outras portas