Home /Modules/impl/SST.FINANCE.md

SST.FINANCE.md

impl/nordshrift/SST.FINANCE.md · 117 line(s) · markdown

.sst Finance Support — NS-SST-FIN-0001

Nordshrift .sst sheets have a first-class finance declaration block, parallel to the network block (NS-SST-NET-0001). The finance declaration is parsed by the same indentation-aware NS-SST parser as every other section, so finance metadata is available to the transpiler without changing the source/target grammar. It complements the financial integration described in SST.FINANCIAL.md.

A finance: block is a compile-time declaration of the financial object series a sheet uses, together with the conventions those objects require. It is not a program: executable financial behavior is lowered by the Sleela front end to the financial kernels (see impl/frontend/financial_api.cpp and impl/finance/financial.cpp).

Finance object series

The supported FinanceObject enum is closed to these components (the same set as SST.FINANCIAL.md):

Unknown object names are rejected with NSS-E-FIN-001.

Period convention

Rates require a stated period convention before a quantity can be interpreted. Supported values are:

Unknown period conventions are rejected with NSS-E-FIN-002.

Discounting

Time-value-of-money components apply discounting either discretely or continuously:

Unknown discounting modes are rejected with NSS-E-FIN-003.

Currency identity

Currency values require a currency identity. The currency directive records it (e.g. USD); it is a free scalar and is not validated against a closed set.

SST syntax

A complete finance declaration may be written directly in an .sst sheet:

finance:
  objects: [ FutureValue, PresentValue, AnnuityPresent, AnnuityFuture,
             NetPresentValue, BondPrice, CAPM, WACC,
             Determinant2x2, LinearSolve2x2, QuadraticEquation, Ratio ]
  currency:    USD
  period:      annual
  discounting: discrete

The singular forms are also supported for repeated declarations, and component/components are accepted as aliases for object/objects:

finance:
  object: PresentValue
  object: NetPresentValue
  currency: EUR
  period: quarterly
  discounting: discrete

Duplicate object values are coalesced.

Object structure

Every finance object is also carried on the repo-root SHEET.sheet catalog (section finance, role finance), so a declared finance object has a home in the shared Nordshrift object-compatibility / relevance structure alongside the system and network objects. Each converts to a model relevance for every target — it is realized as a modeled financial shape rather than a single target keyword.

Domain contract

Finance objects are computational models. A rate requires a stated period convention; a currency value requires currency identity; discounting requires a timing convention; and capital-pricing models require their assumptions. A computed result is not automatically a forecast, an investment recommendation, or an empirical fact. See the domain contract in SST.FINANCIAL.md.

Diagnostics summary

CodeMeaning
NSS-E-FIN-001unknown finance object
NSS-E-FIN-002unknown finance period convention
NSS-E-FIN-003unknown finance discounting