# Advanced Calculator

A simple, fast, free‑form calculator. You can type full math expressions, define variables, and see results right away. It runs on desktop, the web (WebAssembly), and Android. The math engine is powered by [CS‑MIC](https://github.com/wagesj45/cs-mic).

![Screenshot of Advanced Calculator](screen_shot.png?raw=true "Advanced Calculator Screen Shot")

## Features

- Easy input: Type expressions like `2 + 2 * 3` and press Enter.
- Variables: Save values and reuse them in later expressions.
- Linked expressions: Define variables that compute from other variables.
- History: See past inputs and results; copy any item with a click.
- Function browser: Browse built‑in functions and insert them quickly.
- Cross‑platform: Desktop (Windows, macOS, Linux), Web, and Android.

## Quick Start

Prerequisite: Install the .NET 8 SDK.

- Desktop: `dotnet run --project src/AdvancedCalculator.Desktop`
- Web (WASM): `dotnet run --project src/AdvancedCalculator.Browser` then open the URL shown in the console.
- Android: Build with `dotnet build src/AdvancedCalculator.Android -c Debug`. Install the APK from the `bin` folder using Android Studio or `adb`.

## How To Use

- Evaluate: Type an expression and press Enter, or click the Evaluate button.
- Define variables:
  - Set a value: `x :: 5`
  - Link to an expression: `y := x * 2`
  The Variables panel shows both the stored value and, for linked ones, the current computed result.
- Insert helpers: Use the Variables panel or the Functions button to insert names into the input box.
- Copy: Right‑click a history item to copy the input, output, or both.

For all supported operators and functions, see the CS‑MIC usage guide: http://cs-mic.com/usage/

## Build and Publish

You can create self‑contained builds for desktop platforms.

- Windows (x64):
  - `dotnet publish src/AdvancedCalculator.Desktop -c Release -r win-x64 --self-contained true`
- Linux (x64):
  - `dotnet publish src/AdvancedCalculator.Desktop -c Release -r linux-x64 --self-contained true`
- macOS (Intel or Apple Silicon):
  - `dotnet publish src/AdvancedCalculator.Desktop -c Release -r osx-x64 --self-contained true`
  - `dotnet publish src/AdvancedCalculator.Desktop -c Release -r osx-arm64 --self-contained true`

Web build output is written to the `out` folder when running the Browser project.

## Technology

- UI: [Avalonia](https://avaloniaui.net/)
- Language/runtime: C# on .NET 8
- Math engine: [CS‑MIC](https://github.com/wagesj45/cs-mic)

## Privacy

This app does not send your data anywhere. All calculations run on your device.

## Contributing

Issues and pull requests are welcome. If you want to add features or fix bugs, please open an issue to discuss first.

## License

MIT License. See the LICENSE file for details.