nitinkokane3/samplecalc

Purpose and Delivery Model

This repository is a browser-based advanced calculator supporting multiple mathematical and financial modes. It is deliberately framework-free: the application is delivered as static HTML, CSS, and JavaScript, with no compilation or server-side runtime. Primary launch points are index.html, script.js, and style.css.

Application Shell and UI

index.html defines the calculator shell, controls, mode-specific panels, dialogs, and accessibility-facing markup. style.css provides the responsive layout and visual states. script.js owns client-side behavior, including mode switching, input handling, display updates, and UI state transitions.

Key paths:

• index.html

• script.js

• style.css

Calculation Mode Engine

The central application logic is consolidated in script.js, which implements the distinct calculator domains: standard/scientific arithmetic, programmer operations, unit conversion, statistics, equation solving, graphing, matrices, vectors, complex numbers, regression, and finance. This makes the script both the shared interaction controller and the boundary between UI events and domain calculations.

Key path:

• script.js

Stateful Client-Side Features

All calculation state, histories, saved data, and mode-specific working values are browser-resident. The app has no indicated backend or database dependency. Backup/restore, localization, accessibility, security/CSP behavior, responsive operation, and offline behavior are material product concerns, reflected by dedicated end-to-end coverage.

Key paths:

• script.js

• tests/specs/backup.spec.js

• tests/specs/i18n.spec.js

PWA and Offline Boundary

The application is installable and supports offline use after an initial network visit. manifest.json supplies install metadata, while sw.js is the service-worker boundary responsible for caching static application assets and serving them offline.

Key paths:

• manifest.json

• sw.js

• index.html

Documentation and User-Facing Reference

The repository includes a standalone browser-readable manual with screenshots and examples. It is separate from the runtime app but documents the calculator’s mode model and expected workflows.

Key paths:

• README.md

• docs/user-manual.html

• docs/manual-images

Validation and Deployment

Browser-level tests use Playwright against a local static server. tests/run.js coordinates server startup and headless Chromium execution; individual specs validate modes and cross-cutting behaviors. GitHub Actions runs tests and deploys the static site to Pages.

Key paths:

• tests/run.js

• tests/server.js

• .github/workflows/test.yml

• .github/workflows/deploy-pages.yml