calcsuite-react 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+All notable changes to **CalcSuite** are documented here. This project adheres to
+[Semantic Versioning](https://semver.org/).
+
+## [1.0.0] — 2026-09-04
+
+Initial release. The financial-calculator module of **AceCBM (Ace Cloud Business Management)**.
+
+### Added
+- **~55 calculators** across Loans, Investments, Returns, Tax, and Tools for 🇮🇳 India (₹) and 🇺🇸 United States ($).
+- **Decimal-exact engine** on `decimal.js` — no floating-point in any money path.
+- **Region model** (IN/US) as data: currency, grouping (lakh/crore vs western), terminology, day-count defaults.
+- **Scientific calculator** — tokenizer → shunting-yard → AST → Decimal evaluator; trig (deg/rad/grad), logs, memory, base modes.
+- **Currency converter** — live rates (no API key) with an offline toggle and a local rate book.
+- **Export** — CSV/TSV, JSON, share URL, clipboard, print, Markdown, ICS; lazy PDF/XLSX/PNG.
+- **Transport** — save/upload/list, retry, idempotency, offline queue, FX provider, and an integration panel.
+- **UI** — launcher (fully customizable trigger), focus-trapped dialog with host-shortcut isolation, command palette (⌘K), settings, history, spring animations.
+- **Full public API** — `FinCalcProvider`, `FinCalcLauncher`, `CalculatorPanel`, hooks, engine namespaces (`loan`, `finance`, `currency`), registry/plugin API, and TypeScript types.
+- Theme tokens with accent presets, fonts, light/dark/high-contrast, and accent-driven focus rings and scrollbars.
+
+### Notes
+- ESM build with full `.d.ts` types.
+- Peer deps: `react`, `react-dom` (18.3+ / 19). Optional peers for PDF/XLSX: `jspdf`, `xlsx`.
+- Not financial advice — figures are indicative, for planning only.

package/LICENSE

@@ -0,0 +1,26 @@
+MIT License
+
+Copyright (c) 2026 AceCBM (Ace Cloud Business Management)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+CalcSuite provides indicative financial figures for planning only and is not
+financial advice. See the README for details.

package/README.md

@@ -0,0 +1,87 @@
+# CalcSuite
+
+[![CI](https://github.com/ashish13377/calcsuite/actions/workflows/ci.yml/badge.svg)](https://github.com/ashish13377/calcsuite/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/calcsuite.svg)](https://www.npmjs.com/package/calcsuite)
+[![license: MIT](https://img.shields.io/npm/l/calcsuite.svg)](LICENSE)
+
+**Decimal-exact, offline-first financial calculator library for React** — ~55 calculators for **🇮🇳 India (₹)** and **🇺🇸 United States ($)**, a scientific calculator, live currency conversion, export, and a keyboard-first launcher/dialog. All money math runs on `decimal.js` — no floating-point in any money path.
+
+> 🧩 **Part of AceCBM — Ace Cloud Business Management**, the unified platform for billing, inventory, finance, and specialized industry workflows (*tailored globally, customized for your local regulation*). CalcSuite is its embeddable financial-calculator module — usable standalone or inside AceCBM.
+>
+> 📦 A **package**, not an app. Install it, wrap your app in a provider, render its components — or call its pure engine functions.
+
+## Install
+
+```bash
+npm install calcsuite       # yarn add calcsuite · pnpm add calcsuite
+```
+
+`decimal.js` installs automatically; `react`/`react-dom` are peer deps (18.3+ / 19). Optional PDF/XLSX export: `npm install jspdf xlsx`.
+
+## Quickstart
+
+```tsx
+import { FinCalcProvider, FinCalcLauncher } from 'calcsuite';
+import 'calcsuite/theme.css';
+
+export default function App() {
+  return (
+    <FinCalcProvider settings={{ region: 'IN' }}>
+      <YourApp />
+      <FinCalcLauncher />        {/* floating calculator button → the whole suite */}
+    </FinCalcProvider>
+  );
+}
+```
+
+Embed a single calculator:
+
+```tsx
+import { CalculatorPanel } from 'calcsuite';
+<CalculatorPanel id="loan.emi" />   // or "invest.sip", "tax.gst", "tools.scientific", …
+```
+
+Use the engine with no UI:
+
+```ts
+import { loan, finance } from 'calcsuite';
+loan.solve({ region: 'IN', principal: '2500000', annualRatePct: '8.65', tenureMonths: 240 }).payment.toString(); // "21933.51"
+finance.xirr([{ date: '2020-01-01', amount: '-10000' }, { date: '2021-01-01', amount: '12000' }]); // ≈ 0.20
+```
+
+## 📚 Documentation
+
+Full docs in **[`docs/`](docs/README.md)** — [installation](docs/getting-started.md) · [API reference](docs/api-reference.md) · [settings](docs/settings.md) · [features](docs/features.md) · [keyboard](docs/keyboard.md) · per-calculator guides ([loans](docs/calculators/loans.md) · [investments](docs/calculators/investments.md) · [returns](docs/calculators/returns.md) · [tax](docs/calculators/tax.md) · [tools](docs/calculators/tools.md)) · [extending](docs/developer.md) · [backend integration](docs/backend-integration.md).
+
+## What's inside
+
+- 🏦 **Loans** — EMI/Monthly-Payment (solve any variable, full amortisation table), Compare, Prepayment, Balance transfer, Eligibility, Step-up, Moratorium, Overdraft, Refinance
+- 📈 **Investments** — SIP, Step-up SIP, Lumpsum, SWP, Goal, FD, RD, PPF, NPS, EPF, SSY, 401(k), IRA, 529
+- 🧮 **Returns** — TVM, CAGR, XIRR, IRR, NPV, MIRR, Payback, Real return, Rule of 72
+- 🧾 **Tax** — GST, TDS, Income tax (IN old/new & US), Capital gains, HRA, Advance tax, Sales tax, Mortgage deduction
+- 🛠️ **Tools** — Scientific calculator, Currency converter (live+offline), Unit converter, Date/tenure, Number to words
+
+## Principles
+
+- 🎯 **Decimal-exact** — `decimal.js` everywhere; deterministic and reproducible.
+- 📴 **Offline-first** — works with no network; live rates and backend sync are optional.
+- 🌍 **Region as data** — India vs US differences live in profiles, not scattered `if`s.
+- ♿ **Accessible** — full keyboard operation, focus rings, `aria-live`, real `<table>` schedules (WCAG 2.2 AA target).
+- 🔒 **No stored secrets** — auth is a host callback; SSR-safe (no `window` at module scope).
+
+## Develop
+
+```bash
+npm run dev          # run the demo app (local development)
+npm test             # test suite (engine, golden values, UI)
+npm run build        # build the library → dist/ (ESM + .d.ts)
+npm run demo:build   # build the demo app
+```
+
+## About AceCBM
+
+**CalcSuite** is developed as part of **AceCBM — Ace Cloud Business Management**: *one platform for end-to-end business operations.* AceCBM empowers businesses with a unified ecosystem for **billing, inventory, finance, and specialized industry workflows** — tailored globally and customized for your local regulation. CalcSuite provides the finance/calculation building blocks and is published for reuse in any React app.
+
+## License
+
+MIT · **Not financial advice** — figures are indicative, for planning only.