gaesup-world 1.0.32 → 1.2.0

package/README.ko.md

@@ -1,34 +1,26 @@
 # gaesup-world
 
-브라우저에서 플레이 가능한 3D 방을 만들고, React에서 사용하고, Unity와 배치를 주고받는 라이브러리입니다.
+React Three Fiber용 TypeScript 3D 월드 라이브러리입니다. WebGPU 우선 렌더링, 물리 캐릭터, 건축, NPC, 멀티플레이, 저장 가능한 월드 모델을 제공하고 Unity와 장면 데이터를 주고받습니다.
 
-[미니홈피 바로 사용하기](https://jigglypop.github.io/gaesup-world/) · [English](README.md) · [미니홈피 사용법](docs/minihome.md) · [Unity 연결](docs/unity.md)
+[데모 바로 보기](https://jigglypop.github.io/gaesup-world/) · [문서](docs/README.md) · [시작하기](docs/guide/getting-started.md) · [English](README.md)
 
-TypeScript 월드 라이브러리와 싸이월드에서 영감을 받은 미니홈피 예제를 제공합니다. 3D 방, 걸어 다니는 아바타, 가구 편집, 프로필, 다이어리, 방명록이 있습니다. 현재 브라우저에 저장하며 공유 링크는 방의 사본을 전달합니다. 실시간 멀티플레이 서비스는 아닙니다.
+이번 버전은 `1.1.0`입니다. 게시 여부는 npm registry에서 확인하세요.
 
-이번 버전은 `1.0.32`입니다. 게시 여부는 npm registry에서 확인하세요.
-
-## 실행하기
+## 예제 실행
 
 ```sh
 corepack pnpm install
 corepack pnpm dev --host 127.0.0.1 --port 5174
 ```
 
-http://127.0.0.1:5174/ 를 여세요. `/engine`은 별도 렌더링 쇼케이스입니다. 미니홈피 체험에는 모델 URL, AI 키, Unity 설치가 필요하지 않습니다.
-
-1. **미니룸 꾸미기**에서 가구를 추가하거나 드래그로 이동합니다.
-2. 프로필과 테마를 바꿉니다. 실행 취소는 방과 글을 함께 다룹니다.
-3. 변경은 1.2초 뒤 자동저장됩니다. **미니홈피 저장**은 즉시 저장합니다.
-4. JSON 파일 백업을 내려받거나 이전 정상 저장본을 복구합니다.
-5. 방과 프로필 사본을 공유하거나 보이는 방을 GLB로 내보냅니다.
+http://127.0.0.1:5174/ 를 여세요. `examples/minihome`은 공개 API(`GaesupWorld`, `WorldPhysics`, `GaesupController`, `BuildingController`, 배회하는 NPC)만으로 작은 마을을 만듭니다. WASD로 걷습니다.
 
 ## 라이브러리 사용
 
 React 19 앱에서 서로 맞는 의존성 조합:
 
 ```sh
-npm install gaesup-world react@19 react-dom@19 three@0.185 three-stdlib @react-three/fiber@9 @react-three/drei@10 @react-three/rapier@2 @react-three/postprocessing@3
+npm install gaesup-world react@19 react-dom@19 three@0.186 three-stdlib @react-three/fiber@9 @react-three/drei@10 @react-three/rapier@2 @react-three/postprocessing@3
 ```
 
 React 18/Fiber 8도 peer 범위에 포함되지만 별도 소비 검증이 필요합니다.
@@ -52,17 +44,16 @@ SceneDocument는 저장 가능한 데이터입니다. React·Three.js·물리
 
 ## Unity
 
-프리뷰의 `exportUnityScene`과 `importUnityScene`은 로컬 transform, 계층, ID, component 메타데이터를 교환합니다. 미터 단위, quaternion, Z축 변환을 사용합니다. 포함된 Unity Editor 스크립트가 이 JSON을 읽고 씁니다. GLB는 geometry와 material을 내보냅니다. 임의의 게임 스크립트나 네이티브 `.unity` 파일을 자동 호환하지 않습니다. [설치와 제한](docs/unity.md).
+프리뷰의 `exportUnityScene`과 `importUnityScene`은 로컬 transform, 계층, ID, component 메타데이터를 교환합니다. 미터 단위, quaternion, Z축 변환을 사용합니다. 포함된 Unity Editor 스크립트가 이 JSON을 읽고 씁니다. GLB는 geometry와 material을 내보냅니다. 임의의 게임 스크립트나 네이티브 `.unity` 파일을 자동 호환하지 않습니다.
 
 ## 검증과 배포
 
 ```sh
 corepack pnpm run verify:full
-corepack pnpm run test:minihome:browser
 corepack pnpm run build:demo
 ```
 
-브라우저 검증은 5174 포트 dev server와 로컬 Chrome을 사용하며 WebGPU와 WebGL2를 따로 확인합니다. `test:demo`는 빌드 구조 검사로, 실제 화면 검증을 대신하지 않습니다.
+`test:demo`는 빌드 구조 검사로, 실제 화면 검증을 대신하지 않습니다.
 
 `npm run deploy`는 `demo-dist`를 빌드해 GitHub Pages에 배포합니다. 다른 경로에서는 `GAESUP_BASE_URL`을 지정하세요. `version.json`은 버전·커밋·미커밋 변경 여부·시각을 기록합니다. Pages의 깊은 경로는 `404.html`로 열리지만 HTTP 404일 수 있습니다.
 
@@ -70,9 +61,6 @@ npm은 검증과 `npm login` 인증 후, 검토한 tarball을 별도 태그 없
 
 ## 현재 제한
 
-- 미니홈피에 계정 로그인, 기기 간 저장, 실시간 방문, 공동 편집이 없습니다.
-- 공유 링크에는 다이어리·방명록이 없으며 링크 소유자는 프로필과 방을 읽을 수 있습니다.
 - shear는 world matrix에 보존합니다. TRS로 표현 불가능하면 `getWorldTransform`이 오류를 내므로 `getWorldMatrix`를 사용하세요.
 - Unity Editor 컴파일과 실제 왕복은 Unity 설치 환경에서 따로 검증해야 합니다.
 
-[실행계획](docs/2026-09-19-web-studio-plan.md) · [릴리스 노트](docs/release-1.0.32.md)

package/README.md

@@ -1,34 +1,26 @@
 # gaesup-world
 
-Build a playable 3D room in your browser. Use scene data in React and exchange layouts with Unity.
+A TypeScript 3D world library for React Three Fiber: WebGPU-first rendering, physics characters, building, NPCs, multiplayer and a persistent world model. Scene data can be exchanged with Unity.
 
-[Live mini-home](https://jigglypop.github.io/gaesup-world/) · [한국어](README.ko.md) · [Mini-home guide](docs/minihome.en.md) · [Unity bridge](docs/unity.en.md)
+[Live demo](https://jigglypop.github.io/gaesup-world/) · [Docs (Korean)](docs/README.md) · [Getting started](docs/guide/getting-started.md) · [한국어](README.ko.md)
 
-This repository contains a TypeScript world library and a Cyworld-inspired mini-home: a 3D room, walking avatar, furniture, profile, diary and guestbook. It saves in your browser. Shared links contain a snapshot; they are not a multiplayer service.
+This release is `1.1.0`. Check the npm registry for publication status.
 
-This release is `1.0.32`. Check the npm registry for publication status.
-
-## Run the mini-home
+## Run the example
 
 ```sh
 corepack pnpm install
 corepack pnpm dev --host 127.0.0.1 --port 5174
 ```
 
-Open http://127.0.0.1:5174/. The separate rendering showcase is at `/engine`. No model URL, AI key or Unity installation is needed. The UI is currently Korean; the English guide maps its buttons to their actions.
-
-1. Choose **미니룸 꾸미기** (Edit room), add furniture and drag it.
-2. Edit your profile and theme. Undo/redo covers room and notes together.
-3. Changes autosave after 1.2 seconds. **미니홈피 저장** saves immediately.
-4. Download a JSON backup or recover the previous valid save.
-5. Share the profile and room snapshot, or export the visible room as GLB.
+Open http://127.0.0.1:5174/. `examples/minihome` builds a small village with the public API only: `GaesupWorld`, `WorldPhysics`, `GaesupController`, `BuildingController` and wandering NPCs. Walk with WASD.
 
 ## Use the library
 
 A matching React 19 peer set:
 
 ```sh
-npm install gaesup-world react@19 react-dom@19 three@0.185 three-stdlib @react-three/fiber@9 @react-three/drei@10 @react-three/rapier@2 @react-three/postprocessing@3
+npm install gaesup-world react@19 react-dom@19 three@0.186 three-stdlib @react-three/fiber@9 @react-three/drei@10 @react-three/rapier@2 @react-three/postprocessing@3
 ```
 
 React 18/Fiber 8 are also declared peers, but that combination needs separate consumer validation.
@@ -52,17 +44,16 @@ Scene data is serializable. React, Three.js and physics objects belong to runtim
 
 ## Unity
 
-The preview adds `exportUnityScene` and `importUnityScene`: local transforms, hierarchy, IDs and component metadata, in meters, with quaternion and Z-axis conversion. Included Unity Editor scripts read/write this JSON. GLB exports geometry and materials for compatible importers. Neither path transfers arbitrary scripts or imports native `.unity` files. [Setup and limits](docs/unity.en.md).
+The preview adds `exportUnityScene` and `importUnityScene`: local transforms, hierarchy, IDs and component metadata, in meters, with quaternion and Z-axis conversion. Included Unity Editor scripts read/write this JSON. GLB exports geometry and materials for compatible importers. Neither path transfers arbitrary scripts or imports native `.unity` files.
 
 ## Verify and deploy
 
 ```sh
 corepack pnpm run verify:full
-corepack pnpm run test:minihome:browser
 corepack pnpm run build:demo
 ```
 
-The browser probe expects the dev server on 5174 and local Chrome; WebGPU and WebGL2 fallback are separate checks. `test:demo` checks build structure, not rendering.
+`test:demo` checks build structure, not rendering.
 
 `npm run deploy` builds `demo-dist` and publishes it to GitHub Pages. Override `GAESUP_BASE_URL` for another base path. `version.json` records version, commit, dirty state and build time. Pages deep links use `404.html`; an unknown route may render while retaining HTTP 404.
 
@@ -70,9 +61,6 @@ For npm, validate, authenticate with `npm login`, pack the reviewed build and ru
 
 ## Current limits
 
-- No account login, cross-device save, live visits or collaborative editing in the mini-home.
-- Shared links omit diary/guestbook entries; anyone holding the link can read its profile and room.
 - World matrices preserve shear. `getWorldTransform` throws for shear or singular bases; use `getWorldMatrix` when TRS cannot represent the result.
 - Unity compilation and real Editor round-trip require a Unity installation. TypeScript tests alone do not prove them.
 
-[Implementation plan](docs/2026-09-19-web-studio-plan.en.md) · [Release notes](docs/release-1.0.32.md)