Nordic household reference
The nordic-household module composes national tax and pension assessments, personal accounts, household costs and posted loan plans. Use its nordicHousehold(options) factory to return a model and nordicHouseholdSupport() to inspect the explicit local contracts. The complete Nordic household guide describes every input, result metric, local requirement and unsupported case. The model editor API includes callable examples and exact types.
The shared interface does not unify national formulas. Annual assessments, monthly cash payments and closing balances remain distinct. Pension rights and employer premiums are not household income or automatically owned savings. Enter actual tax and employee insurance payments separately from classified assessment bases; a tax assessment never creates another monthly payment.
The included Nordic household example supplies five country scenarios through one model source. Replace the illustrative local facts with your own verified municipal rates, payroll/pension classifications and loan terms. Country scenarios use different currencies: their amounts are local, not converted or directly comparable. One country and currency apply to each run.
For a shared interest-rate scenario, pass the optional loanRateAdjustment as a finite number, numeric input or calculation. It adds annual decimal percentage points to each loan's entered nominal rate with a zero floor, while preserving contractual monthly payments. A static calculation using bind.sample can supply a hidden annual shock for Monte Carlo; an ordinary run uses its center. Omission leaves existing rates unchanged. The complete guide's executable nordicHousehold(...) example includes this source and a 64-trial Sobol default through the standard calculator.defaultRun metadata. Dates remain first-day monthly periods within the supported 2026 national profiles.
A currency-code input
defineModel.currency can use a declared fixed currency-code input. The code is resolved before account and flow compilation on every run. Use three uppercase letters and declare the input in preconditions. This chooses how local numeric amounts are denominated; it performs no FX conversion, and explicit foreign Money still fails. Existing deccf.currencies values continue to work.
const currencyCode = deccf.input.enum('DKK', {options: [
{value: 'DKK', label: 'DKK'}, {value: 'EUR', label: 'EUR'},
]});
return deccf.defineModel({
currency: currencyCode,
timeline: deccf.periods.monthly({from: '2026-05', count: 1}),
preconditions: {currencyCode},
});Resolved national assessments
Each Danish, Finnish, Icelandic and Norwegian tax/pension module also exposes an assess… function. It takes already resolved local facts and returns the same native assessment as the declaration factory. It has no owner, timeline, engine references, callbacks or bank payments. Tax uses the native annual or explicitly selected Icelandic period; pension retains its native monthly contribution or annual accrual unit. An annual right is never a monthly payout.
assessSwedishIncomeTax2025() similarly exposes the established Swedish 2025 calculation, with annual SEK bases, explicit year metadata and no payment. The full module reference gives the required arguments, defaults, supported profiles, rounding, sources and an executable call for each assessment function. These assessment calls preserve the selected legal rule editions and the behavior of your saved models.