DuoCalc JS

Uma biblioteca simples de calculadora em TypeScript.

Instalação

npm install duocalc-js
# ou
yarn add duocalc-js

Uso

Usando a classe Calculator

import { Calculator } from 'duocalc-js';

// Inicializar com valores
const calc1 = new Calculator(5, 3);
console.log(calc1.sum().values[0]); // 8

// Ou adicionar valores um por um
const calc2 = new Calculator();
calc2.push(10).push(4);
console.log(calc2.sub().values[0]); // 6

// Multiplicação
const calc3 = new Calculator(2, 6);
console.log(calc3.mul().values[0]); // 12

// Divisão
const calc4 = new Calculator(9, 3);
console.log(calc4.div().values[0]); // 3

// Encadeamento de operações
const calc5 = new Calculator(10);
calc5.push(5).sum().push(3).mul();
console.log(calc5.values[0]); // (10 + 5) * 3 = 45

// Cuidado com divisão por zero!
try {
  const calc6 = new Calculator(5, 0);
  calc6.div(); // Lança erro
} catch (error) {
  console.error(error.message); // "Is not possible to divide by zero"
}

Usando funções utilitárias

import { sum, subtract, multiply, divide } from 'duocalc-js';

console.log(sum(5, 3)); // 8
console.log(subtract(10, 4)); // 6
console.log(multiply(2, 6)); // 12
console.log(divide(9, 3)); // 3

try {
  divide(5, 0); // Lança erro
} catch (error) {
  console.error(error.message); // "Is not possible to divide by zero"
}

Integração em projetos

Em um projeto TypeScript

// tsconfig.json
{
  "compilerOptions": {
    "target": "ES2020",
    "module": "ESNext",
    // Outras configurações...
  },
  "dependencies": {
    "duocalc-js": "^0.1.0"
  }
}

// main.ts
import { Calculator, sum } from 'duocalc-js';

// Usar a biblioteca...

Em um projeto JavaScript

// Com ES Modules
import { Calculator, sum } from 'duocalc-js';

// Ou com CommonJS (se configurado para suportar)
const { Calculator, sum } = require('duocalc-js');

// Usar a biblioteca...

API

Calculator

A classe principal da biblioteca.

Construtor

• constructor(...values: number[]) - Cria uma nova instância da calculadora, opcionalmente inicializada com um ou dois valores.

Métodos

• push(value: number): Calculator - Adiciona um valor à calculadora (máximo de 2 valores) e retorna a instância.
• sum(value?: number): Calculator - Soma os dois valores armazenados, ou adiciona o valor fornecido antes de somar. Retorna a instância.
• sub(value?: number): Calculator - Subtrai o segundo valor do primeiro, ou adiciona o valor fornecido antes de subtrair. Retorna a instância.
• mul(value?: number): Calculator - Multiplica os dois valores armazenados, ou adiciona o valor fornecido antes de multiplicar. Retorna a instância.
• div(value?: number): Calculator - Divide o primeiro valor pelo segundo, ou adiciona o valor fornecido antes de dividir. Lança erro se o divisor for zero. Retorna a instância.

Propriedades

• values: number[] - Array que armazena os valores atuais da calculadora.

Funções utilitárias

• sum(a: number, b: number): number - Retorna a soma de dois números.
• subtract(a: number, b: number): number - Retorna a diferença entre dois números.
• multiply(a: number, b: number): number - Retorna o produto de dois números.
• divide(a: number, b: number): number - Retorna o quociente da divisão de dois números. Lança erro se o divisor for zero.

Licença

MIT