@actuarial-ts/core

中文文档
0.27.0发布于 2026/11/06Apache-2.0TypeScriptES Module零依赖近 30 天下载 2448

TypeScript的纯,零依赖性P&C精算数学:保留,泛定义驱动的诊断,趋势,限制,打折,并有被发布价值验证的种子花样法.

中文使用文档
文档目录5 节
  1. 保持快速启动
  2. 审查执行情况和核查
  3. 一般诊断
  4. 模型、假设和财务含义
  5. 许可证

@ actuarial- ts/ core (帮助)

纯粹,无框架的P&C精算计算:保留模型,开发 模式、诊断指标、财务调整、预测和审查图表.

这个读取器描述 候选人。使用来自 相同的版本软件包集。 无害环境管理,类型脚本第一,节点20+, 没有运行时间依赖.

源寄存器为私用. 仓库用户可以从 docs/sdk-guide.md 财务报告和审定财务报表 docs/migrations/0.27-sdk-cleanup.md 用于安装, 软件包边界和归档/再计算路径。 这些指南不是 包含在 npm 沥青球。 候选文件不是出版物.

保持快速启动

(a) 由于索赔概要,有申报的日期和数额:

import { buildTriangles, computeDevelopmentFactors, runChainLadder, runMack } from "@actuarial-ts/core";

const { paid } = buildTriangles(claimSnapshots, { cadence: "annual", asOfDate: "2025-12-31" });
const selected = computeDevelopmentFactors(paid).averages.find((item) => item.spec.key === "all-wtd")!.values;
const chainLadder = runChainLadder(paid, { selected, tailFactor: 1.02 });
const mack = runMack(paid, { selected, tailFactor: 1.02 });

不可观察的三角单元格为 null. 量加权因子使用和/和 在有两种观测结果的行上。 CDFs从右到左相乘,尾相乘为后相乘. 缺少、零分数或负分数产生无法获取的因素,而不是 NaN。 。 。 . 真正的累积发展年龄为0; 缺少正- 年龄 观测结果仍然缺失。 源标签, 如 "0" 是一个普通的标签.

使用 runModel 对于连接的模型合同:它保留了打出的数量, 来源参考、假设、调查结果和现有的不确定性。 土著 内核等 runChainLadder 仍然有助于直接计算.

审查执行情况和核查

A 类 ReviewPlan 将输入、依赖、操作和指定产出绑定在一起. 审定计划:

import {
  runReviewPlan,
  verifyReviewPlanRun,
  replayReviewPlanRun,
  REVIEW_PLAN_VERIFICATION_LIMITS,
} from "@actuarial-ts/core";

const run = runReviewPlan(plan);
const verification = verifyReviewPlanRun({
  run,
  limits: REVIEW_PLAN_VERIFICATION_LIMITS,
});
// Explicitly execute the graph again, even for this exact live run:
const replay = replayReviewPlanRun({ run, limits: REVIEW_PLAN_VERIFICATION_LIMITS });

verifyReviewPlanRun 保存精确真实的当前进程执行; 导入或复制运行必须通过当前- SDK 执行复制 。 两条路径 请检查date=中的日期值 (帮助). ReviewPlanVerification.assurance.calculations 记录 executed-current-sdk 或者说 replayed-current-sdk。重新执行相同的 SDK 是可复制的证据,而不是独立的精算验证. isVerifiedReviewPlan 仅确认这一过程签发的收据.

encodeReviewEvidence 财务报告和审定财务报表 decodeReviewEvidence 使用情况 actuarial-review-evidence-graph/3共享JSON运输不准许执行 或源权威。 实物图表限制适用于实际保留的工作。 明确 树序化有其自身的扩展约束; 普通图属属性有 不扩大共享儿童. canonicalJsonEqual 比较完整的教条内容; 结构共享不是允许跳过验证或仅依赖散列.

一般诊断

申报数量、单位、开发语义、缺失和 人口/基准含义。 公式实例将类型角色与这些措施挂钩; 列报和审查规则与算术身份无关. 以下措施采用呼叫者授权的措施、人口、基准和期限政策:

import {
  CASUALTY_FORMULA_TEMPLATES,
  compileDiagnosticDefinition,
  createCasualtyMetricInstances,
  prepareDiagnosticData,
  runMetricDiagnostics,
} from "@actuarial-ts/core";

const instances = createCasualtyMetricInstances({
  counts: { reported: "reported", open: "open", closedNoPay: "closed-no-pay", closedWithPay: "closed-with-pay" },
  exposure: "earned-vehicle-years",
  amountBindings: [
    { id: "gross", paid: "gross-paid", incurred: "gross-incurred" },
    { id: "primary-250k", paid: "primary-paid", incurred: "primary-incurred" },
  ],
});

const compiled = compileDiagnosticDefinition({
  diagnosticDefinitionVersion: "1.0.0",
  id: "fleet-diagnostics",
  version: "1.0.0",
  lossRowGrain: "aggregate",
  measures,
  countPopulations,
  exposureBases,
  amountBases,
  derivedMeasures: [],
  formulas: CASUALTY_FORMULA_TEMPLATES,
  instances,
  reviewRules,
  periodAxis,
});

const prepared = prepareDiagnosticData({ definition: compiled, losses, exposures });
const result = runMetricDiagnostics({ prepared, groupMap: { fleet: "all-fleet" } });

源组/原产地/估价汇总和明确组别之后的分量 测绘. 接触时间宣布为 origin-static 或者说 valuation-specific。 。 。 . 合并前适用索赔水平上限;预先限定的源值必须 保留其宣布的转变,不能意味着重新产生索赔细节. 汇编验证了完整的定义,依赖性和周期坐标.

选择匹配准备、计算和到期函数 :

运行没收证据契约证据
准备prepareDiagnosticDataprepareDiagnosticDataCompact
计算runMetricDiagnosticsrunMetricDiagnosticsCompact
选择开发时代sameMaturitysameMaturityCompact
最近共同年龄commonMaturitycommonMaturityCompact

契约所有者保留完整的审计证据。 审查评价及其评价 来源为 pageDiagnosticReviewEvaluations 财务报告和审定财务报表 pageDiagnosticReviewEvaluationSources;呼号不是采样. 物质化 明确扩展证据,并可能使用更多的内存。 副本和 解析的 JSON 无法重新创建已编译/准备的正版所有者 . 对于输入的数据和审查/执行闸门,请在 @actuarial-ts/data。 。 。 .

模型、假设和财务含义

  • 保留包括链式阶梯、麦克、BF、本克坦德、科德角、预期索赔、, 频率高度 慕尼黑链状梯子 案件突出 费舍尔 -朗格 克拉克, ODP靴子和Merz-Wüthrich一年的风险。 可得性和不确定性 具体方法;检查结果结果.
  • selectDevelopmentPattern 将明确的平均/尾部意图约束在本地 证据. createSelectedEstimateRange 记录人类选定的终点和 理由;这是一个非概率范围.
  • 连通调整包括平面/趋势、上限/ILF、ULAE、, 名义现金流量和有明确来源、日期和数量的贴现. createModelForecast 财务报告和审定财务报表 scoreModelForecast 保存已冷冻的预测值 并区分以后的重述与实际出现.

AnalysisDefinition.financialTermSchedules 解决已宣布的事故/报告/日期 超过全部索赔、发生数或政策数。 开始是包容性的, 结束独占;没有同等优先的匹配。 列表边界确实如此 不创建新的可扣除或推断的年度重排。 使用 createFinancialTermScheduleBinding 各种排期限制和 deriveRecipeFinancialBasis 从确认的输出中获取支持的输出含义 输入基础。 这些声明没有认证外部来源的事实.

公布的源定着物和独立比较是数字合同. 一揽子计划旨在支持精算师遵守ASOP; 它不能使工作产品符合要求或取代专业判断.

许可证

阿帕奇2.0,见LICENSE和NOTICE。 源寄存器为私有 已发布软件包保留其Apache-2.0许可证.

版本与发布记录

@actuarial-ts/core 共发布 28 个版本,首次发布于 2026/07/17;过去 12 个月发布了 28 个版本。

版本发布日期距今
0.27.0latest2026/11/062 天前
0.23.02026/10/2216 天前
0.22.12026/10/1919 天前
0.22.02026/10/1029 天前
0.21.02026/10/071 个月前
0.20.02026/10/031 个月前

关于 @actuarial-ts/core 的常见问题

@actuarial-ts/core 是什么?

TypeScript的纯,零依赖性P&C精算数学:保留,泛定义驱动的诊断,趋势,限制,打折,并有被发布价值验证的种子花样法.

如何安装 @actuarial-ts/core?

在项目目录运行 npm install @actuarial-ts/core,或使用 pnpm add / yarn add / bun add。

@actuarial-ts/core 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@actuarial-ts/core 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@actuarial-ts/core 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@actuarial-ts/core 可以商用吗?

@actuarial-ts/core 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@actuarial-ts/core 的下载量有多少?

根据 npm 官方下载统计,@actuarial-ts/core 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,448 次,日均约 82 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@actuarial-ts/core 还在维护吗?

最新版本 0.27.0 发布于 2026/11/06(2 天前);至今共发布 28 个版本,其中过去 12 个月发布了 28 个;首次发布于 2026/07/17。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。