For AI agents: the complete documentation index is available at /hwpjs/llms.txt, the full documentation bundle is available at /hwpjs/llms-full.txt, and this page is available as Markdown at /hwpjs/guide/package-names.md.
HWPJS
HWP5 · HWPX

패키지 이름과 게시 상태

공개 배포 이름은 @ohah/hwpjs이며, Zig/WASM 공통 엔진을 포함한 0.1.1을 사용합니다. 내부 개발 workspace 이름과 이전 RC의 API를 현재 공개 API와 구분합니다.

대상현재 상태사용 시 주의
@ohah/hwpjs@0.1.1공개 npm 패키지. 공통 SDK·CLI·stdio MCP·WASM과 공개 타입 선언 포함Node.js 24.20 이상, ESM. 아래 공개 진입점 사용
@ohah/hwpjs@0.1.0-rc.10이전 Rust/NAPI·WASI 변환 패키지0.1.0의 createEditor·typed command API와 호출 형태가 다름
@hwpjs/core, @hwpjs/vanilla, @hwpjs/react, @hwpjs/svelte 등내부 개발 workspace 이름외부 프로젝트에서는 @ohah/hwpjs의 공개 하위 경로 사용

공개 설치

문서를 다룰 프로젝트 디렉터리에서 실행합니다.

npm install @ohah/hwpjs
npx hwpjs --help
npx hwpjs mcp

추가 설치 옵션이나 별도 MCP 패키지는 필요하지 않습니다. React·Svelte·React Native 어댑터를 사용한다면 해당 peer도 준비합니다. CLI 가이드와 MCP 가이드의 명령은 이 공개 버전을 기준으로 합니다. 이전 설치분은 자동 갱신되지 않습니다.

이전 0.1.0은 인증 없는 새 소비자와 새 캐시에서 실제 공개 레지스트리 설치를 확인했습니다. 레지스트리 tarball 무결성과 설치 파일 110개가 준비한 릴리스와 일치했고, 설치된 CLI의 도움말·HWPX 생성·Noori HWP5 편집/재열기 및 실제 MCP 버전 0.1.0·12도구 목록을 확인했습니다. 이 확인은 모든 문서·기능·플랫폼의 검증 완료를 뜻하지 않습니다.

공개 진입점

내부 모노레포의 core·Vanilla·React·Svelte·React Native 분리는 유지하며, 외부에는 단일 패키지와 다음 하위 경로를 제공합니다.

import 경로의미
@ohah/hwpjscanonical core API
@ohah/hwpjs/runtimeReader/Worker runtime과 WASM loader
@ohah/hwpjs/worker, @ohah/hwpjs/wasm배포된 Worker/WASM asset export
@ohah/hwpjs/vanillaCanvas surface
@ohah/hwpjs/reactReact adapter, 선택적인 React peer 필요
@ohah/hwpjs/svelteSvelte adapter, 선택적인 Svelte peer 및 SSR 경계 필요
@ohah/hwpjs/react-nativeNative provider 기반 JavaScript 경계; 기기 연결·검증 별도
@ohah/hwpjs/react-native/canvas별도 Native Canvas 연결 경계; 기기 바이너리를 자동 설치하지 않음

core의 canonical 경로는 루트 @ohah/hwpjs입니다. @ohah/hwpjs/core는 0.1.0의 export가 아니며, @ohah/hwpjs-react 같은 별도 이름으로 어댑터를 설치하지 않습니다. 이전 rc.10의 export와 함수 계약을 현재 하위 경로에 그대로 적용하지 마세요.

0.1.1부터 hwpjs mcp가 같은 패키지의 MCP 서버를 실행합니다. 기존 hwpjs-mcp 실행 파일도 호환성을 위해 유지합니다. 설치된 bin은 TypeScript 원문이 아닌 독립 JavaScript이며, 인접한 WASM 한 벌을 사용합니다. SDK root/runtime import는 React/Svelte 설치나 DOM 접근을 요구하지 않습니다. /worker는 Worker 환경 전용으로 일반 Node main에서 직접 실행하는 파일이 아닙니다.

설치와 브라우저 체험의 구분

공개 API 직접 실행과 문서 체험은 각각 배포에 포함된 동결 소스·WASM을 사용합니다. npm 공개 설치는 별도로 확인된 경로이며, 브라우저가 설치된 Node CLI나 실제 stdio 서버를 실행하는 것은 아닙니다. 0.1.1의 새 기능을 이전 0.1.0 설치본에도 포함됐다고 간주하지 않습니다.