@finchart

Appearance

Documentation / @finchart/core

@finchart/core ​

조립을 열어 둔 headless 금융 차트 엔진.

설치 ​

아직 npm에 발행 전이다 — 스코프 선점 전이고 버전은 0.0.1이다. 지금 써 보려면 저장소를 클론해 pnpm build 뒤 pnpm pack으로 tarball을 만들어 설치한다(절차는 저장소 루트 README의 "시작하기"에 있다). 아래는 발행 뒤의 모습이다.

sh
pnpm add @finchart/core
  • 계산은 코어가, 픽셀은 네가 — createPlotModel은 DOM·캔버스 없이 돌고 그리기 명령 목록을 낸다. 코어는 런타임도 타입도 DOM을 모른다 — 브라우저 배선(browserDeps + PlotBuilder)은 @finchart/dom이 같은 Plot 위에 얹는 협력자 조합일 뿐이다 (react/react-dom의 관계).
  • 시리즈(캔들·라인·히스토그램·area·baseline·bar), pane, 봉 번호 x축, 실시간 증분(updateLast), 계산 노드, 드로잉·지표는 별도 패키지로.
  • 모든 협력자는 주입이다 — 안 넣으면 그 일을 안 하고, 번들에도 안 들어온다.
ts
// showGrid를 끈다 — 안 끄면 그리드도 drawLine이라 첫 줄이 그리드 선이다.
const model = createPlotModel({
  size,
  series: { series: lineSeries(), data },
  config: { showGrid: false },
});
const [line] = model.commands().filter((c) => c.type === "drawLine");

지원 범위 ​

  • Node 18+ — SSR·worker·테스트가 지나는 headless 경로.
  • 브라우저 — Chrome 98+ · Edge 98+ · Firefox 94+ · Safari 15.4+ (2022-03). 하한을 정하는 것은 structuredClone·Object.hasOwn·Array.prototype.at이고, 폴리필은 싣지 않는다 — 더 낮은 곳을 지원하려면 소비자가 넣는다.
  • 저장소의 개발 환경(Node 24 · pnpm 11)은 이보다 높다. 그것은 기여자의 하한이지 소비자의 것이 아니다.

문서 ​

Classes ​

Interfaces ​

Type Aliases ​

Variables ​

Functions ​