.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):
FutureValuePresentValueAnnuityPresentAnnuityFutureNetPresentValueBondPriceCAPMWACCDeterminant2x2LinearSolve2x2QuadraticEquationRatio
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:
annualsemi-annualquarterlymonthlycontinuous
Unknown period conventions are rejected with NSS-E-FIN-002.
Discounting
Time-value-of-money components apply discounting either discretely or continuously:
discretecontinuous
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
| Code | Meaning |
|---|---|
NSS-E-FIN-001 | unknown finance object |
NSS-E-FIN-002 | unknown finance period convention |
NSS-E-FIN-003 | unknown finance discounting |