@insiderfinance/totalfinance 0.1.0

package/modules/fundamentals/dist/score-heads.d.ts

@@ -0,0 +1,130 @@
+/**
+ * FC2 — the composite scores: Piotroski F, Altman Z (three published variants), and the Beneish
+ * M-score (the original eight-variable 1999 model — no silent five-variable fallback). Each score
+ * follows its PAPER's definitions, which are not always this library's ratio defaults; where they
+ * differ (Piotroski's beginning-assets return, Beneish's debt definition) the difference is stated
+ * here and echoed in the result.
+ */
+import { type FinancialStatements } from './statement-contracts.js';
+/** Input for {@link piotroskiFScore}: three consecutive periods of one entity. */
+export interface PiotroskiInput {
+    current: FinancialStatements;
+    prior: FinancialStatements;
+    /**
+     * The period before `prior`. Needed because the paper's return and turnover use BEGINNING
+     * assets, so the prior year's own signal needs the balance sheet one further back.
+     */
+    priorPrior: FinancialStatements;
+}
+/** One of the nine binary signals. */
+export interface PiotroskiSignal {
+    signal: string;
+    /** 1 or 0 per the paper; `null` with `reason` when an optional statement line is absent. */
+    value: 0 | 1 | null;
+    detail: string;
+    reason?: string;
+}
+/** Result of {@link piotroskiFScore}. */
+export interface PiotroskiResult {
+    assumptions: {
+        /** The published model name (a label, deliberately not a literal type). */
+        model: string;
+        /** Returns and turnover use BEGINNING total assets, per the paper. */
+        returnBasis: 'beginning total assets';
+    };
+    diagnostics: {
+        /** One warning per unevaluable signal. */
+        warnings: string[];
+    };
+    /** Sum of the evaluable signals (each 0 or 1). */
+    fScore: number;
+    /** How many of the nine signals could be evaluated; 9 when every input line was present. */
+    evaluableSignals: number;
+    signals: PiotroskiSignal[];
+}
+/**
+ * The standard nine binary signals, per the paper: profitability (return on beginning assets,
+ * operating cash flow, their improvement, accruals), leverage/liquidity/funding (falling
+ * long-term-debt ratio, improving current ratio, no net share issuance), and efficiency
+ * (improving gross margin, improving beginning-assets turnover). Each signal is reported, not
+ * only the total; a signal whose statement line is absent reports `null` with the reason and is
+ * excluded from `fScore` — never guessed to 0 or 1.
+ */
+export declare function piotroskiFScore(input: PiotroskiInput): PiotroskiResult;
+/** The published Altman variants; each fixes its coefficients and its equity basis. */
+export type AltmanVariant = 'public-manufacturing' | 'private-manufacturing' | 'non-manufacturing';
+/** Input for {@link altmanZScore}. */
+export interface AltmanInput {
+    statements: FinancialStatements;
+    variant: AltmanVariant;
+    /** REQUIRED for `public-manufacturing` (its X4 uses market equity); rejected otherwise. */
+    marketEquity?: number;
+}
+/** One Altman component. */
+export interface AltmanComponent {
+    component: 'X1' | 'X2' | 'X3' | 'X4' | 'X5';
+    definition: string;
+    value: number;
+    coefficient: number;
+    contribution: number;
+}
+/** Result of {@link altmanZScore}. */
+export interface AltmanResult {
+    assumptions: {
+        /** The published model name (a label, deliberately not a literal type). */
+        model: string;
+        variant: AltmanVariant;
+        equityBasis: 'market' | 'book';
+    };
+    diagnostics: {
+        warnings: string[];
+    };
+    zScore: number;
+    variant: AltmanVariant;
+    components: AltmanComponent[];
+}
+/**
+ * The Altman Z-score with the published coefficients and denominator definitions per variant.
+ * `X1` working capital / assets, `X2` retained earnings / assets, `X3` operating income / assets,
+ * `X4` the variant's equity basis / total liabilities, `X5` sales / assets where the variant has
+ * one. The variant is REQUIRED — there is no default bankruptcy model.
+ */
+export declare function altmanZScore(input: AltmanInput): AltmanResult;
+/** Input for {@link beneishMScore}: two consecutive periods. */
+export interface BeneishInput {
+    current: FinancialStatements;
+    prior: FinancialStatements;
+}
+/** One Beneish component index. */
+export interface BeneishComponent {
+    index: 'DSRI' | 'GMI' | 'AQI' | 'SGI' | 'DEPI' | 'SGAI' | 'LVGI' | 'TATA';
+    expandedName: string;
+    value: number;
+    coefficient: number;
+    contribution: number;
+    currentPeriodEndDate: string;
+    priorPeriodEndDate: string;
+}
+/** Result of {@link beneishMScore}. */
+export interface BeneishResult {
+    assumptions: {
+        /** The published model name (a label, deliberately not a literal type). */
+        model: string;
+    };
+    diagnostics: {
+        /** Conventions the inputs forced (e.g. D&A standing in for pure depreciation) — disclosed. */
+        warnings: string[];
+    };
+    mScore: number;
+    components: BeneishComponent[];
+    /** The same disclosures as `diagnostics.warnings` (kept for direct reading). */
+    notes: string[];
+}
+/**
+ * The original eight-variable 1999 Beneish equation
+ * `-4.84 + 0.920 DSRI + 0.528 GMI + 0.404 AQI + 0.892 SGI + 0.115 DEPI - 0.172 SGAI + 4.679 TATA
+ * - 0.327 LVGI`, with the component definitions fixed to the paper. Every variable the model needs
+ * must be present in both periods — there is NO five-variable fallback, silent or otherwise.
+ */
+export declare function beneishMScore(input: BeneishInput): BeneishResult;
+//# sourceMappingURL=score-heads.d.ts.map

package/modules/fundamentals/dist/score-heads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score-heads.d.ts","sourceRoot":"","sources":["../src/score-heads.ts"],"names":[],"mappings":"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"}

package/modules/fundamentals/dist/score-heads.js

@@ -0,0 +1,364 @@
+/**
+ * FC2 — the composite scores: Piotroski F, Altman Z (three published variants), and the Beneish
+ * M-score (the original eight-variable 1999 model — no silent five-variable fallback). Each score
+ * follows its PAPER's definitions, which are not always this library's ratio defaults; where they
+ * differ (Piotroski's beginning-assets return, Beneish's debt definition) the difference is stated
+ * here and echoed in the result.
+ */
+import { requireRepresentableResult, ErrorCode, InputError, ensureKnownKeys, requireArgumentObject, } from '../../core/dist/index.js';
+import { requireFinancialStatements, resolveGrossProfit, } from './statement-contracts.js';
+function requireConsecutive(functionName, pairs) {
+    for (const [laterLabel, later, earlierLabel, earlier] of pairs) {
+        if (earlier.income.period.periodEndDate >= later.income.period.periodEndDate) {
+            throw new InputError(`${functionName}: ${earlierLabel} must END BEFORE ${laterLabel} — received ${earlierLabel} ending ${earlier.income.period.periodEndDate} against ${laterLabel} ending ${later.income.period.periodEndDate}.`, { code: ErrorCode.InputWrongShape, context: { field: earlierLabel } });
+        }
+        const a = later.income.period;
+        const b = earlier.income.period;
+        if (a.currency !== b.currency || a.monetaryScale !== b.monetaryScale) {
+            throw new InputError(`${functionName}: ${laterLabel} and ${earlierLabel} must share one currency and monetary scale — received ${a.currency}@${a.monetaryScale} against ${b.currency}@${b.monetaryScale}.`, { code: ErrorCode.InputWrongShape, context: { field: earlierLabel } });
+        }
+    }
+}
+/** A statement line the score's model REQUIRES; absence is an error naming it, never a proxy. */
+function demand(functionName, owner, value, field) {
+    if (value === undefined) {
+        throw new InputError(`${functionName}: ${owner}.${field} is required by this model and is absent — the model runs on its published variables or not at all.`, { code: ErrorCode.InputMissingField, context: { field: `${owner}.${field}` } });
+    }
+    return value;
+}
+/**
+ * The standard nine binary signals, per the paper: profitability (return on beginning assets,
+ * operating cash flow, their improvement, accruals), leverage/liquidity/funding (falling
+ * long-term-debt ratio, improving current ratio, no net share issuance), and efficiency
+ * (improving gross margin, improving beginning-assets turnover). Each signal is reported, not
+ * only the total; a signal whose statement line is absent reports `null` with the reason and is
+ * excluded from `fScore` — never guessed to 0 or 1.
+ */
+export function piotroskiFScore(input) {
+    requireArgumentObject('piotroskiFScore', 'input', input);
+    ensureKnownKeys('piotroskiFScore', 'input', input, ['current', 'prior', 'priorPrior']);
+    for (const field of ['current', 'prior', 'priorPrior']) {
+        if (input[field] === undefined) {
+            throw new InputError(`piotroskiFScore: ${field} is required — the paper's beginning-assets return makes the prior year's signal need the balance sheet one further back.\n  e.g. piotroskiFScore({ current, prior, priorPrior })`, { code: ErrorCode.InputMissingField, context: { field } });
+        }
+        requireFinancialStatements('piotroskiFScore', input[field]);
+    }
+    requireConsecutive('piotroskiFScore', [
+        ['current', input.current, 'prior', input.prior],
+        ['prior', input.prior, 'priorPrior', input.priorPrior],
+    ]);
+    const { current, prior, priorPrior } = input;
+    const signals = [];
+    const binary = (condition) => (condition ? 1 : 0);
+    const returnOnBeginningAssets = (period, beginning) => period.income.netIncome / beginning.balance.totalAssets;
+    const currentReturn = returnOnBeginningAssets(current, prior);
+    const priorReturn = returnOnBeginningAssets(prior, priorPrior);
+    signals.push({
+        signal: 'positive return on assets',
+        value: binary(currentReturn > 0),
+        detail: `netIncome / beginning totalAssets = ${currentReturn.toFixed(6)}`,
+    });
+    signals.push({
+        signal: 'positive operating cash flow',
+        value: binary(current.cashFlow.operatingCashFlow > 0),
+        detail: `operatingCashFlow = ${current.cashFlow.operatingCashFlow}`,
+    });
+    signals.push({
+        signal: 'improving return on assets',
+        value: binary(currentReturn > priorReturn),
+        detail: `${currentReturn.toFixed(6)} vs prior ${priorReturn.toFixed(6)}`,
+    });
+    signals.push({
+        signal: 'operating cash flow greater than net income',
+        value: binary(current.cashFlow.operatingCashFlow > current.income.netIncome),
+        detail: `${current.cashFlow.operatingCashFlow} vs netIncome ${current.income.netIncome}`,
+    });
+    const longTermDebtRatio = (period, beginning) => {
+        if (period.balance.longTermDebt === undefined)
+            return null;
+        const averageAssets = (beginning.balance.totalAssets + period.balance.totalAssets) / 2;
+        return period.balance.longTermDebt / averageAssets;
+    };
+    const currentLeverage = longTermDebtRatio(current, prior);
+    const priorLeverage = longTermDebtRatio(prior, priorPrior);
+    signals.push(currentLeverage === null || priorLeverage === null
+        ? {
+            signal: 'falling long-term-debt ratio',
+            value: null,
+            detail: 'longTermDebt / average totalAssets, current vs prior',
+            reason: 'longTermDebt is absent in one period',
+        }
+        : {
+            signal: 'falling long-term-debt ratio',
+            value: binary(currentLeverage <= priorLeverage),
+            detail: `${currentLeverage.toFixed(6)} vs prior ${priorLeverage.toFixed(6)}`,
+        });
+    const currentRatioOf = (period) => {
+        const balance = period.balance;
+        if (balance.currentAssets === undefined || balance.currentLiabilities === undefined)
+            return null;
+        if (balance.currentLiabilities === 0)
+            return null;
+        return balance.currentAssets / balance.currentLiabilities;
+    };
+    const liquidityNow = currentRatioOf(current);
+    const liquidityPrior = currentRatioOf(prior);
+    signals.push(liquidityNow === null || liquidityPrior === null
+        ? {
+            signal: 'improving current ratio',
+            value: null,
+            detail: 'currentAssets / currentLiabilities, current vs prior',
+            reason: 'currentAssets or currentLiabilities is absent (or zero) in one period',
+        }
+        : {
+            signal: 'improving current ratio',
+            value: binary(liquidityNow > liquidityPrior),
+            detail: `${liquidityNow.toFixed(6)} vs prior ${liquidityPrior.toFixed(6)}`,
+        });
+    const sharesNow = current.income.dilutedSharesOutstanding;
+    const sharesPrior = prior.income.dilutedSharesOutstanding;
+    signals.push(sharesNow === undefined || sharesPrior === undefined
+        ? {
+            signal: 'no net share issuance',
+            value: null,
+            detail: 'dilutedSharesOutstanding, current vs prior',
+            reason: 'dilutedSharesOutstanding is absent in one period',
+        }
+        : {
+            signal: 'no net share issuance',
+            value: binary(sharesNow <= sharesPrior),
+            detail: `${sharesNow} vs prior ${sharesPrior}`,
+        });
+    const marginOf = (period) => {
+        const { grossProfit } = resolveGrossProfit(period.income);
+        if (grossProfit === null || period.income.revenue === 0)
+            return null;
+        return grossProfit / period.income.revenue;
+    };
+    const marginNow = marginOf(current);
+    const marginPrior = marginOf(prior);
+    signals.push(marginNow === null || marginPrior === null
+        ? {
+            signal: 'improving gross margin',
+            value: null,
+            detail: 'grossProfit / revenue, current vs prior',
+            reason: 'gross profit cannot be formed (or revenue is zero) in one period',
+        }
+        : {
+            signal: 'improving gross margin',
+            value: binary(marginNow > marginPrior),
+            detail: `${marginNow.toFixed(6)} vs prior ${marginPrior.toFixed(6)}`,
+        });
+    const turnoverNow = current.income.revenue / prior.balance.totalAssets;
+    const turnoverPrior = prior.income.revenue / priorPrior.balance.totalAssets;
+    signals.push({
+        signal: 'improving asset turnover',
+        value: binary(turnoverNow > turnoverPrior),
+        detail: `revenue / beginning totalAssets: ${turnoverNow.toFixed(6)} vs prior ${turnoverPrior.toFixed(6)}`,
+    });
+    const evaluable = signals.filter((signal) => signal.value !== null);
+    return {
+        assumptions: {
+            model: 'Piotroski F-Score (Piotroski 2000)',
+            returnBasis: 'beginning total assets',
+        },
+        diagnostics: {
+            warnings: signals
+                .filter((signal) => signal.value === null)
+                .map((signal) => `${signal.signal}: ${signal.reason ?? 'not evaluable'}`),
+        },
+        fScore: evaluable.reduce((total, signal) => total + signal.value, 0),
+        evaluableSignals: evaluable.length,
+        signals,
+    };
+}
+const ALTMAN_COEFFICIENTS = {
+    'public-manufacturing': { X1: 1.2, X2: 1.4, X3: 3.3, X4: 0.6, X5: 1.0 },
+    'private-manufacturing': { X1: 0.717, X2: 0.847, X3: 3.107, X4: 0.42, X5: 0.998 },
+    'non-manufacturing': { X1: 6.56, X2: 3.26, X3: 6.72, X4: 1.05 },
+};
+/**
+ * The Altman Z-score with the published coefficients and denominator definitions per variant.
+ * `X1` working capital / assets, `X2` retained earnings / assets, `X3` operating income / assets,
+ * `X4` the variant's equity basis / total liabilities, `X5` sales / assets where the variant has
+ * one. The variant is REQUIRED — there is no default bankruptcy model.
+ */
+export function altmanZScore(input) {
+    requireArgumentObject('altmanZScore', 'input', input);
+    ensureKnownKeys('altmanZScore', 'input', input, ['statements', 'variant', 'marketEquity']);
+    if (input.statements === undefined) {
+        throw new InputError(`altmanZScore: statements is required.`, {
+            code: ErrorCode.InputMissingField,
+            context: { field: 'statements' },
+        });
+    }
+    requireFinancialStatements('altmanZScore', input.statements);
+    if (input.variant !== 'public-manufacturing' &&
+        input.variant !== 'private-manufacturing' &&
+        input.variant !== 'non-manufacturing') {
+        throw new InputError(`altmanZScore: variant must be 'public-manufacturing' | 'private-manufacturing' | 'non-manufacturing' — the model is explicit, never defaulted. Received ${input.variant === null ? 'null' : JSON.stringify(input.variant)}.`, { code: ErrorCode.InputInvalidEnum, context: { field: 'variant' } });
+    }
+    if (input.variant === 'public-manufacturing') {
+        if (input.marketEquity === undefined ||
+            typeof input.marketEquity !== 'number' ||
+            !Number.isFinite(input.marketEquity) ||
+            input.marketEquity <= 0) {
+            throw new InputError(`altmanZScore: marketEquity (a finite amount > 0) is required for the public-manufacturing variant — its X4 uses MARKET equity over total liabilities.`, {
+                code: input.marketEquity === undefined
+                    ? ErrorCode.InputMissingField
+                    : ErrorCode.InputOutOfRange,
+                context: { field: 'marketEquity' },
+            });
+        }
+    }
+    else if (input.marketEquity !== undefined) {
+        throw new InputError(`altmanZScore: marketEquity applies only to the public-manufacturing variant — the ${input.variant} X4 uses BOOK equity, and accepting both would let them disagree silently.`, { code: ErrorCode.InputOutOfRange, context: { field: 'marketEquity' } });
+    }
+    const { balance, income } = input.statements;
+    const assets = balance.totalAssets;
+    if (assets <= 0) {
+        throw new InputError(`altmanZScore: totalAssets must be positive — every Altman component is scaled by assets. Received ${assets}.`, { code: ErrorCode.InputOutOfRange, context: { field: 'statements.balance.totalAssets' } });
+    }
+    if (balance.totalLiabilities <= 0) {
+        throw new InputError(`altmanZScore: totalLiabilities must be positive — X4 divides by it. Received ${balance.totalLiabilities}.`, {
+            code: ErrorCode.InputOutOfRange,
+            context: { field: 'statements.balance.totalLiabilities' },
+        });
+    }
+    const currentAssets = demand('altmanZScore', 'statements.balance', balance.currentAssets, 'currentAssets');
+    const currentLiabilities = demand('altmanZScore', 'statements.balance', balance.currentLiabilities, 'currentLiabilities');
+    const retainedEarnings = demand('altmanZScore', 'statements.balance', balance.retainedEarnings, 'retainedEarnings');
+    const equityBasis = input.variant === 'public-manufacturing' ? input.marketEquity : balance.totalEquity;
+    const coefficients = ALTMAN_COEFFICIENTS[input.variant];
+    const values = {
+        X1: ['working capital / totalAssets', (currentAssets - currentLiabilities) / assets],
+        X2: ['retainedEarnings / totalAssets', retainedEarnings / assets],
+        X3: ['operatingIncome / totalAssets', income.operatingIncome / assets],
+        X4: [
+            `${input.variant === 'public-manufacturing' ? 'market' : 'book'} equity / totalLiabilities`,
+            equityBasis / balance.totalLiabilities,
+        ],
+        X5: ['revenue / totalAssets', income.revenue / assets],
+    };
+    const components = [];
+    let zScore = 0;
+    for (const component of ['X1', 'X2', 'X3', 'X4', 'X5']) {
+        const coefficient = coefficients[component];
+        if (coefficient === undefined)
+            continue; // non-manufacturing has no sales/assets term
+        const [definition, value] = values[component];
+        const contribution = coefficient * value;
+        zScore += contribution;
+        components.push({ component, definition, value, coefficient, contribution });
+    }
+    return requireRepresentableResult('altmanZScore', {
+        assumptions: {
+            model: 'Altman Z-Score',
+            variant: input.variant,
+            equityBasis: input.variant === 'public-manufacturing' ? 'market' : 'book',
+        },
+        diagnostics: { warnings: [] },
+        zScore,
+        variant: input.variant,
+        components,
+    });
+}
+/**
+ * The original eight-variable 1999 Beneish equation
+ * `-4.84 + 0.920 DSRI + 0.528 GMI + 0.404 AQI + 0.892 SGI + 0.115 DEPI - 0.172 SGAI + 4.679 TATA
+ * - 0.327 LVGI`, with the component definitions fixed to the paper. Every variable the model needs
+ * must be present in both periods — there is NO five-variable fallback, silent or otherwise.
+ */
+export function beneishMScore(input) {
+    requireArgumentObject('beneishMScore', 'input', input);
+    ensureKnownKeys('beneishMScore', 'input', input, ['current', 'prior']);
+    for (const field of ['current', 'prior']) {
+        if (input[field] === undefined) {
+            throw new InputError(`beneishMScore: ${field} is required.\n  e.g. beneishMScore({ current, prior })`, { code: ErrorCode.InputMissingField, context: { field } });
+        }
+        requireFinancialStatements('beneishMScore', input[field]);
+    }
+    requireConsecutive('beneishMScore', [['current', input.current, 'prior', input.prior]]);
+    const notes = [];
+    const line = (period, owner) => {
+        const sales = period.income.revenue;
+        if (sales === 0) {
+            throw new InputError(`beneishMScore: ${owner}.income.revenue is zero — four of the eight indices divide by sales.`, { code: ErrorCode.InputOutOfRange, context: { field: `${owner}.income.revenue` } });
+        }
+        let income = period.income.incomeFromContinuingOperations;
+        if (income === undefined) {
+            income = period.income.netIncome;
+            if (owner === 'current') {
+                notes.push('incomeFromContinuingOperations absent — TATA uses netIncome (disclosed substitution, same equation)');
+            }
+        }
+        return {
+            sales,
+            receivables: demand('beneishMScore', `${owner}.balance`, period.balance.accountsReceivable, 'accountsReceivable'),
+            costOfRevenue: demand('beneishMScore', `${owner}.income`, period.income.costOfRevenue, 'costOfRevenue'),
+            currentAssets: demand('beneishMScore', `${owner}.balance`, period.balance.currentAssets, 'currentAssets'),
+            propertyPlantEquipment: demand('beneishMScore', `${owner}.balance`, period.balance.propertyPlantEquipmentNet, 'propertyPlantEquipmentNet'),
+            totalAssets: period.balance.totalAssets,
+            depreciation: demand('beneishMScore', `${owner}.cashFlow`, period.cashFlow.depreciationAndAmortization, 'depreciationAndAmortization'),
+            sellingGeneralAdministrative: demand('beneishMScore', `${owner}.income`, period.income.sellingGeneralAdministrativeExpense, 'sellingGeneralAdministrativeExpense'),
+            longTermDebt: demand('beneishMScore', `${owner}.balance`, period.balance.longTermDebt, 'longTermDebt'),
+            currentLiabilities: demand('beneishMScore', `${owner}.balance`, period.balance.currentLiabilities, 'currentLiabilities'),
+            operatingCashFlow: period.cashFlow.operatingCashFlow,
+            income,
+        };
+    };
+    const now = line(input.current, 'current');
+    const then = line(input.prior, 'prior');
+    notes.push('depreciationAndAmortization stands in for pure depreciation in DEPI (disclosed convention)');
+    const grossMarginOf = (row) => (row.sales - row.costOfRevenue) / row.sales;
+    const softAssetShare = (row) => 1 - (row.currentAssets + row.propertyPlantEquipment) / row.totalAssets;
+    const depreciationRate = (row) => row.depreciation / (row.depreciation + row.propertyPlantEquipment);
+    const leverage = (row) => (row.longTermDebt + row.currentLiabilities) / row.totalAssets;
+    const indices = [
+        [
+            'DSRI',
+            'days-sales-in-receivables index',
+            now.receivables / now.sales / (then.receivables / then.sales),
+            0.92,
+        ],
+        ['GMI', 'gross-margin index', grossMarginOf(then) / grossMarginOf(now), 0.528],
+        ['AQI', 'asset-quality index', softAssetShare(now) / softAssetShare(then), 0.404],
+        ['SGI', 'sales-growth index', now.sales / then.sales, 0.892],
+        ['DEPI', 'depreciation index', depreciationRate(then) / depreciationRate(now), 0.115],
+        [
+            'SGAI',
+            'selling/general/administrative-expense index',
+            now.sellingGeneralAdministrative /
+                now.sales /
+                (then.sellingGeneralAdministrative / then.sales),
+            -0.172,
+        ],
+        [
+            'TATA',
+            'total accruals to total assets',
+            (now.income - now.operatingCashFlow) / now.totalAssets,
+            4.679,
+        ],
+        ['LVGI', 'leverage index', leverage(now) / leverage(then), -0.327],
+    ];
+    const currentEnd = input.current.income.period.periodEndDate;
+    const priorEnd = input.prior.income.period.periodEndDate;
+    const components = indices.map(([index, expandedName, value, coefficient]) => ({
+        index,
+        expandedName,
+        value,
+        coefficient,
+        contribution: coefficient * value,
+        currentPeriodEndDate: currentEnd,
+        priorPeriodEndDate: priorEnd,
+    }));
+    const mScore = -4.84 + components.reduce((total, component) => total + component.contribution, 0);
+    return requireRepresentableResult('beneishMScore', {
+        assumptions: { model: 'Beneish M-Score (Beneish 1999, eight-variable)' },
+        diagnostics: { warnings: [...notes] },
+        mScore,
+        components,
+        notes,
+    });
+}
+//# sourceMappingURL=score-heads.js.map

package/modules/fundamentals/dist/score-heads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"score-heads.js","sourceRoot":"","sources":["../src/score-heads.ts"],"names":[],"mappings":"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"}

package/modules/fundamentals/dist/scores.d.ts

@@ -0,0 +1,6 @@
+/**
+ * `@insiderfinance/totalfinance/fundamentals/scores` — the composite scores (FC2): Piotroski F, Altman Z under its
+ * three published variants, and the original eight-variable Beneish M-score.
+ */
+export * from './score-heads.js';
+//# sourceMappingURL=scores.d.ts.map

package/modules/fundamentals/dist/scores.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scores.d.ts","sourceRoot":"","sources":["../src/scores.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,kBAAkB,CAAC"}

package/modules/fundamentals/dist/scores.js

@@ -0,0 +1,6 @@
+/**
+ * `@insiderfinance/totalfinance/fundamentals/scores` — the composite scores (FC2): Piotroski F, Altman Z under its
+ * three published variants, and the original eight-variable Beneish M-score.
+ */
+export * from './score-heads.js';
+//# sourceMappingURL=scores.js.map

package/modules/fundamentals/dist/scores.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scores.js","sourceRoot":"","sources":["../src/scores.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,kBAAkB,CAAC"}