# adlerzz/fina-lapo architecture

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

- Interactive diagram: https://gitdiagram.com/adlerzz/fina-lapo
- Repository: https://github.com/adlerzz/fina-lapo

## Overview

This is a command-line PSD layer-name transliterator: it reads a PSD, finds layer names, transliterates and disambiguates them, adjusts affected lengths and offsets, then saves a modified file. The graph shows the orchestration separately from binary mapping and encoding helpers. Evidence is limited to the provided source excerpts and index; no README description was available.

Main entry points: [`src/main_flow.py`](https://github.com/adlerzz/fina-lapo/blob/master/src/main_flow.py) (ActionComposer), [`src/Mapper.py`](https://github.com/adlerzz/fina-lapo/blob/master/src/Mapper.py) (File Mapper), [`src/Pointer.py`](https://github.com/adlerzz/fina-lapo/blob/master/src/Pointer.py) (Read Pointer), [`src/utils.py`](https://github.com/adlerzz/fina-lapo/blob/master/src/utils.py) (Binary Utilities)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["PSD workflow"]
  node_composer["ActionComposer<br/>[main_flow.py]"]
  node_reader["PSD Reader<br/>[main_flow.py]"]
end

subgraph group_binary["Binary handling"]
  node_mapper["File Mapper<br/>[Mapper.py]"]
  node_pointer["Read Pointer<br/>[Pointer.py]"]
  node_writepointer["Write Pointer<br/>[WritePointer.py]"]
  node_utils["Binary Utilities<br/>[utils.py]"]
end

subgraph group_text["Name encoding"]
  node_codec["Name Codec<br/>[codec.py]"]
end

node_cli(("CLI user"))
node_input["PSD input"]
node_output["PSD output"]

node_cli -->|"provides arguments"| node_composer
node_input -->|"supplies file"| node_composer
node_composer -->|"opens input"| node_mapper
node_composer -->|"parses sections"| node_reader
node_reader -->|"reads bytes"| node_mapper
node_composer -->|"transliterates names"| node_codec
node_composer -->|"counts and encodes"| node_utils
node_composer -->|"builds edits"| node_writepointer
node_composer -->|"writes edits"| node_mapper
node_mapper -->|"saves file"| node_output
node_mapper -->|"creates pointers"| node_pointer
node_pointer -->|"decodes values"| node_codec
node_pointer -->|"formats values"| node_utils
node_mapper -->|"converts bytes"| node_utils
node_mapper -->|"uses byte order"| node_codec

click node_composer "https://github.com/adlerzz/fina-lapo/blob/master/src/main_flow.py"
click node_reader "https://github.com/adlerzz/fina-lapo/blob/master/src/main_flow.py"
click node_mapper "https://github.com/adlerzz/fina-lapo/blob/master/src/Mapper.py"
click node_pointer "https://github.com/adlerzz/fina-lapo/blob/master/src/Pointer.py"
click node_writepointer "https://github.com/adlerzz/fina-lapo/blob/master/src/WritePointer.py"
click node_codec "https://github.com/adlerzz/fina-lapo/blob/master/src/codec.py"
click node_utils "https://github.com/adlerzz/fina-lapo/blob/master/src/utils.py"

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_composer,node_reader,node_cli toneBlue
class node_mapper,node_pointer,node_writepointer,node_utils toneAmber
class node_codec toneMint
class node_input,node_output toneIndigo
```

## Components

### PSD workflow

- [ActionComposer](https://github.com/adlerzz/fina-lapo/blob/master/src/main_flow.py): `src/main_flow.py`
- [PSD Reader](https://github.com/adlerzz/fina-lapo/blob/master/src/main_flow.py): `src/main_flow.py`

### Binary handling

- [File Mapper](https://github.com/adlerzz/fina-lapo/blob/master/src/Mapper.py): `src/Mapper.py`
- [Read Pointer](https://github.com/adlerzz/fina-lapo/blob/master/src/Pointer.py): `src/Pointer.py`
- [Write Pointer](https://github.com/adlerzz/fina-lapo/blob/master/src/WritePointer.py): `src/WritePointer.py`
- [Binary Utilities](https://github.com/adlerzz/fina-lapo/blob/master/src/utils.py): `src/utils.py`

### Name encoding

- [Name Codec](https://github.com/adlerzz/fina-lapo/blob/master/src/codec.py): `src/codec.py`

### Other components

- **CLI user**
- **PSD input**
- **PSD output**

## Connections

- CLI user → ActionComposer: provides arguments (evidence: `src/main_flow.py`)
- PSD input → ActionComposer: supplies file (evidence: `src/main_flow.py`)
- ActionComposer → File Mapper: opens input (evidence: `src/main_flow.py`)
- ActionComposer → PSD Reader: parses sections (evidence: `src/main_flow.py`)
- PSD Reader → File Mapper: reads bytes (evidence: `src/main_flow.py`)
- ActionComposer → Name Codec: transliterates names (evidence: `src/main_flow.py`)
- ActionComposer → Binary Utilities: counts and encodes (evidence: `src/main_flow.py`)
- ActionComposer → Write Pointer: builds edits (evidence: `src/main_flow.py`)
- ActionComposer → File Mapper: writes edits (evidence: `src/main_flow.py`)
- File Mapper → PSD output: saves file (evidence: `src/Mapper.py`)
- File Mapper → Read Pointer: creates pointers (evidence: `src/Mapper.py`)
- Read Pointer → Name Codec: decodes values (evidence: `src/Pointer.py`)
- Read Pointer → Binary Utilities: formats values (evidence: `src/Pointer.py`)
- File Mapper → Binary Utilities: converts bytes (evidence: `src/Mapper.py`)
- File Mapper → Name Codec: uses byte order (evidence: `src/Mapper.py`)
