Docs

FileFig returns a deterministic ProjectMap: blocks (structure) + edges (best-effort calls). Rendering is planned and will be live soon.

API

POST /extract/file

// Request
{
  "language": "ts" | "js" | "py",
  "path": "example.ts",
  "content": "...file text...",
  "includeSnippets": false
}

// Response
{
  "projectMap": {
    "version": "0.1.0",
    "generatedAt": "ISO-8601 timestamp",
    "root": "filefig://single-file",
    "blocks": [],
    "edges": [],
    "files": ["example.ts"]
  }
}

Notes: path is treated as a label (for safety). The API currently supports single-file extraction.

Errors

• 400 Invalid request (bad JSON / missing fields / language mismatch)
• 413 File too large for Free tier
• 500 Extraction failed (unexpected error)

Free tier features

• Single file only
• Languages: JS / TS / Python
• Edges: best-effort call graph
• No LLM integration (engine is deterministic)

Roadmap

• Plus: FileFig Viewer + export formats (SVG/PNG/PDF/ASCII) + more languages.
• Pro: Multi-file support, integrated advanced explainations, and predictive structure generation.
• OSS goal: ProjectMap Annotation Tool