# amoxicillinmediatek/lexify architecture

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

- Interactive diagram: https://gitdiagram.com/amoxicillinmediatek/lexify
- Repository: https://github.com/amoxicillinmediatek/lexify

## Overview

Lexify is a Rust Lua source obfuscator, exposed as a CLI and a browser demo. The principal workflow validates Lua, tokenizes it, applies configured transformations, formats the result, and returns or emits the transformed source. The graph preserves the documented transformation families and the browser/WASM branch. Some pass wiring is supported by the lib.rs source-index references rather than a complete excerpt; the web README’s CLI description and the sampled UI’s WASM loader differ, so the browser path follows the sampled implementation.

Main entry points: [`src/lib.rs`](https://github.com/amoxicillinmediatek/lexify/blob/main/src/lib.rs) (Obfuscation pipeline), [`src/main.rs`](https://github.com/amoxicillinmediatek/lexify/blob/main/src/main.rs) (Rust CLI), [`web/app/ui/Obfuscator.tsx`](https://github.com/amoxicillinmediatek/lexify/blob/main/web/app/ui/Obfuscator.tsx) (Web playground), [`src/parser.rs`](https://github.com/amoxicillinmediatek/lexify/blob/main/src/parser.rs) (Lua validation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User Interfaces"]
  node_cli["Rust CLI<br/>[main.rs]"]
  node_webui["Web playground<br/>[Obfuscator.tsx]"]
  node_wasm["WASM bridge<br/>[lib.rs]"]
end

subgraph group_core["Obfuscation Core"]
  node_config["Pass options<br/>[config.rs]"]
  node_pipeline["Obfuscation pipeline<br/>[lib.rs]"]
  node_parser["Lua validation<br/>[parser.rs]"]
  node_lexer["Token scanner<br/>[lexer.rs]"]
end

subgraph group_transforms["Transformation Passes"]
  node_renamer["Local renaming<br/>[renamer.rs]"]
  node_strings["String encoding<br/>[string_encrypt.rs]"]
  node_splitter["String splitting<br/>[string_splitter.rs]"]
  node_numbers["Number obfuscation"]
  node_booleans["Boolean obfuscation"]
  node_tables["Table obfuscation"]
  node_control["Condition normalization<br/>[control_flow.rs]"]
  node_dead["Dead-code insertion<br/>[dead_code.rs]"]
  node_vm["VM lowering<br/>[vm.rs]"]
end

subgraph group_output["Output Safeguards"]
  node_formatter["Minifying formatter<br/>[formatter.rs]"]
  node_wrapper["Chunk wrapper<br/>[wrapper.rs]"]
  node_antitamper["Integrity guard<br/>[antitamper.rs]"]
end

node_user(("Lua author"))

node_user -->|"provides Lua"| node_cli
node_user -->|"edits source"| node_webui
node_cli -->|"invokes"| node_pipeline
node_webui -->|"loads module"| node_wasm
node_wasm -->|"obfuscates source"| node_pipeline
node_config -->|"configures passes"| node_pipeline
node_pipeline -->|"validates input"| node_parser
node_parser -->|"tokenizes validated source"| node_lexer
node_pipeline -->|"lexes source"| node_lexer
node_pipeline -->|"applies pass"| node_renamer
node_pipeline -->|"applies pass"| node_strings
node_pipeline -->|"applies pass"| node_splitter
node_pipeline -->|"applies pass"| node_numbers
node_pipeline -->|"applies pass"| node_booleans
node_pipeline -->|"applies pass"| node_tables
node_pipeline -->|"applies pass"| node_control
node_pipeline -->|"applies pass"| node_dead
node_pipeline -->|"applies pass"| node_vm
node_pipeline -->|"formats output"| node_formatter
node_pipeline -->|"wraps output"| node_wrapper
node_pipeline -->|"guards output"| node_antitamper

click node_cli "https://github.com/amoxicillinmediatek/lexify/blob/main/src/main.rs"
click node_webui "https://github.com/amoxicillinmediatek/lexify/blob/main/web/app/ui/Obfuscator.tsx"
click node_wasm "https://github.com/amoxicillinmediatek/lexify/blob/main/src/lib.rs"
click node_config "https://github.com/amoxicillinmediatek/lexify/blob/main/src/config.rs"
click node_pipeline "https://github.com/amoxicillinmediatek/lexify/blob/main/src/lib.rs"
click node_parser "https://github.com/amoxicillinmediatek/lexify/blob/main/src/parser.rs"
click node_lexer "https://github.com/amoxicillinmediatek/lexify/blob/main/src/lexer.rs"
click node_renamer "https://github.com/amoxicillinmediatek/lexify/blob/main/src/renamer.rs"
click node_strings "https://github.com/amoxicillinmediatek/lexify/blob/main/src/string_encrypt.rs"
click node_splitter "https://github.com/amoxicillinmediatek/lexify/blob/main/src/string_splitter.rs"
click node_numbers "https://github.com/amoxicillinmediatek/lexify/blob/main/src/number_obfuscator.rs"
click node_booleans "https://github.com/amoxicillinmediatek/lexify/blob/main/src/boolean_obfuscator.rs"
click node_tables "https://github.com/amoxicillinmediatek/lexify/blob/main/src/table_obfuscator.rs"
click node_control "https://github.com/amoxicillinmediatek/lexify/blob/main/src/control_flow.rs"
click node_dead "https://github.com/amoxicillinmediatek/lexify/blob/main/src/dead_code.rs"
click node_vm "https://github.com/amoxicillinmediatek/lexify/blob/main/src/vm.rs"
click node_formatter "https://github.com/amoxicillinmediatek/lexify/blob/main/src/formatter.rs"
click node_wrapper "https://github.com/amoxicillinmediatek/lexify/blob/main/src/wrapper.rs"
click node_antitamper "https://github.com/amoxicillinmediatek/lexify/blob/main/src/antitamper.rs"

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_cli,node_webui,node_wasm toneBlue
class node_config,node_pipeline,node_parser,node_lexer toneAmber
class node_renamer,node_strings,node_splitter,node_numbers,node_booleans,node_tables,node_control,node_dead,node_vm toneMint
class node_formatter,node_wrapper,node_antitamper toneRose
class node_user toneIndigo
```

## Components

### User Interfaces

- [Rust CLI](https://github.com/amoxicillinmediatek/lexify/blob/main/src/main.rs): `src/main.rs`
- [Web playground](https://github.com/amoxicillinmediatek/lexify/blob/main/web/app/ui/Obfuscator.tsx): `web/app/ui/Obfuscator.tsx`
- [WASM bridge](https://github.com/amoxicillinmediatek/lexify/blob/main/src/lib.rs): `src/lib.rs`

### Obfuscation Core

- [Pass options](https://github.com/amoxicillinmediatek/lexify/blob/main/src/config.rs): `src/config.rs`
- [Obfuscation pipeline](https://github.com/amoxicillinmediatek/lexify/blob/main/src/lib.rs): `src/lib.rs`
- [Lua validation](https://github.com/amoxicillinmediatek/lexify/blob/main/src/parser.rs): `src/parser.rs`
- [Token scanner](https://github.com/amoxicillinmediatek/lexify/blob/main/src/lexer.rs): `src/lexer.rs`

### Transformation Passes

- [Local renaming](https://github.com/amoxicillinmediatek/lexify/blob/main/src/renamer.rs): `src/renamer.rs`
- [String encoding](https://github.com/amoxicillinmediatek/lexify/blob/main/src/string_encrypt.rs): `src/string_encrypt.rs`
- [String splitting](https://github.com/amoxicillinmediatek/lexify/blob/main/src/string_splitter.rs): `src/string_splitter.rs`
- [Number obfuscation](https://github.com/amoxicillinmediatek/lexify/blob/main/src/number_obfuscator.rs): `src/number_obfuscator.rs`
- [Boolean obfuscation](https://github.com/amoxicillinmediatek/lexify/blob/main/src/boolean_obfuscator.rs): `src/boolean_obfuscator.rs`
- [Table obfuscation](https://github.com/amoxicillinmediatek/lexify/blob/main/src/table_obfuscator.rs): `src/table_obfuscator.rs`
- [Condition normalization](https://github.com/amoxicillinmediatek/lexify/blob/main/src/control_flow.rs): `src/control_flow.rs`
- [Dead-code insertion](https://github.com/amoxicillinmediatek/lexify/blob/main/src/dead_code.rs): `src/dead_code.rs`
- [VM lowering](https://github.com/amoxicillinmediatek/lexify/blob/main/src/vm.rs): `src/vm.rs`

### Output Safeguards

- [Minifying formatter](https://github.com/amoxicillinmediatek/lexify/blob/main/src/formatter.rs): `src/formatter.rs`
- [Chunk wrapper](https://github.com/amoxicillinmediatek/lexify/blob/main/src/wrapper.rs): `src/wrapper.rs`
- [Integrity guard](https://github.com/amoxicillinmediatek/lexify/blob/main/src/antitamper.rs): `src/antitamper.rs`

### Other components

- **Lua author**

## Connections

- Lua author → Rust CLI: provides Lua (evidence: `README.md`)
- Lua author → Web playground: edits source (evidence: `web/app/ui/Obfuscator.tsx`)
- Rust CLI → Obfuscation pipeline: invokes (evidence: `README.md`)
- Web playground → WASM bridge: loads module (evidence: `web/app/ui/Obfuscator.tsx`)
- WASM bridge → Obfuscation pipeline: obfuscates source (evidence: `src/lib.rs`)
- Pass options → Obfuscation pipeline: configures passes (evidence: `src/lib.rs`)
- Obfuscation pipeline → Lua validation: validates input (evidence: `src/lib.rs`)
- Lua validation → Token scanner: tokenizes validated source (evidence: `src/parser.rs`)
- Obfuscation pipeline → Token scanner: lexes source (evidence: `src/lib.rs`)
- Obfuscation pipeline → Local renaming: applies pass (evidence: `src/lib.rs`)
- Obfuscation pipeline → String encoding: applies pass (evidence: `src/lib.rs`)
- Obfuscation pipeline → String splitting: applies pass (evidence: `src/lib.rs`)
- Obfuscation pipeline → Number obfuscation: applies pass (evidence: `src/lib.rs`)
- Obfuscation pipeline → Boolean obfuscation: applies pass (evidence: `src/lib.rs`)
- Obfuscation pipeline → Table obfuscation: applies pass (evidence: `src/lib.rs`)
- Obfuscation pipeline → Condition normalization: applies pass (evidence: `src/lib.rs`)
- Obfuscation pipeline → Dead-code insertion: applies pass (evidence: `src/lib.rs`)
- Obfuscation pipeline → VM lowering: applies pass (evidence: `src/lib.rs`)
- Obfuscation pipeline → Minifying formatter: formats output (evidence: `src/lib.rs`)
- Obfuscation pipeline → Chunk wrapper: wraps output (evidence: `src/lib.rs`)
- Obfuscation pipeline → Integrity guard: guards output (evidence: `src/lib.rs`)
