للمطورين

الخرائط كمخرجات منظمة.

أنشئ وعدّل مستند DSL بشكل حتمي، ثم صدّره إلى PNG أو SVG. عبر HTTP أو MCP أو CLI — لدمجه في خطوط أنابيبك ووكلائك.

مثال · 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

التعديل الحتمي

عشر عمليات مكتوبة على المستند.

التعديلات عمليات على AST، وليست إعادة توليد — لا انحدارات، والتعديلات اليدوية تبقى.

create_layermodify_layerdelete_layeradd_memberremove_membermodify_arrowmodify_annotationchange_viewapply_classset_disambiguation

حتمي: نفس المستند → نفس الخريطة، بدقة البكسل. الجغرافيا عبر الإنترنت مأخوذة كلقطة.
مدقق: كل مستند يتم التحقق منه مقابل JSON Schema لصيغة V1.
المخرجات: PNG و SVG (مع <g> لكل طبقة) و PDF و JPG. SVG قابل للتعديل لاحقاً.
محرك واحد: API و MCP و CLI هي أغلفة رقيقة على نفس خط أنابيب العرض.

الأبواب الأخرى

Iللمبتدئين→IIIاللغة→