Ember CLI Addon for Accounting.js

Common errors

• DEPRECATION: Ember.assign is deprecated. Please use `Object.assign` instead.

  cause Older versions of `ember-cli-accounting` used `Ember.assign` internally.
  fix Update `ember-cli-accounting` to version 2.1.1 or higher: `ember update ember-cli-accounting` or `npm install ember-cli-accounting@latest`.

• Could not find module `accounting/format-money`

  cause Typo in the import path or attempting to `require` an ES module.
  fix Ensure the import path is exact: `import formatMoney from 'accounting/format-money';`. Confirm your Ember CLI project is configured for ES modules.

Warnings

• breaking Ember compatibility requires specific addon versions. Version 1.0.0+ is for Ember 1.13 and 2.0+, while 0.1.x is for Ember 1.10+ (including 1.13) but *not* Ember 2.0. Version 0.0.4 is for older than Ember 1.10.
  Fix: Consult the 'Ember compatibility' section of the README. For Ember 2.0+, use `ember-cli-accounting@1.0.0` or higher. For Ember 1.10-1.13, use `ember-cli-accounting@0.1.x`. For older Ember versions, use `ember-cli-accounting@0.0.4`.
• deprecated Usage of `Ember.assign` was deprecated in Ember and has been removed in `ember-cli-accounting` v2.1.1. Using older versions with newer Ember CLI might surface deprecation warnings related to this.
  Fix: Upgrade to `ember-cli-accounting@2.1.1` or newer to remove the deprecated `Ember.assign` usage.
• gotcha The addon's versioning (`ember-cli-accounting` vX.Y.Z) does not directly correspond to the version of the `accounting.js` library it bundles. This can be confusing when trying to track features or bug fixes from the upstream library.
  Fix: To check the bundled `accounting.js` version, import `version` from `accounting/version` (e.g., `import version from 'accounting/version';`). The README states v2.1.0 bundles accounting.js v0.4.1.

Install

• npm install ember-cli-accounting npm
• yarn add ember-cli-accounting yarn
• pnpm add ember-cli-accounting pnpm

Imports

• formatMoney
  wrong:

  import { formatMoney } from 'accounting'; // Incorrect path
  const formatMoney = require('accounting/format-money'); // CJS is not the primary usage

  correct:

  import formatMoney from 'accounting/format-money';

  Imports individual functions for better tree-shaking. This is the recommended approach for specific needs.
• accounting
  wrong:

  import * as accounting from 'accounting'; // Not a namespace import
  const accounting = require('accounting'); // CJS is not the primary usage

  correct:

  import accounting from 'accounting';

  Imports the entire accounting.js library object, providing access to all functions and settings.
• currency, number
  wrong:

  import { settings } from 'accounting'; // Incorrect path
  import { currency } from 'accounting'; // Incorrect path

  correct:

  import { currency, number } from 'accounting/settings';

  Used to configure global default options for currency and number formatting via Ember initializers.

Quickstart

Demonstrates importing specific accounting functions and settings, configuring global defaults via an initializer, and using both JavaScript functions and Handlebars helpers for formatting currency and numbers.

import formatMoney from 'accounting/format-money';
import formatNumber from 'accounting/format-number';

// app/initializers/accounting-defaults.js
import { currency, number } from 'accounting/settings';

export default {
  name: 'accounting-defaults',
  initialize() {
    currency.symbol = '€';
    currency.format = '%v %s'; // e.g., '123.45 €'
    number.decimal = ',';
    number.thousand = '.';
    number.precision = 2;
  }
};

// app/components/my-component.js
import Component from '@ember/component';
import { computed } from '@ember/object';

export default Component.extend({
  price: 12345.67,
  quantity: 5,

  formattedPrice: computed('price', function() {
    return formatMoney(this.price, { symbol: '$', precision: 2 }); // Uses local options
  }),

  // In a Handlebars template (app/templates/components/my-component.hbs):
  // <h1>Product Details</h1>
  // <p>Price: {{format-money price}}</p>  <!-- Uses initializer defaults: '12.345,67 €' -->
  // <p>Quantity: {{format-number quantity}}</p> <!-- Uses initializer defaults: '5' -->
  // <p>Discounted Price: {{format-money 99.99 symbol='USD' format='%s %v'}}</p> <!-- Overrides for specific use -->
});