# shaun8149/sdf-js architecture

> Architecture diagram of the GitHub repository shaun8149/sdf-js, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shaun8149/sdf-js
- Repository: https://github.com/shaun8149/sdf-js

## Overview

Atlas is an LLM-native illustration and presentation platform built on sdf-js. Its clearest workflow turns a text prompt into a deck of scene descriptions, assembles those into a continuous 3D world, and displays it in an interactive renderer. A parallel presentation-authoring workflow maps slide content to scaffold slots, generates or edits 2D visuals, and exports decks. The graph retains the documented renderer, pattern, motif, and scene axes; several of these are represented at subsystem level because their runtime wiring was not excerpted.

Main entry points: [`sdf-js/apps/present/author-2d.js`](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/apps/present/author-2d.js) (Deck editor), [`sdf-js/apps/present/author.js`](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/apps/present/author.js) (Text author), [`sdf-js/src/present/scaffolds/lift-slot-llm.js`](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/present/scaffolds/lift-slot-llm.js) (Slot lift), [`sdf-js/src/icons/index.js`](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/icons/index.js) (Icon library)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Authoring"]
  node_prompt["Text author<br/>[author.js]"]
  node_editor["Deck editor<br/>[author-2d.js]"]
end

subgraph group_content["Content and mapping"]
  node_text_ir["Text to IR<br/>[text-to-ir.js]"]
  node_slide_ir["Slide mapper<br/>[slide-to-ir.js]"]
  node_scaffold_picker["Scaffold picker<br/>[picker-llm.js]"]
  node_scaffold_map["Slot mapper<br/>[mapper-llm.js]"]
  node_slot_lift["Slot lift<br/>[lift-slot-llm.js]"]
  node_lift_pipeline["Visual lift queue<br/>[pipeline.js]"]
  node_atoms2d["2D atom library<br/>[registry.js]"]
  node_icons["Icon library<br/>[index.js]"]
  node_icon_baked["Baked icons<br/>[baked-library.js]"]
  node_brand_icons["Brand icons<br/>[brand-icons.js]"]
  node_flag_icons["Flag icons<br/>[flag-icons.js]"]
  node_parser_pdf["PDF input parser<br/>[pdf.js]"]
end

subgraph group_scene["Scene construction"]
  node_assemble["Deck assembly<br/>[assemble-deck.js]"]
  node_scene_compile["Scene compiler<br/>[compile.js]"]
  node_scene_ir["Scene IR<br/>[ir.js]"]
  node_sdf_compile["SDF compiler<br/>[sdf3.compile.js]"]
end

subgraph group_render["Rendering"]
  node_figure["Interactive figure<br/>[figure-core.js]"]
  node_studio["Studio renderer<br/>[studio.js]"]
  node_renderer_pool["Renderer styles"]
  node_motifs["Motif presets<br/>[defaults.js]"]
end

subgraph group_presentation["Presentation output"]
  node_deck_model["Deck model<br/>[deck-model.js]"]
  node_deck_io["Deck serialization<br/>[deck-io.js]"]
  node_themes["Theme presets<br/>[themes.js]"]
  node_decor["Decoration library<br/>[registry.js]"]
  node_export_pdf["PDF export<br/>[pdf.js]"]
  node_export_pptx["PowerPoint export<br/>[pptx.js]"]
end

node_creator(("Creator"))
node_anthropic(("Anthropic API"))

node_creator -->|"enters prompt"| node_prompt
node_prompt -->|"submits text"| node_text_ir
node_prompt -->|"assembles deck"| node_assemble
node_prompt -->|"shows scene"| node_figure
node_prompt -->|"gets theme"| node_themes
node_prompt -.->|"optional mapping"| node_slide_ir
node_figure -->|"renders scene"| node_studio
node_studio -->|"compiles SDF"| node_sdf_compile
node_studio -.->|"selects renderer"| node_renderer_pool
node_creator -->|"opens editor"| node_editor
node_editor -.->|"requests visual lift"| node_lift_pipeline
node_lift_pipeline -->|"calls lift"| node_slot_lift
node_lift_pipeline -->|"updates status"| node_deck_model
node_slot_lift -->|"requests generation"| node_anthropic
node_slot_lift -->|"builds prompt catalog"| node_icons
node_slot_lift -->|"builds prompt catalog"| node_atoms2d
node_editor -->|"renders visuals"| node_atoms2d
node_editor -->|"serializes deck"| node_deck_io
node_editor -.->|"uses theme"| node_themes
node_editor -.->|"exports PDF"| node_export_pdf
node_editor -.->|"exports slides"| node_export_pptx
node_editor -.->|"chooses scaffold"| node_scaffold_picker
node_scaffold_picker -->|"requests choice"| node_anthropic
node_scaffold_picker -.->|"precedes mapping"| node_scaffold_map
node_scaffold_map -->|"requests assignments"| node_anthropic
node_scaffold_map -.->|"feeds slot lifts"| node_slot_lift
node_icons -->|"loads catalog"| node_icon_baked
node_icons -->|"loads catalog"| node_brand_icons
node_icons -->|"loads catalog"| node_flag_icons
node_atoms2d -->|"renderer imports"| node_decor
node_atoms2d -.->|"styled by"| node_themes
node_text_ir -->|"produces scene IR"| node_scene_ir
node_assemble -.->|"compiles scene"| node_scene_compile
node_assemble -.->|"consumes IR"| node_scene_ir
node_slide_ir -->|"creates IR"| node_scene_ir
node_renderer_pool -.->|"uses pattern presets"| node_motifs
node_creator -.->|"imports PDF"| node_parser_pdf

click node_prompt "https://github.com/shaun8149/sdf-js/blob/main/sdf-js/apps/present/author.js"
click node_editor "https://github.com/shaun8149/sdf-js/blob/main/sdf-js/apps/present/author-2d.js"
click node_text_ir "https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/scene/text-to-ir.js"
click node_slide_ir "https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/mapping/slide-to-ir.js"
click node_scaffold_picker "https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/present/scaffolds/picker-llm.js"
click node_scaffold_map "https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/present/scaffolds/mapper-llm.js"
click node_slot_lift "https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/present/scaffolds/lift-slot-llm.js"
click node_lift_pipeline "https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/present/pipeline.js"
click node_atoms2d "https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/present/atoms-2d/registry.js"
click node_deck_model "https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/present/deck-model.js"
click node_deck_io "https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/present/deck-io.js"
click node_themes "https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/present/themes.js"
click node_decor "https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/present/decor/registry.js"
click node_icons "https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/icons/index.js"
click node_icon_baked "https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/icons/baked-library.js"
click node_brand_icons "https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/icons/brand-icons.js"
click node_flag_icons "https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/icons/flag-icons.js"
click node_assemble "https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/scene/assemble-deck.js"
click node_scene_compile "https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/scene/compile.js"
click node_scene_ir "https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/scene/ir.js"
click node_sdf_compile "https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/sdf/sdf3.compile.js"
click node_figure "https://github.com/shaun8149/sdf-js/blob/main/sdf-js/apps/present/figure-core.js"
click node_studio "https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/render/studio.js"
click node_renderer_pool "https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/render/renderer-registry.js"
click node_export_pdf "https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/present/exporters/pdf.js"
click node_export_pptx "https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/present/exporters/pptx.js"
click node_parser_pdf "https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/parser/pdf.js"
click node_motifs "https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/motifs/defaults.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_prompt,node_editor toneBlue
class node_text_ir,node_slide_ir,node_scaffold_picker,node_scaffold_map,node_slot_lift,node_lift_pipeline,node_atoms2d,node_icons,node_icon_baked,node_brand_icons,node_flag_icons,node_parser_pdf toneAmber
class node_assemble,node_scene_compile,node_scene_ir,node_sdf_compile,node_anthropic toneMint
class node_figure,node_studio,node_renderer_pool,node_motifs toneRose
class node_deck_model,node_deck_io,node_themes,node_decor,node_export_pdf,node_export_pptx,node_creator toneIndigo
```

## Components

### Authoring

- [Text author](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/apps/present/author.js): `sdf-js/apps/present/author.js`
- [Deck editor](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/apps/present/author-2d.js): `sdf-js/apps/present/author-2d.js`

### Content and mapping

- [Text to IR](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/scene/text-to-ir.js): `sdf-js/src/scene/text-to-ir.js`
- [Slide mapper](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/mapping/slide-to-ir.js): `sdf-js/src/mapping/slide-to-ir.js`
- [Scaffold picker](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/present/scaffolds/picker-llm.js): `sdf-js/src/present/scaffolds/picker-llm.js`
- [Slot mapper](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/present/scaffolds/mapper-llm.js): `sdf-js/src/present/scaffolds/mapper-llm.js`
- [Slot lift](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/present/scaffolds/lift-slot-llm.js): `sdf-js/src/present/scaffolds/lift-slot-llm.js`
- [Visual lift queue](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/present/pipeline.js): `sdf-js/src/present/pipeline.js`
- [2D atom library](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/present/atoms-2d/registry.js): `sdf-js/src/present/atoms-2d/registry.js`
- [Icon library](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/icons/index.js): `sdf-js/src/icons/index.js`
- [Baked icons](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/icons/baked-library.js): `sdf-js/src/icons/baked-library.js`
- [Brand icons](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/icons/brand-icons.js): `sdf-js/src/icons/brand-icons.js`
- [Flag icons](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/icons/flag-icons.js): `sdf-js/src/icons/flag-icons.js`
- [PDF input parser](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/parser/pdf.js): `sdf-js/src/parser/pdf.js`

### Scene construction

- [Deck assembly](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/scene/assemble-deck.js): `sdf-js/src/scene/assemble-deck.js`
- [Scene compiler](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/scene/compile.js): `sdf-js/src/scene/compile.js`
- [Scene IR](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/scene/ir.js): `sdf-js/src/scene/ir.js`
- [SDF compiler](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/sdf/sdf3.compile.js): `sdf-js/src/sdf/sdf3.compile.js`

### Rendering

- [Interactive figure](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/apps/present/figure-core.js): `sdf-js/apps/present/figure-core.js`
- [Studio renderer](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/render/studio.js): `sdf-js/src/render/studio.js`
- [Renderer styles](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/render/renderer-registry.js): `sdf-js/src/render/renderer-registry.js`
- [Motif presets](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/motifs/defaults.js): `sdf-js/src/motifs/defaults.js`

### Presentation output

- [Deck model](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/present/deck-model.js): `sdf-js/src/present/deck-model.js`
- [Deck serialization](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/present/deck-io.js): `sdf-js/src/present/deck-io.js`
- [Theme presets](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/present/themes.js): `sdf-js/src/present/themes.js`
- [Decoration library](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/present/decor/registry.js): `sdf-js/src/present/decor/registry.js`
- [PDF export](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/present/exporters/pdf.js): `sdf-js/src/present/exporters/pdf.js`
- [PowerPoint export](https://github.com/shaun8149/sdf-js/blob/main/sdf-js/src/present/exporters/pptx.js): `sdf-js/src/present/exporters/pptx.js`

### Other components

- **Creator**
- **Anthropic API**

## Connections

- Creator → Text author: enters prompt (evidence: `sdf-js/apps/present/author.js`)
- Text author → Text to IR: submits text (evidence: `sdf-js/apps/present/author.js`)
- Text author → Deck assembly: assembles deck (evidence: `sdf-js/apps/present/author.js`)
- Text author → Interactive figure: shows scene (evidence: `sdf-js/apps/present/author.js`)
- Text author → Theme presets: gets theme (evidence: `sdf-js/apps/present/author.js`)
- Text author → Slide mapper: optional mapping
- Interactive figure → Studio renderer: renders scene (evidence: `sdf-js/apps/present/figure-core.js`)
- Studio renderer → SDF compiler: compiles SDF (evidence: `sdf-js/src/render/studio.js`)
- Studio renderer → Renderer styles: selects renderer
- Creator → Deck editor: opens editor (evidence: `sdf-js/apps/present/author-2d.js`)
- Deck editor → Visual lift queue: requests visual lift
- Visual lift queue → Slot lift: calls lift (evidence: `sdf-js/src/present/pipeline.js`)
- Visual lift queue → Deck model: updates status (evidence: `sdf-js/src/present/pipeline.js`)
- Slot lift → Anthropic API: requests generation (evidence: `sdf-js/src/present/scaffolds/lift-slot-llm.js`)
- Slot lift → Icon library: builds prompt catalog (evidence: `sdf-js/src/present/scaffolds/lift-slot-llm.js`)
- Slot lift → 2D atom library: builds prompt catalog (evidence: `sdf-js/src/present/scaffolds/lift-slot-llm.js`)
- Deck editor → 2D atom library: renders visuals (evidence: `sdf-js/apps/present/author-2d.js`)
- Deck editor → Deck serialization: serializes deck (evidence: `sdf-js/apps/present/author-2d.js`)
- Deck editor → Theme presets: uses theme (evidence: `sdf-js/apps/present/author-2d.js`)
- Deck editor → PDF export: exports PDF (evidence: `sdf-js/apps/present/author-2d.js`)
- Deck editor → PowerPoint export: exports slides (evidence: `sdf-js/apps/present/author-2d.js`)
- Deck editor → Scaffold picker: chooses scaffold
- Scaffold picker → Anthropic API: requests choice (evidence: `sdf-js/src/present/scaffolds/picker-llm.js`)
- Scaffold picker → Slot mapper: precedes mapping
- Slot mapper → Anthropic API: requests assignments (evidence: `sdf-js/src/present/scaffolds/mapper-llm.js`)
- Slot mapper → Slot lift: feeds slot lifts
- Icon library → Baked icons: loads catalog (evidence: `sdf-js/src/icons/index.js`)
- Icon library → Brand icons: loads catalog (evidence: `sdf-js/src/icons/index.js`)
- Icon library → Flag icons: loads catalog (evidence: `sdf-js/src/icons/index.js`)
- 2D atom library → Decoration library: renderer imports (evidence: `sdf-js/src/present/atoms-2d/renderer.js`)
- 2D atom library → Theme presets: styled by
- Text to IR → Scene IR: produces scene IR (evidence: `sdf-js/src/scene/text-to-ir.js`)
- Deck assembly → Scene compiler: compiles scene
- Deck assembly → Scene IR: consumes IR
- Slide mapper → Scene IR: creates IR (evidence: `sdf-js/src/mapping/slide-to-ir.js`)
- Renderer styles → Motif presets: uses pattern presets
- Creator → PDF input parser: imports PDF
