# remiscan/colori architecture

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

- Interactive diagram: https://gitdiagram.com/remiscan/colori
- Repository: https://github.com/remiscan/colori

## Overview

colori is a JavaScript/TypeScript and PHP color-manipulation library. A user constructs a Couleur value from a CSS color string or named color, then uses the API to convert, format, blend, inspect contrast or distance, clamp, or generate gradients. The main class coordinates parsing and color-space conversion with separate analysis and graph modules. Both language implementations are represented; the README documents the product capabilities, while some internal PHP relationships and unsampled feature implementations are supported only by the source index, so uncertain links are omitted.

Main entry points: [`src/ts/couleur.ts`](https://github.com/remiscan/colori/blob/main/src/ts/couleur.ts) (TypeScript Couleur), [`src/php/couleur.php`](https://github.com/remiscan/colori/blob/main/src/php/couleur.php) (PHP Couleur), [`src/ts/conversion.ts`](https://github.com/remiscan/colori/blob/main/src/ts/conversion.ts) (Conversions), [`src/php/conversion.php`](https://github.com/remiscan/colori/blob/main/src/php/conversion.php) (Conversions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Color API"]
  node_ts_entry["TypeScript Entry<br/>[main.ts]"]
  node_ts_color["TypeScript Couleur<br/>[couleur.ts]"]
  node_php_entry["PHP Entry<br/>[main.php]"]
  node_php_color["PHP Couleur<br/>[couleur.php]"]
end

subgraph group_conversion["Color Conversion"]
  node_ts_conversion["Conversions<br/>[conversion.ts]"]
  node_php_conversion["Conversions<br/>[conversion.php]"]
  node_ts_w3["W3 Conversions<br/>[w3-conversion.ts]"]
  node_php_w3["W3 Conversions<br/>[w3-conversion.php]"]
  node_ts_okhsl["OKHSL/OKHSV"]
  node_php_okhsl["OKHSL/OKHSV"]
  node_ts_graph["Conversion Graph<br/>[graph.ts]"]
  node_php_graph["Conversion Graph<br/>[graph.php]"]
end

subgraph group_analysis["Color Analysis"]
  node_ts_contrasts["Contrast<br/>[contrasts.ts]"]
  node_php_contrasts["Contrast<br/>[contrasts.php]"]
  node_ts_apca["APCA Contrast<br/>[apca-contrast.ts]"]
  node_php_apca["APCA Contrast<br/>[apca-contrast.php]"]
  node_ts_distances["Color Distance<br/>[distances.ts]"]
  node_php_distances["Color Distance<br/>[distances.php]"]
end

subgraph group_data["Color Data"]
  node_ts_formats["CSS Formats<br/>[css-formats.ts]"]
  node_php_formats["CSS Formats<br/>[css-formats.php]"]
  node_ts_spaces["Color Spaces<br/>[color-spaces.ts]"]
  node_php_spaces["Color Spaces<br/>[color-spaces.php]"]
  node_ts_names["Named Colors<br/>[named-colors.ts]"]
  node_php_names["Named Colors<br/>[named-colors.php]"]
end

node_user(("Library User"))

node_user -->|"imports"| node_ts_entry
node_user -->|"includes"| node_php_entry
node_ts_entry -->|"exports"| node_ts_color
node_php_entry -->|"requires"| node_php_color
node_ts_color -->|"uses"| node_ts_formats
node_ts_color -->|"uses"| node_ts_spaces
node_ts_color -->|"uses"| node_ts_names
node_ts_color -->|"converts with"| node_ts_conversion
node_ts_color -->|"computes"| node_ts_contrasts
node_ts_color -->|"computes"| node_ts_distances
node_ts_color -->|"uses"| node_ts_graph
node_php_color -->|"uses"| node_php_formats
node_php_color -->|"uses"| node_php_spaces
node_php_color -->|"uses"| node_php_names
node_php_color -->|"converts with"| node_php_conversion
node_php_color -->|"computes"| node_php_contrasts
node_php_color -->|"computes"| node_php_distances
node_php_color -->|"uses"| node_php_graph
node_ts_conversion -->|"uses"| node_ts_w3
node_ts_conversion -->|"uses"| node_ts_okhsl
node_php_conversion -->|"loads"| node_php_w3
node_php_conversion -->|"loads"| node_php_okhsl
node_ts_okhsl -->|"calls"| node_ts_w3
node_php_okhsl -->|"loads"| node_php_w3
node_ts_contrasts -->|"uses"| node_ts_conversion
node_ts_contrasts -->|"exports"| node_ts_apca
node_php_contrasts -->|"uses"| node_php_conversion
node_php_contrasts -->|"uses"| node_php_apca

click node_ts_entry "https://github.com/remiscan/colori/blob/main/src/ts/main.ts"
click node_ts_color "https://github.com/remiscan/colori/blob/main/src/ts/couleur.ts"
click node_php_entry "https://github.com/remiscan/colori/blob/main/src/php/main.php"
click node_php_color "https://github.com/remiscan/colori/blob/main/src/php/couleur.php"
click node_ts_formats "https://github.com/remiscan/colori/blob/main/src/ts/css-formats.ts"
click node_php_formats "https://github.com/remiscan/colori/blob/main/src/php/css-formats.php"
click node_ts_spaces "https://github.com/remiscan/colori/blob/main/src/ts/color-spaces.ts"
click node_php_spaces "https://github.com/remiscan/colori/blob/main/src/php/color-spaces.php"
click node_ts_names "https://github.com/remiscan/colori/blob/main/src/ts/named-colors.ts"
click node_php_names "https://github.com/remiscan/colori/blob/main/src/php/named-colors.php"
click node_ts_conversion "https://github.com/remiscan/colori/blob/main/src/ts/conversion.ts"
click node_php_conversion "https://github.com/remiscan/colori/blob/main/src/php/conversion.php"
click node_ts_w3 "https://github.com/remiscan/colori/blob/main/src/ts/ext/w3-conversion.ts"
click node_php_w3 "https://github.com/remiscan/colori/blob/main/src/php/ext/w3-conversion.php"
click node_ts_okhsl "https://github.com/remiscan/colori/blob/main/src/ts/ext/okhsl-okhsv-conversion.ts"
click node_php_okhsl "https://github.com/remiscan/colori/blob/main/src/php/ext/okhsl-okhsv-conversion.php"
click node_ts_contrasts "https://github.com/remiscan/colori/blob/main/src/ts/contrasts.ts"
click node_php_contrasts "https://github.com/remiscan/colori/blob/main/src/php/contrasts.php"
click node_ts_apca "https://github.com/remiscan/colori/blob/main/src/ts/ext/apca-contrast.ts"
click node_php_apca "https://github.com/remiscan/colori/blob/main/src/php/ext/apca-contrast.php"
click node_ts_distances "https://github.com/remiscan/colori/blob/main/src/ts/distances.ts"
click node_php_distances "https://github.com/remiscan/colori/blob/main/src/php/distances.php"
click node_ts_graph "https://github.com/remiscan/colori/blob/main/src/ts/graph.ts"
click node_php_graph "https://github.com/remiscan/colori/blob/main/src/php/graph.php"

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_ts_entry,node_ts_color,node_php_entry,node_php_color,node_user toneBlue
class node_ts_conversion,node_php_conversion,node_ts_w3,node_php_w3,node_ts_okhsl,node_php_okhsl,node_ts_graph,node_php_graph toneAmber
class node_ts_contrasts,node_php_contrasts,node_ts_apca,node_php_apca,node_ts_distances,node_php_distances toneMint
class node_ts_formats,node_php_formats,node_ts_spaces,node_php_spaces,node_ts_names,node_php_names toneRose
```

## Components

### Color API

- [TypeScript Entry](https://github.com/remiscan/colori/blob/main/src/ts/main.ts): `src/ts/main.ts`
- [TypeScript Couleur](https://github.com/remiscan/colori/blob/main/src/ts/couleur.ts): `src/ts/couleur.ts`
- [PHP Entry](https://github.com/remiscan/colori/blob/main/src/php/main.php): `src/php/main.php`
- [PHP Couleur](https://github.com/remiscan/colori/blob/main/src/php/couleur.php): `src/php/couleur.php`

### Color Conversion

- [Conversions](https://github.com/remiscan/colori/blob/main/src/ts/conversion.ts): `src/ts/conversion.ts`
- [Conversions](https://github.com/remiscan/colori/blob/main/src/php/conversion.php): `src/php/conversion.php`
- [W3 Conversions](https://github.com/remiscan/colori/blob/main/src/ts/ext/w3-conversion.ts): `src/ts/ext/w3-conversion.ts`
- [W3 Conversions](https://github.com/remiscan/colori/blob/main/src/php/ext/w3-conversion.php): `src/php/ext/w3-conversion.php`
- [OKHSL/OKHSV](https://github.com/remiscan/colori/blob/main/src/ts/ext/okhsl-okhsv-conversion.ts): `src/ts/ext/okhsl-okhsv-conversion.ts`
- [OKHSL/OKHSV](https://github.com/remiscan/colori/blob/main/src/php/ext/okhsl-okhsv-conversion.php): `src/php/ext/okhsl-okhsv-conversion.php`
- [Conversion Graph](https://github.com/remiscan/colori/blob/main/src/ts/graph.ts): `src/ts/graph.ts`
- [Conversion Graph](https://github.com/remiscan/colori/blob/main/src/php/graph.php): `src/php/graph.php`

### Color Analysis

- [Contrast](https://github.com/remiscan/colori/blob/main/src/ts/contrasts.ts): `src/ts/contrasts.ts`
- [Contrast](https://github.com/remiscan/colori/blob/main/src/php/contrasts.php): `src/php/contrasts.php`
- [APCA Contrast](https://github.com/remiscan/colori/blob/main/src/ts/ext/apca-contrast.ts): `src/ts/ext/apca-contrast.ts`
- [APCA Contrast](https://github.com/remiscan/colori/blob/main/src/php/ext/apca-contrast.php): `src/php/ext/apca-contrast.php`
- [Color Distance](https://github.com/remiscan/colori/blob/main/src/ts/distances.ts): `src/ts/distances.ts`
- [Color Distance](https://github.com/remiscan/colori/blob/main/src/php/distances.php): `src/php/distances.php`

### Color Data

- [CSS Formats](https://github.com/remiscan/colori/blob/main/src/ts/css-formats.ts): `src/ts/css-formats.ts`
- [CSS Formats](https://github.com/remiscan/colori/blob/main/src/php/css-formats.php): `src/php/css-formats.php`
- [Color Spaces](https://github.com/remiscan/colori/blob/main/src/ts/color-spaces.ts): `src/ts/color-spaces.ts`
- [Color Spaces](https://github.com/remiscan/colori/blob/main/src/php/color-spaces.php): `src/php/color-spaces.php`
- [Named Colors](https://github.com/remiscan/colori/blob/main/src/ts/named-colors.ts): `src/ts/named-colors.ts`
- [Named Colors](https://github.com/remiscan/colori/blob/main/src/php/named-colors.php): `src/php/named-colors.php`

### Other components

- **Library User**

## Connections

- Library User → TypeScript Entry: imports (evidence: `README.md`)
- Library User → PHP Entry: includes (evidence: `README.md`)
- TypeScript Entry → TypeScript Couleur: exports (evidence: `src/ts/main.ts`)
- PHP Entry → PHP Couleur: requires (evidence: `src/php/main.php`)
- TypeScript Couleur → CSS Formats: uses (evidence: `src/ts/couleur.ts`)
- TypeScript Couleur → Color Spaces: uses (evidence: `src/ts/couleur.ts`)
- TypeScript Couleur → Named Colors: uses (evidence: `src/ts/couleur.ts`)
- TypeScript Couleur → Conversions: converts with (evidence: `src/ts/couleur.ts`)
- TypeScript Couleur → Contrast: computes (evidence: `src/ts/couleur.ts`)
- TypeScript Couleur → Color Distance: computes (evidence: `src/ts/couleur.ts`)
- TypeScript Couleur → Conversion Graph: uses (evidence: `src/ts/couleur.ts`)
- PHP Couleur → CSS Formats: uses (evidence: `src/php/couleur.php`)
- PHP Couleur → Color Spaces: uses (evidence: `src/php/couleur.php`)
- PHP Couleur → Named Colors: uses (evidence: `src/php/couleur.php`)
- PHP Couleur → Conversions: converts with (evidence: `src/php/couleur.php`)
- PHP Couleur → Contrast: computes (evidence: `src/php/couleur.php`)
- PHP Couleur → Color Distance: computes (evidence: `src/php/couleur.php`)
- PHP Couleur → Conversion Graph: uses (evidence: `src/php/couleur.php`)
- Conversions → W3 Conversions: uses (evidence: `src/ts/conversion.ts`)
- Conversions → OKHSL/OKHSV: uses (evidence: `src/ts/conversion.ts`)
- Conversions → W3 Conversions: loads (evidence: `src/php/conversion.php`)
- Conversions → OKHSL/OKHSV: loads (evidence: `src/php/conversion.php`)
- OKHSL/OKHSV → W3 Conversions: calls (evidence: `src/ts/ext/okhsl-okhsv-conversion.ts`)
- OKHSL/OKHSV → W3 Conversions: loads (evidence: `src/php/ext/okhsl-okhsv-conversion.php`)
- Contrast → Conversions: uses (evidence: `src/ts/contrasts.ts`)
- Contrast → APCA Contrast: exports (evidence: `src/ts/contrasts.ts`)
- Contrast → Conversions: uses (evidence: `src/php/contrasts.php`)
- Contrast → APCA Contrast: uses (evidence: `src/php/contrasts.php`)
