gaesup-world 1.0.30 → 1.0.31

package/LICENSE.txt

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2024 jigglypop
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2024 jigglypop
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ko.md

@@ -0,0 +1,78 @@
+# gaesup-world
+
+브라우저에서 플레이 가능한 3D 방을 만들고, React에서 사용하고, Unity와 배치를 주고받는 라이브러리입니다.
+
+[미니홈피 바로 사용하기](https://jigglypop.github.io/gaesup-world/) · [English](README.md) · [미니홈피 사용법](docs/minihome.md) · [Unity 연결](docs/unity.md)
+
+TypeScript 월드 라이브러리와 싸이월드에서 영감을 받은 미니홈피 예제를 제공합니다. 3D 방, 걸어 다니는 아바타, 가구 편집, 프로필, 다이어리, 방명록이 있습니다. 현재 브라우저에 저장하며 공유 링크는 방의 사본을 전달합니다. 실시간 멀티플레이 서비스는 아닙니다.
+
+이번 버전은 `1.0.31`입니다. 게시 여부는 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로 내보냅니다.
+
+## 라이브러리 사용
+
+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
+```
+
+React 18/Fiber 8도 peer 범위에 포함되지만 별도 소비 검증이 필요합니다.
+
+```ts
+import { createSceneDocument, createSceneDocumentController } from 'gaesup-world';
+
+const controller = createSceneDocumentController(createSceneDocument({
+  id: 'my-room',
+  objects: [{ id: 'chair', name: 'Chair' }],
+}));
+controller.dispatch({
+  type: 'scene-object.update',
+  objectId: 'chair',
+  patch: { transform: { position: [2, 0, 0] } },
+});
+const savedScene = JSON.stringify(controller.getSnapshot());
+```
+
+SceneDocument는 저장 가능한 데이터입니다. React·Three.js·물리 객체는 실행 시 사용하는 표현입니다. 변경은 document controller를 통과합니다. `gaesup-world/editor`로 편집 UI를 사용할 수 있지만 범용 Studio 전체는 아직 개발 중입니다.
+
+## Unity
+
+프리뷰의 `exportUnityScene`과 `importUnityScene`은 로컬 transform, 계층, ID, component 메타데이터를 교환합니다. 미터 단위, quaternion, Z축 변환을 사용합니다. 포함된 Unity Editor 스크립트가 이 JSON을 읽고 씁니다. GLB는 geometry와 material을 내보냅니다. 임의의 게임 스크립트나 네이티브 `.unity` 파일을 자동 호환하지 않습니다. [설치와 제한](docs/unity.md).
+
+## 검증과 배포
+
+```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`는 빌드 구조 검사로, 실제 화면 검증을 대신하지 않습니다.
+
+`npm run deploy`는 `demo-dist`를 빌드해 GitHub Pages에 배포합니다. 다른 경로에서는 `GAESUP_BASE_URL`을 지정하세요. `version.json`은 버전·커밋·미커밋 변경 여부·시각을 기록합니다. Pages의 깊은 경로는 `404.html`로 열리지만 HTTP 404일 수 있습니다.
+
+npm은 검증과 `npm login` 인증 후, 검토한 tarball을 별도 태그 없이 `npm publish <tarball>`로 배포합니다.
+
+## 현재 제한
+
+- 미니홈피에 계정 로그인, 기기 간 저장, 실시간 방문, 공동 편집이 없습니다.
+- 공유 링크에는 다이어리·방명록이 없으며 링크 소유자는 프로필과 방을 읽을 수 있습니다.
+- shear는 world matrix에 보존합니다. TRS로 표현 불가능하면 `getWorldTransform`이 오류를 내므로 `getWorldMatrix`를 사용하세요.
+- Unity Editor 컴파일과 실제 왕복은 Unity 설치 환경에서 따로 검증해야 합니다.
+
+[실행계획](docs/2026-09-19-web-studio-plan.md) · [릴리스 노트](docs/release-1.0.31.md)

package/README.md

@@ -1,346 +1,78 @@
-# Gaesup World
-
-[![Version](https://img.shields.io/npm/v/gaesup-world?style=flat-square&logo=npm&logoColor=white&labelColor=000000&color=blue)](https://www.npmjs.com/package/gaesup-world)
-[![Downloads](https://img.shields.io/npm/dt/gaesup-world.svg?style=flat-square&logo=npm&logoColor=white&labelColor=000000&color=blue)](https://www.npmjs.com/package/gaesup-world)
-
-![Gaesup World 메인 이미지](https://signightbackend.s3.ap-northeast-2.amazonaws.com/images/gemini/image/1776774136799_88c802b2359c.jpg)
-
-`Gaesup World`는 `React Three Fiber`, `Three.js`, `Rapier`, `Zustand` 기반으로 만든 웹 3D 월드/게임 라이브러리입니다. 캐릭터 이동, 카메라, 상호작용, 건설, 애니메이션, 네트워크, 인벤토리, 퀘스트, 날씨, 타운 시스템처럼 월드 게임에 필요한 기능을 도메인 단위로 제공합니다.
-
-이 저장소는 두 가지 역할을 함께 가집니다.
-
-- `src/`: 실제 배포되는 라이브러리 코드
-- `examples/`: 라이브러리를 사용하는 데모 앱
-
-## 현재 상태
-
-- 패키지명: `gaesup-world`
-- 문서 기준 import 엔트리: `gaesup-world`
-- 라이브러리 ESM 빌드: 확인 완료
-- 데모 Vite 빌드: 확인 완료
-- Jest 테스트: 통과
-- TypeScript declaration build: 통과
-
-즉, 런타임, 번들, 타입 선언 빌드 기준으로는 사용 가능한 상태입니다.
-
-## 설치
-
-앱에서 사용할 때는 `gaesup-world`와 3D 런타임 peer dependency를 함께 설치합니다. React, Three.js, React Three Fiber는 앱 쪽에서 직접 버전을 관리하는 것이 안전합니다.
-
-```bash
-npm install gaesup-world three react react-dom @react-three/fiber @react-three/drei @react-three/rapier
-```
-
-또는
-
-```bash
-yarn add gaesup-world three react react-dom @react-three/fiber @react-three/drei @react-three/rapier
-```
-
-또는
-
-```bash
-pnpm add gaesup-world three react react-dom @react-three/fiber @react-three/drei @react-three/rapier
-```
-
-선택 기능을 쓰는 경우에는 아래 패키지도 앱에 설치해 주세요.
-
-- 후처리: `@react-three/postprocessing`
-- 관리자 라우팅: `react-router-dom`
-- 아이콘 UI: `react-icons`
-- Rapier 직접 연동: `@dimforge/rapier3d`, `@dimforge/rapier3d-compat`
-
-## 빠른 시작
-
-가장 기본적인 사용 예시는 아래와 같습니다.
-
-```tsx
-import { Canvas } from '@react-three/fiber';
-import { Physics } from '@react-three/rapier';
-import { GaesupController, GaesupWorld } from 'gaesup-world';
-
-const CHARACTER_URL = 'https://your-cdn.example.com/character.glb';
-
-export default function App() {
-  return (
-    <GaesupWorld
-      urls={{ characterUrl: CHARACTER_URL }}
-      mode={{ type: 'character', controller: 'keyboard', control: 'thirdPerson' }}
-    >
-      <Canvas shadows camera={{ position: [0, 6, 10], fov: 50 }}>
-        <Physics>
-          <GaesupController />
-        </Physics>
-      </Canvas>
-    </GaesupWorld>
-  );
-}
-```
-
-## 핵심 개념
-
-### 런타임과 플러그인
-
-`createGaesupRuntime`은 카메라, 모션, 저장, NPC, 경제, 날씨 같은 도메인 플러그인을 한곳에 묶는 런타임 팩토리입니다. 앱이 필요한 도메인만 골라 붙일 수 있고, 각 플러그인은 서비스, 시스템, 저장 도메인, UI 확장을 등록합니다.
-
-```ts
-import {
-  createGaesupRuntime,
-  createBuildingPlugin,
-  createCameraPlugin,
-  createInventoryPlugin,
-} from 'gaesup-world';
-
-const runtime = createGaesupRuntime({
-  plugins: [
-    createCameraPlugin(),
-    createBuildingPlugin(),
-    createInventoryPlugin(),
-  ],
-});
-
-await runtime.setup();
-```
-
-### 월드 설정
-
-`GaesupWorld`는 월드 관련 설정을 store에 주입하는 루트 컴포넌트입니다.
-
-- `urls`: 캐릭터/차량/비행기 모델 URL
-- `mode`: 플레이어 타입, 입력 방식, 카메라 제어 방식
-- `cameraOption`: 카메라 세부 옵션
-
-내부적으로는 `WorldContainer` 또는 `WorldConfigProvider` 역할을 감싼 공개 API입니다.
-
-### 플레이어 제어
-
-`GaesupController`는 캐릭터/엔티티 조작을 담당하는 기본 컨트롤러입니다.
-
-- 키보드 이동
-- 클릭 이동
-- 상호작용 시스템 연결
-- 이동/상태 브리지 연결
-
-### 도메인 기반 구조
-
-주요 기능은 도메인 단위로 분리되어 있습니다.
-
-- `animation`
-- `camera`
-- `motions`
-- `interactions`
-- `world`
-- `building`
-- `networks`
-- `time`
-- `save`
-- `inventory`
-- `items`
-- `quests`
-- `weather`
-- `town`
-- `audio`
-- `npc`
-- `blueprints`
-- `admin`
-
-### 저장 시스템
-
-새 기능은 `SaveSystem` 중심으로 저장 도메인을 등록하는 흐름을 권장합니다. 같은 key를 중복 등록하면 에러가 나도록 보호되어 있어, 여러 런타임이나 플러그인이 같은 저장 슬롯을 조용히 덮어쓰는 일을 피할 수 있습니다.
-
-```ts
-import { SaveSystem } from 'gaesup-world';
-
-const unregister = saveSystem.register({
-  key: 'inventory',
-  serialize: () => ({ items: [] }),
-  hydrate: (data) => {
-    // restore your store here
-  },
-});
-
-unregister();
-```
-
-`SaveLoadManager`는 legacy world save와 파일 import/export helper로 남아 있습니다. `compress: true` 저장은 gzip 지원 브라우저에서는 gzip payload를 사용하고, 저장 목록에서도 timestamp와 metadata를 읽을 수 있습니다.
-
-## 자주 쓰는 공개 API
-
-대표적으로 아래 항목들을 루트 엔트리에서 바로 import 할 수 있습니다.
-
-```tsx
-import {
-  GaesupWorld,
-  GaesupController,
-  WorldContainer,
-  WorldConfigProvider,
-  BuildingUI,
-  InventoryUI,
-  QuestLogUI,
-  DialogBox,
-  WeatherEffect,
-  useInventoryStore,
-  useQuestStore,
-  useWeatherStore,
-  useGameTime,
-  getItemRegistry,
-  getNPCScheduler,
-} from 'gaesup-world';
-```
-
-블루프린트 런타임 관련 API도 루트 엔트리에서 바로 사용할 수 있습니다.
-
-```tsx
-import {
-  BlueprintSpawner,
-  blueprintRegistry,
-  BlueprintFactory,
-} from 'gaesup-world';
-```
-
-관리자 UI와 블루프린트 편집 UI는 별도 subpath를 사용합니다.
-
-```tsx
-import { GaesupAdmin, useAuthStore } from 'gaesup-world/admin';
-import { BlueprintEditor } from 'gaesup-world/blueprints/editor';
-```
-
-## Admin 사용법
-
-관리자 UI는 `gaesup-world/admin` 엔트리에서 import 합니다.
-
-```tsx
-import { GaesupAdmin } from 'gaesup-world/admin';
-```
-
-기본적으로 `GaesupAdmin`은 로그인 게이트가 켜져 있습니다. 즉, `requireLogin` 기본값은 `true`입니다.
-
-```tsx
-import { GaesupAdmin } from 'gaesup-world/admin';
-
-export default function AdminPage() {
-  return (
-    <GaesupAdmin>
-      <div>Protected Admin Area</div>
-    </GaesupAdmin>
-  );
-}
-```
-
-로그인 보호 없이 감싸고 싶다면 명시적으로 꺼야 합니다.
-
-```tsx
-<GaesupAdmin requireLogin={false}>
-  <div>Public Admin Preview</div>
-</GaesupAdmin>
-```
-
-## 개발 환경 실행
-
-이 저장소 자체를 로컬에서 실행할 때는 `pnpm` 기준으로 작업하는 것이 가장 자연스럽습니다. Node 패키지 매니저가 섞이면 lockfile과 prepare 단계가 헷갈릴 수 있으니, 처음부터 `corepack pnpm ...` 형태로 맞추는 것을 권장합니다.
-
-```bash
-corepack pnpm install
-corepack pnpm dev
-```
-
-주요 명령:
-
-```bash
-corepack pnpm dev
-corepack pnpm build
-corepack pnpm lint
-corepack pnpm test -- --runInBand
-corepack pnpm exec publint
-```
-
-참고:
-
-- `npm pack --dry-run`은 `prepare`를 실행하므로 `dist/`가 재생성됩니다.
-- 배포 전에는 `corepack pnpm build`, `corepack pnpm lint`, `corepack pnpm test -- --runInBand`, `corepack pnpm exec publint`를 함께 확인하는 것이 좋습니다.
-
-## 데모 앱
-
-`examples/`에는 라이브러리를 실제로 사용하는 데모 라우트가 들어 있습니다.
-
-- `/`: 쇼케이스 데모
-- `/world`: 기본 월드/건설 에디터 데모
-- `/edit`: 편집 데모
-- `/blueprints`: 블루프린트 에디터
-- `/network`: 멀티플레이어 데모
-- `/admin`: 관리자 래핑 데모
-
-최근 정리로 인해 `examples`는 가능하면 내부 소스 경로 대신 루트 public API를 사용하도록 맞춰져 있습니다.
-
-## 패키지 엔트리
-
-현재 공개 export는 아래 subpath를 기준으로 관리합니다.
-
-- `gaesup-world`: 메인 런타임, 월드, 도메인 API
-- `gaesup-world/admin`: 관리자 래퍼 UI
-- `gaesup-world/blueprints`: 블루프린트 런타임 API
-- `gaesup-world/blueprints/editor`: 블루프린트 편집 UI
-- `gaesup-world/runtime`: 런타임 중심 API
-- `gaesup-world/editor`: 에디터 API
-- `gaesup-world/assets`: 에셋 API
-- `gaesup-world/network`: 네트워크 API
-- `gaesup-world/plugins`: 플러그인 API
-- `gaesup-world/server-contracts`: 서버/클라이언트 command contract
-- `gaesup-world/postprocessing`: 렌더링 후처리 API
-- `gaesup-world/style.css`: 라이브러리 기본 스타일
-
-`package.json`의 export map은 ESM/CJS와 `.d.ts`/`.d.cts` 타입 선언을 함께 제공합니다.
-
-## 검증 상태
-
-최근 확인 기준:
-
-- `npm run build:types`: 성공
-- `npm run lint`: 성공
-- `npm test -- --runInBand`: 성공
-- `npm run build`: 성공
-- `npx publint`: 성공
-
-## 문서 안내
-
-프로젝트 개요:
-
-- [프로젝트 개요](./docs/GAESUP_WORLD_OVERVIEW.md)
-
-도메인 문서:
-
-- [블루프린트](./docs/domain/BLUEPRINT.md)
-- [카메라](./docs/domain/CAMERA.md)
-- [모션](./docs/domain/MOTIONS.md)
-
-가이드 문서:
-
-- [API 가이드](./docs/guide/API_GUIDE.md)
-- [성능 가이드](./docs/guide/PERFORMANCE_GUIDE.md)
-- [테스트 가이드](./docs/guide/TEST_GUIDE.md)
-
-API 문서:
-
-- [블루프린트 API](./docs/api/BLUEPRINT_API.md)
-- [빌딩 API](./docs/api/BUILDING_API.md)
-- [렌더링 API](./docs/api/RENDERING_API.md)
-- [성능 API](./docs/api/PERFORMANCE_API.md)
-- [WASM API](./docs/api/WASM_API.md)
-
-설정 문서:
-
-- [블루프린트 설정](./docs/config/BLUEPRINT_CONFIG.md)
-- [빌딩 설정](./docs/config/BUILDING_CONFIG.md)
-- [카메라 설정](./docs/config/CAMERA_CONFIG.md)
-- [물리 설정](./docs/config/PHYSICS_CONFIG.md)
-
-계획 문서:
-
-- [Universal Web Game Library 계획](./docs/plan/UNIVERSAL_WEB_GAME_LIBRARY.md)
-- [테스트 가이드](./docs/guide/TEST_GUIDE.md)
-
-## 패키지 정보
-
-- npm: https://www.npmjs.com/package/gaesup-world
-- 저장소: https://github.com/jigglypop/gaesup-world.git
-- 라이선스: MIT
+# gaesup-world
+
+Build a playable 3D room in your browser. Use scene data in React and exchange layouts 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)
+
+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.0.31`. Check the npm registry for publication status.
+
+## Run the mini-home
+
+```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.
+
+## 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
+```
+
+React 18/Fiber 8 are also declared peers, but that combination needs separate consumer validation.
+
+```ts
+import { createSceneDocument, createSceneDocumentController } from 'gaesup-world';
+
+const controller = createSceneDocumentController(createSceneDocument({
+  id: 'my-room',
+  objects: [{ id: 'chair', name: 'Chair' }],
+}));
+controller.dispatch({
+  type: 'scene-object.update',
+  objectId: 'chair',
+  patch: { transform: { position: [2, 0, 0] } },
+});
+const savedScene = JSON.stringify(controller.getSnapshot());
+```
+
+Scene data is serializable. React, Three.js and physics objects belong to runtime projections. Edits use the document controller. Editor UI is available through `gaesup-world/editor`; a complete general-purpose Studio is still under development.
+
+## 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).
+
+## 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.
+
+`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.
+
+For npm, validate, authenticate with `npm login`, pack the reviewed build and run `npm publish <tarball>` without a custom tag.
+
+## 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.31.md)

package/dist/AbstractSystem-BKKR49fl.cjs

@@ -0,0 +1 @@
+var e=class e{constructor(){this.enabled=!1,this.level=`info`}static getInstance(){return e.instance||=new e,e.instance}enable(){this.enabled=!0}disable(){this.enabled=!1}setLevel(e){this.level=e}shouldLog(e){if(!this.enabled)return!1;let t={error:0,warn:1,info:2,log:3};return t[e]<=t[this.level]}log(e,...t){this.shouldLog(`log`)&&console.log(`[LOG] ${e}`,...t)}info(e,...t){this.shouldLog(`info`)&&console.info(`[INFO] ${e}`,...t)}warn(e,...t){this.shouldLog(`warn`)&&console.warn(`[WARN] ${e}`,...t)}error(e,...t){this.shouldLog(`error`)&&console.error(`[ERROR] ${e}`,...t)}}.getInstance(),t=!0,n=new class{constructor(){this.systems=new Map}safeDispose(e){if(e)try{e.dispose()}catch{}}register(e,n){let r=this.systems.get(e);r!==n&&(r&&t&&console.warn(`System with type "${e}" is already registered. Overwriting.`),this.systems.set(e,n))}get(e){return this.systems.get(e)}getAll(){return this.systems}unregister(e){if(!this.systems.has(e))return;let t=this.systems.get(e);this.safeDispose(t),this.systems.delete(e)}clear(){this.systems.forEach(e=>this.safeDispose(e)),this.systems.clear()}};function r(t){return function(n,r,i){let a=i.value;return i.value=function(...n){try{return a.apply(this,n)}catch(n){let i=n instanceof Error?n:String(n);return e.error(`[${this.constructor.name}] Error in ${r}:`,i),t}},i}}function i(t){return function(r){let i=new Proxy(r,{construct(i,a,o){let s=Reflect.construct(i,a,o);return n.register(t,s),e.info(`[${r.name}] Registered as ${t} system`),s}});return Object.defineProperty(i,"name",{value:r.name}),i}}function a(t={}){return function(n){let r=new WeakMap,i=new Proxy(n,{construct(i,a,o){let s=Reflect.construct(i,a,o),c={animationFrameId:null,lastTime:0,totalTime:0,frameCount:0};r.set(s,c);let l=()=>{c.animationFrameId!==null&&(cancelAnimationFrame(c.animationFrameId),c.animationFrameId=null,e.info(`[${n.name}] Runtime stopped`))},u=()=>{let t=e=>{c.lastTime===0&&(c.lastTime=e);let n=e-c.lastTime;c.lastTime=e,c.totalTime+=n,c.frameCount++;let r={deltaTime:n,totalTime:c.totalTime,frameCount:c.frameCount};s.update&&typeof s.update==`function`&&s.update(r),c.animationFrameId=requestAnimationFrame(t)};c.animationFrameId=requestAnimationFrame(t),e.info(`[${n.name}] Runtime started`)},d=s.dispose?.bind(s);return Object.defineProperty(s,"dispose",{configurable:!0,writable:!0,value:()=>{l(),d?.()}}),t.autoStart&&u(),s}});return Object.defineProperty(i,"name",{value:n.name}),i}}var o=(e,t,n)=>n;function s(e){return o}function c(e=100){return o}function l(t){return function(n,r,i){let a=i.value;return i.value=async function(...n){let i=new Promise((e,n)=>{setTimeout(()=>n(Error(`${r} timed out after ${t}ms`)),t)});try{return await Promise.race([a.apply(this,n),i])}catch(t){throw e.error(`[${this.constructor.name}] ${r} timeout:`,t instanceof Error?t:String(t)),t}},i}}function u(e,t,n,r){var i=arguments.length,a=i<3?t:r===null?r=Object.getOwnPropertyDescriptor(t,n):r,o;if(typeof Reflect==`object`&&typeof Reflect.decorate==`function`)a=Reflect.decorate(e,t,n,r);else for(var s=e.length-1;s>=0;s--)(o=e[s])&&(a=(i<3?o(a):i>3?o(t,n,a):o(t,n))||a);return i>3&&a&&Object.defineProperty(t,n,a),a}var d=class{constructor(e,t,n){this.capabilities={hasAsync:!0,hasMetrics:!0,hasState:!0,hasEvents:!1},this._isDisposed=!1,this._updateCount=0,this.options={...n},this.stateInitializer=e,this.metricsInitializer=t,this.state=this.createInitialState(e,this.options.initialState),this.metrics=this.createInitialMetrics(t,this.options.initialMetrics)}createInitialState(e,t){return{...typeof e==`function`?e(t):{...e,...t},lastUpdate:0}}createInitialMetrics(e,t){return{...typeof e==`function`?e(t):{...e,...t},frameTime:0}}async init(){}async start(){}pause(){}resume(){}update(e){let t=this.createUpdateArgs(e);this.performUpdateWithArgs(t)}createDefaultUpdateArgs(e){return e}performUpdateWithArgs(e){if(this._isDisposed)throw Error(`Cannot update disposed system`);let t=performance.now();this._updateCount++,this.state.lastUpdate=Date.now(),this.beforeUpdate(e),this.performUpdate(e);let n=performance.now();this.metrics.frameTime=n-t,this.updateMetrics(e.deltaTime),this.afterUpdate(e)}beforeUpdate(e){}afterUpdate(e){}updateMetrics(e){}getState(){return this.state}getMetrics(){return this.metrics}get isDisposed(){return this._isDisposed}get updateCount(){return this._updateCount}reset(){let e=typeof this.stateInitializer==`function`?this.stateInitializer:this.state,t=typeof this.metricsInitializer==`function`?this.metricsInitializer:this.metrics,n=this.createInitialState(e,this.options.initialState),r=this.createInitialMetrics(t,this.options.initialMetrics);this.state=n,this.metrics=r,this._updateCount=0,this.onReset()}onReset(){}dispose(){this._isDisposed||=(this.onDispose(),!0)}onDispose(){}};u([r()],d.prototype,`init`,null),u([r()],d.prototype,`start`,null),u([s()],d.prototype,`update`,null),u([s()],d.prototype,`performUpdateWithArgs`,null),u([r()],d.prototype,`reset`,null),u([r()],d.prototype,`dispose`,null),Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return l}}),Object.defineProperty(exports,"c",{enumerable:!0,get:function(){return i}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,"l",{enumerable:!0,get:function(){return e}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return u}}),Object.defineProperty(exports,"o",{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return c}}),Object.defineProperty(exports,"s",{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return d}});