Per sviluppatori
La cartografia come output strutturato.
Genera e modifica il documento DSL in modo deterministico, poi renderizza in PNG o SVG. Via HTTP, MCP o CLI — per integrarli nelle tue pipeline e nei tuoi agenti.
Apri lo Studio →example · MCP
> validate_gesta_map(doc)
{ "valid": true, "errors": [] }
> render_gesta_map(doc, format="svg")
{ "image_base64": "PD94…",
"mime": "image/svg+xml" }Tre superfici, un motore.
HTTP API
Endpoint 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
Strumenti per agenti
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
Riga di 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
Modifica deterministica
Dieci operazioni tipizzate sul documento.
Le modifiche sono operazioni sull'AST, non rigenerazioni — nessuna regressione, e le modifiche manuali sopravvivono.
create_layermodify_layerdelete_layeradd_memberremove_membermodify_arrowmodify_annotationchange_viewapply_classset_disambiguation
- Deterministico
- Stesso documento → stessa mappa, al pixel. La geocodifica online è catturata.
- Validato
- Ogni documento è verificato rispetto al JSON Schema del formato V1.
- Output
- PNG, SVG (con un <g> per layer), PDF, JPG. SVG modificabile a valle.
- Un motore
- API, MCP e CLI sono wrapper sottili sulla stessa pipeline di rendering.
Gli altri ingressi