# sourcemeta/jsontoolkit architecture

> Architecture diagram of the GitHub repository sourcemeta/jsontoolkit, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sourcemeta/jsontoolkit
- Repository: https://github.com/sourcemeta/jsontoolkit

## Overview

##### Main Components Identification
The system should be divided into these core modules, based on the src/ directory structure:

- JSON Core Module (src/json)
- JSONL Module (src/jsonl)
- JSON Pointer Module (src/jsonpointer)
- JSON Schema Module (src/jsonschema)
- URI Module (src/uri)
- Regex Module (src/regex)

##### Component Details

For each component, include:

**JSON Core Module:**
- Parser
- Value Types (Object, Array, etc.)
- Serialization
- Error Handling

**JSONL Module:**
- Iterator Implementation
- Streaming Capabilities

**JSON Pointer Module:**
- Pointer Resolution
- Document Navigation
- Position Tracking

**JSON Schema Module:**
- Validation Engine
- Schema Bundling
- Reference Resolution
- Dialect Support

**URI Module:**
- URI Parsing
- Normalization
- Resolution

**Regex Module:**
- Pattern Matching
- Regex Operations

##### Technical Details

Annotations for:
- C++ Standard Library dependencies
- Header-only vs. Compiled components
- Public API entry points
- Test coverage relationships

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Style definitions
    classDef core fill:#b3d1ff,stroke:#333,stroke-width:2px
    classDef feature fill:#90EE90,stroke:#333,stroke-width:2px
    classDef schema fill:#FFD700,stroke:#333,stroke-width:2px
    classDef utility fill:#D3D3D3,stroke:#333,stroke-width:2px
    classDef test fill:#FFC0CB,stroke:#333,stroke-width:1px
    
    subgraph Core["Core Layer"]
        JSON["JSON Core Module"]:::core
        JSON_Types["Value Types"]:::core
        JSON_Parser["Parser & Serialization"]:::core
        JSON_Error["Error Handling"]:::core
        
        URI["URI Module"]:::utility
        REGEX["Regex Module"]:::utility
        
        JSON --- JSON_Types
        JSON --- JSON_Parser
        JSON --- JSON_Error
    end
    
    subgraph Feature["Feature Layer"]
        JSONL["JSONL Module"]:::feature
        JSONL_Iterator["Iterator Implementation"]:::feature
        
        JSONPointer["JSON Pointer Module"]:::feature
        JSONPointer_Position["Position Tracking"]:::feature
        JSONPointer_Walker["Walker Implementation"]:::feature
        
        JSONL --- JSONL_Iterator
        JSONPointer --- JSONPointer_Position
        JSONPointer --- JSONPointer_Walker
    end
    
    subgraph Schema["Schema Layer"]
        JSONSchema["JSON Schema Module"]:::schema
        Schema_Bundle["Schema Bundling"]:::schema
        Schema_Resolver["Reference Resolution"]:::schema
        Schema_Validation["Validation Engine"]:::schema
        
        JSONSchema --- Schema_Bundle
        JSONSchema --- Schema_Resolver
        JSONSchema --- Schema_Validation
    end
    
    %% Dependencies
    JSONL --> JSON
    JSONPointer --> JSON
    JSONSchema --> JSON
    JSONSchema --> URI
    JSONSchema --> REGEX
    Schema_Resolver --> URI
    
    %% Click events
    click JSON "https://github.com/sourcemeta/jsontoolkit/tree/main/src/json/"
    click JSON_Types "https://github.com/sourcemeta/jsontoolkit/blob/main/src/json/include/sourcemeta/jsontoolkit/json_value.h"
    click JSON_Error "https://github.com/sourcemeta/jsontoolkit/blob/main/src/json/include/sourcemeta/jsontoolkit/json_error.h"
    click JSONL "https://github.com/sourcemeta/jsontoolkit/tree/main/src/jsonl/"
    click JSONL_Iterator "https://github.com/sourcemeta/jsontoolkit/blob/main/src/jsonl/include/sourcemeta/jsontoolkit/jsonl_iterator.h"
    click JSONPointer "https://github.com/sourcemeta/jsontoolkit/tree/main/src/jsonpointer/"
    click JSONPointer_Position "https://github.com/sourcemeta/jsontoolkit/blob/main/src/jsonpointer/include/sourcemeta/jsontoolkit/jsonpointer_position.h"
    click JSONPointer_Walker "https://github.com/sourcemeta/jsontoolkit/blob/main/src/jsonpointer/include/sourcemeta/jsontoolkit/jsonpointer_walker.h"
    click JSONSchema "https://github.com/sourcemeta/jsontoolkit/tree/main/src/jsonschema/"
    click Schema_Bundle "https://github.com/sourcemeta/jsontoolkit/blob/main/src/jsonschema/include/sourcemeta/jsontoolkit/jsonschema_bundle.h"
    click Schema_Resolver "https://github.com/sourcemeta/jsontoolkit/blob/main/src/jsonschema/include/sourcemeta/jsontoolkit/jsonschema_resolver.h"
    click Schema_Validation "https://github.com/sourcemeta/jsontoolkit/blob/main/src/jsonschema/include/sourcemeta/jsontoolkit/jsonschema_walker.h"
    click URI "https://github.com/sourcemeta/jsontoolkit/tree/main/src/uri/"
    click REGEX "https://github.com/sourcemeta/jsontoolkit/tree/main/src/regex/"
    
    %% Legend
    subgraph Legend
        L1["Core Components"]:::core
        L2["Feature Modules"]:::feature
        L3["Schema Components"]:::schema
        L4["Utility Modules"]:::utility
    end
```
