kamaleshs-23/crypt_learn

Purpose and Entry Points

This is a static, browser-based cryptography learning tool. It implements classical ciphers plus DES, simplified DES (S-DES), and AES, with interactive encryption/decryption and algorithm visualizations.

Primary browser entry points:

• index.html supplies the application structure.

• script.js coordinates UI behavior and algorithm selection.

• style.css defines presentation.

UI-to-Algorithm Dispatch

The application is organized around selecting a cipher, collecting plaintext/key inputs, and invoking the corresponding module. script.js is the central integration boundary between DOM events and cryptographic implementations.

Relevant paths:

• script.js

• index.html

• modules/visualizations.js

Classical Cipher Implementations

Independent modules implement traditional substitution, transposition, and polyalphabetic algorithms. These are likely direct computational units consumed by the UI dispatcher, without a shared server or persistence layer.

Core paths:

• modules/ceaser.js

• modules/vigenere.js

• modules/monoalphabetic.js

• modules/playfair.js

• modules/hillcipher.js

• modules/railfence.js

• modules/columnar.js

• modules/product.js

• modules/otp.js

DES and S-DES Processing

DES-family functionality is separated into algorithm engines and visualization-oriented modules. This establishes a useful boundary: cryptographic transformations compute values, while flow modules expose intermediate rounds, permutations, keys, or diagrams for the browser UI.

Core paths:

• modules/des.js

• modules/sdes.js

• modules/des-visualization.js

• modules/sdes-visualization.js

• modules/des-flow-diagrams.js

• modules/des-unified-flow.js

AES Processing and Visualization

AES follows the same engine/presentation split as DES. The AES implementation is isolated from its explanatory visualization layer, allowing the UI to show state transformations independently of the core cipher operations.

Core paths:

• modules/aes.js

• modules/aes-visualization.js

Visualization Layer

Visualization modules are a major architectural concern rather than incidental UI decoration: they translate cipher stages into browser-renderable explanations. The generic visualization module appears to support shared display behavior, while DES/AES-specific modules provide algorithm-specific flows.

Relevant paths:

• modules/visualizations.js

• modules/des-visualization.js

• modules/aes-visualization.js

• modules/des-flow-diagrams.js

Runtime and External Boundaries

The repository contains only client-side HTML, CSS, and JavaScript. It has no visible backend, package manifest, build system, database, API client, or external service integration. Execution occurs in the browser, with local DOM state as the primary control and presentation boundary.

A focused S-DES test harness is present:

• test-sdes.js