개발자를 위해
구조화된 출력으로서의 지도 제작.
DSL 문서를 결정론적으로 생성하고 편집한 후 PNG 또는 SVG로 렌더링하세요. HTTP, MCP, 또는 CLI를 통해 파이프라인과 에이전트에 통합할 수 있습니다.
스튜디오 열기 →example · MCP
> validate_gesta_map(doc)
{ "valid": true, "errors": [] }
> render_gesta_map(doc, format="svg")
{ "image_base64": "PD94…",
"mime": "image/svg+xml" }세 가지 인터페이스, 하나의 엔진.
HTTP API
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
에이전트용 도구
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
커맨드 라인
$ 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
결정론적 편집
문서에 대한 10가지 타입 지정 작업.
편집은 AST에 대한 작업이지 재생성이 아니므로 회귀가 없고 수동 편집이 유지됩니다.
create_layermodify_layerdelete_layeradd_memberremove_membermodify_arrowmodify_annotationchange_viewapply_classset_disambiguation
- 결정론적
- 동일한 문서 → 픽셀 단위로 동일한 지도. 온라인 지오코딩은 스냅샷됩니다.
- 검증됨
- 모든 문서는 V1 형식의 JSON Schema에 대해 검증됩니다.
- 출력
- PNG, SVG (레이어당 <g>), PDF, JPG. SVG는 다운스트림에서 편집 가능합니다.
- 하나의 엔진
- API, MCP, CLI는 동일한 렌더 파이프라인의 얇은 래퍼입니다.