개요
예측 가능한 상태 관리를 위한 프레임워크 독립적인 기초 스토어입니다.
@ilokesto/store는 ilokesto 에코시스템의 핵심 프리미티브 중 하나입니다. 신뢰성과 성능을 위해 설계된 최소한의, 동기식이며 프레임워크 독립적인 스토어 구현을 제공합니다.
에코시스템의 다른 패키지들이 프레임워크 바인딩이나 복잡한 상태 관리 패턴을 제공하는 것과 달리, store는 상태의 보관, 업데이트, 그리고 알림이라는 기본 계약에 집중하는 가벼운 기반으로 남습니다.
설치
npm install @ilokesto/store특징
- 기초적(Foundational): 상태 저장을 위한 최소한의 프리미티브 세트입니다.
- 프레임워크 독립적(Framework-agnostic): 모든 자바스크립트 환경(Node.js, Browser, Deno 등)에서 작동합니다.
- 동기식(Synchronous): 상태 업데이트와 알림이 즉시 발생합니다.
- 예측 가능함(Predictable): 표준
Object.is체크와 불변성 패턴을 사용합니다.
무엇이 아닌가
- 프레임워크 바인딩이 아님: React hook이나 Vue composable을 포함하지 않습니다.
- 데이터 페칭 라이브러리가 아님: 서버 캐시나 로딩 상태를 관리하지 않습니다.
- 멀티 스토어 오케스트레이터가 아님: 단일 상태 원자(atom)를 관리합니다.
빠른 예제
import { Store } from "@ilokesto/store";
const store = new Store({ count: 0 });
// 변경 구독
const unsubscribe = store.subscribe(() => {
console.log("상태 변경됨:", store.getState());
});
// 상태 업데이트
store.setState({ count: 1 });
// 정리
unsubscribe();언제 사용하나
- 사용자에게 프레임워크 의존성을 강요하지 않고 내부 상태 관리가 필요한 라이브러리를 구축할 때.
- 바닐라 자바스크립트 또는 타입스크립트 프로젝트를 위한 단순하고 신뢰할 수 있는 상태 컨테이너가 필요할 때.
- 더 높은 수준의 라이브러리, 어댑터, 도메인 전용 상태 계층을 구축하는 기반으로 사용할 때.
여기서 시작하기
- 빠른 시작: 설치부터 유용한 store 하나를 빠르게 만드는 경로
- 멘탈 모델: 왜 이 패키지가 작고 동기적으로 유지되는지 설명
- API 레퍼런스:
Store클래스의 정확한 공개 표면