# jsrift/jsrift architecture

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

- Interactive diagram: https://gitdiagram.com/jsrift/jsrift
- Repository: https://github.com/jsrift/jsrift

## Overview

jsrift is a JavaScript/TypeScript/JSX deobfuscation engine exposed as a library, with an optional worker entry point. Its main workflow parses input, resolves options, runs ordered and iterative transformation passes, prints the result, and returns code plus detections, diagnostics, renames, and other metadata. The graph preserves the README’s major transformation capabilities and the sampled analysis, evaluation, naming, and pipeline layers. Some pass-to-pass behavior is documented rather than visible in excerpts; edges are limited to documented or indexed relationships.

Main entry points: [`src/index.ts`](https://github.com/jsrift/jsrift/blob/main/src/index.ts) (Deobfuscate API), [`src/passes/registry.ts`](https://github.com/jsrift/jsrift/blob/main/src/passes/registry.ts) (Pass Registry), [`src/passes/strings/discover.ts`](https://github.com/jsrift/jsrift/blob/main/src/passes/strings/discover.ts) (String Decoding), [`src/analysis/analyze.ts`](https://github.com/jsrift/jsrift/blob/main/src/analysis/analyze.ts) (Static Analysis API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Public API"]
  node_api["Deobfuscate API<br/>[index.ts]"]
  node_analyze["Static Analysis API<br/>[analyze.ts]"]
  node_config["Options and Presets<br/>[presets.ts]"]
  node_language["Language Parser<br/>[language.ts]"]
  node_result["Code and Metadata<br/>[index.ts]"]
  node_worker["Worker Adapter<br/>[worker.ts]"]
end

subgraph group_analysis["Analysis and Evaluation"]
  node_detect["Obfuscator Detection<br/>[detect.ts]"]
  node_evaluator["Decoder Evaluation"]
  node_slice["Code Slicing<br/>[slice.ts]"]
  node_dispatcher["Dispatcher Analysis<br/>[dispatcher.ts]"]
  node_stringcode["String-Code Safety<br/>[string-code.ts]"]
  node_naming["Evidence-Based Naming"]
end

subgraph group_transforms["Transformation Passes"]
  node_stringdiscover["String Decoding<br/>[discover.ts]"]
  node_stringinline["String Inlining<br/>[inline.ts]"]
  node_unpack["Packer Unwrapping"]
  node_simplify["Code Simplification"]
  node_structure["Control-Flow Recovery"]
  node_clean["Dead-Code Cleanup"]
  node_rename["Identifier Renaming<br/>[identifiers.ts]"]
  node_finalize["Output Finalization"]
end

subgraph group_engine["Pipeline and Output"]
  node_registry["Pass Registry<br/>[registry.ts]"]
  node_kernel["Pipeline Kernel<br/>[kernel.ts]"]
  node_context["Run Context<br/>[context.ts]"]
  node_print["Code Printer<br/>[print.ts]"]
  node_sharedast["AST Utilities<br/>[ast.ts]"]
  node_purity["Purity Analysis<br/>[purity.ts]"]
end

node_consumer(("Library Consumer"))

node_consumer -->|"submits source"| node_api
node_consumer -->|"requests analysis"| node_analyze
node_api -->|"resolves options"| node_config
node_api -->|"parses input"| node_language
node_api -->|"creates context"| node_context
node_api -->|"runs pipeline"| node_kernel
node_api -->|"loads passes"| node_registry
node_api -->|"prints output"| node_print
node_api -->|"returns result"| node_result
node_analyze -->|"parses input"| node_language
node_analyze -->|"fingerprints input"| node_detect
node_registry -->|"registers passes"| node_unpack
node_registry -->|"registers passes"| node_stringdiscover
node_registry -->|"registers passes"| node_stringinline
node_registry -->|"registers passes"| node_simplify
node_registry -->|"registers passes"| node_structure
node_registry -->|"registers passes"| node_clean
node_registry -->|"registers passes"| node_rename
node_registry -->|"registers passes"| node_finalize
node_kernel -->|"uses run state"| node_context
node_stringdiscover -->|"evaluates decoders"| node_evaluator
node_stringdiscover -->|"extracts dependencies"| node_slice
node_stringdiscover -->|"checks dynamic use"| node_stringcode
node_structure -->|"analyzes dispatchers"| node_dispatcher
node_simplify -->|"checks string use"| node_stringcode
node_rename -.->|"uses naming evidence"| node_naming
node_api -->|"offers worker entry"| node_worker
node_api -->|"counts AST metrics"| node_sharedast

click node_api "https://github.com/jsrift/jsrift/blob/main/src/index.ts"
click node_analyze "https://github.com/jsrift/jsrift/blob/main/src/analysis/analyze.ts"
click node_config "https://github.com/jsrift/jsrift/blob/main/src/config/presets.ts"
click node_language "https://github.com/jsrift/jsrift/blob/main/src/frontend/language.ts"
click node_detect "https://github.com/jsrift/jsrift/blob/main/src/analysis/detect.ts"
click node_evaluator "https://github.com/jsrift/jsrift/tree/main/src/analysis/evaluator"
click node_slice "https://github.com/jsrift/jsrift/blob/main/src/analysis/slice.ts"
click node_dispatcher "https://github.com/jsrift/jsrift/blob/main/src/analysis/dispatcher.ts"
click node_stringcode "https://github.com/jsrift/jsrift/blob/main/src/analysis/string-code.ts"
click node_stringdiscover "https://github.com/jsrift/jsrift/blob/main/src/passes/strings/discover.ts"
click node_stringinline "https://github.com/jsrift/jsrift/blob/main/src/passes/strings/inline.ts"
click node_unpack "https://github.com/jsrift/jsrift/tree/main/src/passes/unpack"
click node_simplify "https://github.com/jsrift/jsrift/tree/main/src/passes/simplify"
click node_structure "https://github.com/jsrift/jsrift/tree/main/src/passes/structure"
click node_clean "https://github.com/jsrift/jsrift/tree/main/src/passes/clean"
click node_rename "https://github.com/jsrift/jsrift/blob/main/src/passes/rename/identifiers.ts"
click node_finalize "https://github.com/jsrift/jsrift/tree/main/src/passes/finalize"
click node_naming "https://github.com/jsrift/jsrift/tree/main/src/naming"
click node_registry "https://github.com/jsrift/jsrift/blob/main/src/passes/registry.ts"
click node_kernel "https://github.com/jsrift/jsrift/blob/main/src/pipeline/kernel.ts"
click node_context "https://github.com/jsrift/jsrift/blob/main/src/pipeline/context.ts"
click node_print "https://github.com/jsrift/jsrift/blob/main/src/frontend/print.ts"
click node_result "https://github.com/jsrift/jsrift/blob/main/src/index.ts"
click node_worker "https://github.com/jsrift/jsrift/blob/main/src/parallel/worker.ts"
click node_sharedast "https://github.com/jsrift/jsrift/blob/main/src/util/ast.ts"
click node_purity "https://github.com/jsrift/jsrift/blob/main/src/util/purity.ts"

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_api,node_analyze,node_config,node_language,node_result,node_worker toneBlue
class node_detect,node_evaluator,node_slice,node_dispatcher,node_stringcode,node_naming toneAmber
class node_stringdiscover,node_stringinline,node_unpack,node_simplify,node_structure,node_clean,node_rename,node_finalize toneMint
class node_registry,node_kernel,node_context,node_print,node_sharedast,node_purity toneRose
class node_consumer toneIndigo
```

## Components

### Public API

- [Deobfuscate API](https://github.com/jsrift/jsrift/blob/main/src/index.ts): `src/index.ts`
- [Static Analysis API](https://github.com/jsrift/jsrift/blob/main/src/analysis/analyze.ts): `src/analysis/analyze.ts`
- [Options and Presets](https://github.com/jsrift/jsrift/blob/main/src/config/presets.ts): `src/config/presets.ts`
- [Language Parser](https://github.com/jsrift/jsrift/blob/main/src/frontend/language.ts): `src/frontend/language.ts`
- [Code and Metadata](https://github.com/jsrift/jsrift/blob/main/src/index.ts): `src/index.ts`
- [Worker Adapter](https://github.com/jsrift/jsrift/blob/main/src/parallel/worker.ts): `src/parallel/worker.ts`

### Analysis and Evaluation

- [Obfuscator Detection](https://github.com/jsrift/jsrift/blob/main/src/analysis/detect.ts): `src/analysis/detect.ts`
- [Decoder Evaluation](https://github.com/jsrift/jsrift/tree/main/src/analysis/evaluator): `src/analysis/evaluator`
- [Code Slicing](https://github.com/jsrift/jsrift/blob/main/src/analysis/slice.ts): `src/analysis/slice.ts`
- [Dispatcher Analysis](https://github.com/jsrift/jsrift/blob/main/src/analysis/dispatcher.ts): `src/analysis/dispatcher.ts`
- [String-Code Safety](https://github.com/jsrift/jsrift/blob/main/src/analysis/string-code.ts): `src/analysis/string-code.ts`
- [Evidence-Based Naming](https://github.com/jsrift/jsrift/tree/main/src/naming): `src/naming`

### Transformation Passes

- [String Decoding](https://github.com/jsrift/jsrift/blob/main/src/passes/strings/discover.ts): `src/passes/strings/discover.ts`
- [String Inlining](https://github.com/jsrift/jsrift/blob/main/src/passes/strings/inline.ts): `src/passes/strings/inline.ts`
- [Packer Unwrapping](https://github.com/jsrift/jsrift/tree/main/src/passes/unpack): `src/passes/unpack`
- [Code Simplification](https://github.com/jsrift/jsrift/tree/main/src/passes/simplify): `src/passes/simplify`
- [Control-Flow Recovery](https://github.com/jsrift/jsrift/tree/main/src/passes/structure): `src/passes/structure`
- [Dead-Code Cleanup](https://github.com/jsrift/jsrift/tree/main/src/passes/clean): `src/passes/clean`
- [Identifier Renaming](https://github.com/jsrift/jsrift/blob/main/src/passes/rename/identifiers.ts): `src/passes/rename/identifiers.ts`
- [Output Finalization](https://github.com/jsrift/jsrift/tree/main/src/passes/finalize): `src/passes/finalize`

### Pipeline and Output

- [Pass Registry](https://github.com/jsrift/jsrift/blob/main/src/passes/registry.ts): `src/passes/registry.ts`
- [Pipeline Kernel](https://github.com/jsrift/jsrift/blob/main/src/pipeline/kernel.ts): `src/pipeline/kernel.ts`
- [Run Context](https://github.com/jsrift/jsrift/blob/main/src/pipeline/context.ts): `src/pipeline/context.ts`
- [Code Printer](https://github.com/jsrift/jsrift/blob/main/src/frontend/print.ts): `src/frontend/print.ts`
- [AST Utilities](https://github.com/jsrift/jsrift/blob/main/src/util/ast.ts): `src/util/ast.ts`
- [Purity Analysis](https://github.com/jsrift/jsrift/blob/main/src/util/purity.ts): `src/util/purity.ts`

### Other components

- **Library Consumer**

## Connections

- Library Consumer → Deobfuscate API: submits source
- Library Consumer → Static Analysis API: requests analysis
- Deobfuscate API → Options and Presets: resolves options (evidence: `src/index.ts`)
- Deobfuscate API → Language Parser: parses input (evidence: `src/index.ts`)
- Deobfuscate API → Run Context: creates context (evidence: `src/index.ts`)
- Deobfuscate API → Pipeline Kernel: runs pipeline (evidence: `src/index.ts`)
- Deobfuscate API → Pass Registry: loads passes (evidence: `src/index.ts`)
- Deobfuscate API → Code Printer: prints output (evidence: `src/index.ts`)
- Deobfuscate API → Code and Metadata: returns result (evidence: `src/index.ts`)
- Static Analysis API → Language Parser: parses input (evidence: `src/analysis/analyze.ts`)
- Static Analysis API → Obfuscator Detection: fingerprints input (evidence: `src/analysis/analyze.ts`)
- Pass Registry → Packer Unwrapping: registers passes (evidence: `src/passes/registry.ts`)
- Pass Registry → String Decoding: registers passes (evidence: `src/passes/registry.ts`)
- Pass Registry → String Inlining: registers passes (evidence: `src/passes/registry.ts`)
- Pass Registry → Code Simplification: registers passes (evidence: `src/passes/registry.ts`)
- Pass Registry → Control-Flow Recovery: registers passes (evidence: `src/passes/registry.ts`)
- Pass Registry → Dead-Code Cleanup: registers passes (evidence: `src/passes/registry.ts`)
- Pass Registry → Identifier Renaming: registers passes (evidence: `src/passes/registry.ts`)
- Pass Registry → Output Finalization: registers passes (evidence: `src/passes/registry.ts`)
- Pipeline Kernel → Run Context: uses run state (evidence: `src/pipeline/kernel.ts`)
- String Decoding → Decoder Evaluation: evaluates decoders (evidence: `src/passes/strings/discover.ts`)
- String Decoding → Code Slicing: extracts dependencies (evidence: `src/passes/strings/discover.ts`)
- String Decoding → String-Code Safety: checks dynamic use (evidence: `src/passes/strings/discover.ts`)
- Control-Flow Recovery → Dispatcher Analysis: analyzes dispatchers (evidence: `src/passes/structure/register-vm.ts`)
- Code Simplification → String-Code Safety: checks string use (evidence: `src/passes/simplify/proxy-functions.ts`)
- Identifier Renaming → Evidence-Based Naming: uses naming evidence
- Deobfuscate API → Worker Adapter: offers worker entry (evidence: `src/parallel/worker.ts`)
- Deobfuscate API → AST Utilities: counts AST metrics (evidence: `src/index.ts`)
