saadmansakib47/electronics-calculator

Purpose and Entry Points

Calculator Suite is a multi-page, static browser application with three calculator modes: basic, advanced, and electronics-specific. index.html is the landing/navigation page; basic.html, advanced.html, and custom.html host the respective calculator UIs. Local serving starts at port 8080 via the npm start script defined in package.json.

Presentation and Page Boundaries

Each calculator is a separate HTML page rather than a single routed application. Shared visual styling is centralized in styles.css; each page loads its dedicated controller/calculation module.

• basic.html

• advanced.html

• custom.html

• styles.css

Basic Calculator Stage

The basic calculator implements the repaired core arithmetic behavior and is independently consumable in both browser and Node test contexts. Its script owns basic-operation state/interaction logic for basic.html, while CommonJS export guards permit Jest to import the same implementation.

• Scripts/basic.js

• basic.html

• Tests/basic.test.js

Advanced Calculator Stage

The advanced calculator extends the core calculator offering with advanced operations while retaining the dual-runtime model: browser globals for page execution and Node exports for automated tests. Its page and test suite form an isolated feature boundary.

• Scripts/advanced.js

• advanced.html

• Tests/advanced.test.js

Electronics Calculator Domain

The custom calculator is an electronics-domain calculator rather than generic arithmetic. Scripts/custom.js translates UI input into formula-based results defined by the project’s electronics reference. Input validation is shared through requireAtLeastOne, reducing duplicated validation behavior and establishing utils.js as a common domain-support dependency.

• Scripts/custom.js

• Scripts/utils.js

• ELECTRONICS_CALCULATOR.md

Test and Execution Flow

Browser users load an HTML page, interact with DOM controls, and invoke the corresponding script’s calculator behavior. Tests import those same scripts under Node/Jest, exercising calculation and integration behavior without a separate backend or API layer. Reusable test construction is centralized to keep calculator suites consistent.

• Tests/basic.test.js

• Tests/advanced.test.js

• Tests/custom.test.js

• Tests/testHelpers.js

Runtime, Automation, and Infrastructure

The repository has no server-side application, database, or external service dependency indicated; it is served locally as static web content and tested in the Node/npm ecosystem. GitHub Actions runs the Node CI workflow, making automated test execution the primary delivery gate.

• package.json

• .github/workflows/node.yml

• package-lock.json