gaesup-world 1.0.5 → 1.0.6

package/README.md

@@ -25,7 +25,7 @@
 
 ## 설치
 
-프로젝트에서 사용할 때는 `gaesup-world`와 React Three Fiber 계열 의존성을 함께 설치하면 됩니다.
+앱에서 사용할 때는 `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
@@ -43,6 +43,13 @@ yarn add gaesup-world three react react-dom @react-three/fiber @react-three/drei
 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`
+
 ## 빠른 시작
 
 가장 기본적인 사용 예시는 아래와 같습니다.
@@ -72,6 +79,29 @@ export default function App() {
 
 ## 핵심 개념
 
+### 런타임과 플러그인
+
+`createGaesupRuntime`은 카메라, 모션, 저장, NPC, 경제, 날씨 같은 도메인 플러그인을 한곳에 묶는 런타임 팩토리입니다. 앱이 필요한 도메인만 골라 붙일 수 있고, 각 플러그인은 서비스, 시스템, 저장 도메인, UI 확장을 등록합니다.
+
+```ts
+import {
+  createGaesupRuntime,
+  createBuildingPlugin,
+  createCameraPlugin,
+  createInventoryPlugin,
+} from 'gaesup-world';
+
+const runtime = createGaesupRuntime({
+  plugins: [
+    createCameraPlugin(),
+    createBuildingPlugin(),
+    createInventoryPlugin(),
+  ],
+});
+
+await runtime.setup();
+```
+
 ### 월드 설정
 
 `GaesupWorld`는 월드 관련 설정을 store에 주입하는 루트 컴포넌트입니다.
@@ -114,6 +144,26 @@ export default function App() {
 - `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 할 수 있습니다.
@@ -187,7 +237,7 @@ export default function AdminPage() {
 
 ## 개발 환경 실행
 
-이 저장소 자체를 로컬에서 실행할 때는 `pnpm` 기준으로 작업하는 것이 가장 자연스럽습니다.
+이 저장소 자체를 로컬에서 실행할 때는 `pnpm` 기준으로 작업하는 것이 가장 자연스럽습니다. Node 패키지 매니저가 섞이면 lockfile과 prepare 단계가 헷갈릴 수 있으니, 처음부터 `corepack pnpm ...` 형태로 맞추는 것을 권장합니다.
 
 ```bash
 corepack pnpm install
@@ -199,16 +249,15 @@ corepack pnpm dev
 ```bash
 corepack pnpm dev
 corepack pnpm build
-corepack pnpm exec vite build --mode esm
-corepack pnpm exec vite build
-corepack pnpm test -- --runInBand
 corepack pnpm lint
+corepack pnpm test -- --runInBand
+corepack pnpm exec publint
 ```
 
 참고:
 
-- 현재 Windows 환경에서는 `prepare` 스크립트가 `pnpm` PATH 설정에 따라 실패할 수 있습니다.
-- 이런 경우 `corepack pnpm ...` 형태로 실행하면 정상 동작합니다.
+- `npm pack --dry-run`은 `prepare`를 실행하므로 `dist/`가 재생성됩니다.
+- 배포 전에는 `corepack pnpm build`, `corepack pnpm lint`, `corepack pnpm test -- --runInBand`, `corepack pnpm exec publint`를 함께 확인하는 것이 좋습니다.
 
 ## 데모 앱
 
@@ -223,16 +272,34 @@ corepack pnpm lint
 
 최근 정리로 인해 `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` 타입 선언을 함께 제공합니다.
+
 ## 검증 상태
 
 최근 확인 기준:
 
-- `corepack pnpm exec vite build`: 성공
-- `corepack pnpm exec vite build --mode esm`: 성공
-- `corepack pnpm exec jest --runInBand --watchman=false`: 성공
 - `npm run build:types`: 성공
-
-타입 선언 빌드는 현재 통과합니다.
+- `npm run lint`: 성공
+- `npm test -- --runInBand`: 성공
+- `npm run build`: 성공
+- `npx publint`: 성공
 
 ## 문서 안내
 
@@ -242,24 +309,36 @@ corepack pnpm lint
 
 도메인 문서:
 
-- [애니메이션](./docs/domain/ANIMATION.md)
 - [블루프린트](./docs/domain/BLUEPRINT.md)
 - [카메라](./docs/domain/CAMERA.md)
 - [모션](./docs/domain/MOTIONS.md)
-- [네트워크](./docs/domain/NETWORKS.md)
-- [보일러플레이트 구조](./docs/domain/BOILERPLATE_ARCHITECTURE.md)
-
-계획 문서:
-
-- [MVP 계획](./docs/plan/MVP.md)
 
 가이드 문서:
 
 - [API 가이드](./docs/guide/API_GUIDE.md)
-- [레이어 가이드](./docs/guide/LAYER_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

package/dist/EventBus-Ck0Dwee2.js

@@ -0,0 +1,33 @@
+class h {
+  handlers = /* @__PURE__ */ new Map();
+  on(s, e) {
+    const r = this.handlers.get(s) ?? /* @__PURE__ */ new Set();
+    return r.add(e), this.handlers.set(s, r), () => this.off(s, e);
+  }
+  once(s, e) {
+    const r = (t) => {
+      this.off(s, r), e(t);
+    };
+    return this.on(s, r);
+  }
+  off(s, e) {
+    const r = this.handlers.get(s);
+    r && (r.delete(e), r.size === 0 && this.handlers.delete(s));
+  }
+  emit(s, e) {
+    const r = this.handlers.get(s);
+    if (r)
+      for (const t of Array.from(r))
+        t(e);
+  }
+  clear(s) {
+    if (s === void 0) {
+      this.handlers.clear();
+      return;
+    }
+    this.handlers.delete(s);
+  }
+}
+export {
+  h as I
+};

package/dist/EventBus-DjA75MWC.cjs

@@ -0,0 +1 @@
+"use strict";class n{handlers=new Map;on(s,e){const r=this.handlers.get(s)??new Set;return r.add(e),this.handlers.set(s,r),()=>this.off(s,e)}once(s,e){const r=t=>{this.off(s,r),e(t)};return this.on(s,r)}off(s,e){const r=this.handlers.get(s);r&&(r.delete(e),r.size===0&&this.handlers.delete(s))}emit(s,e){const r=this.handlers.get(s);if(r)for(const t of Array.from(r))t(e)}clear(s){if(s===void 0){this.handlers.clear();return}this.handlers.delete(s)}}exports.InMemoryEventBus=n;

package/dist/admin.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("react/jsx-runtime"),c=require("react"),l=require("./authStore-CrDnYNnL.cjs"),d=require("zustand"),g=()=>{const[o,n]=c.useState(""),[e,t]=c.useState(""),[r,i]=c.useState(""),a=l.useAuthStore(u=>u.login),m=async u=>{u.preventDefault(),i(""),await a(o,e)||i("Invalid username or password")};return s.jsxs("div",{className:"login-container",children:[s.jsx("h1",{children:"Admin Login"}),s.jsxs("form",{onSubmit:m,className:"login-form",children:[s.jsx("input",{type:"text",value:o,onChange:u=>n(u.target.value),placeholder:"Username",className:"login-input",autoComplete:"username"}),s.jsx("input",{type:"password",value:e,onChange:u=>t(u.target.value),placeholder:"Password",className:"login-input",autoComplete:"current-password"}),s.jsx("button",{type:"submit",className:"login-button",children:"Login"}),r&&s.jsx("p",{className:"login-error",children:r})]})]})},p=({children:o,requireLogin:n=!0})=>{const e=l.useAuthStore(t=>t.isLoggedIn);return n&&!e?s.jsx(g,{}):s.jsx(s.Fragment,{children:o})},h=d.create((o,n)=>({toasts:[],timers:new Map,addToast:e=>{const t=Date.now().toString(),r={...e,id:t};o(a=>({toasts:[...a.toasts,r]}));const i=setTimeout(()=>{n().removeToast(t)},3e3);o(a=>(a.timers.set(t,i),{}))},addToastAsync:async e=>new Promise(t=>{n().addToast(e),t()}),removeToast:e=>{const{timers:t}=n(),r=t.get(e);r&&(clearTimeout(r),t.delete(e)),o(i=>({toasts:i.toasts.filter(a=>a.id!==e)}))}}));exports.useAuthStore=l.useAuthStore;exports.GaesupAdmin=p;exports.useToast=h;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("react/jsx-runtime"),l=require("react"),d=require("zustand"),m=require("zustand/middleware"),c=d.create()(m.persist(e=>({isLoggedIn:!1,user:null,loading:!1,modal:{on:!1,type:"",file:-1,username:"",gltf_url:""},login:async(s,t)=>{e({loading:!0});try{return s==="admin"&&t==="password"?(e({isLoggedIn:!0,user:{username:s},loading:!1}),!0):(e({loading:!1}),!1)}catch{return e({loading:!1}),!1}},logout:()=>{e({isLoggedIn:!1,user:null})},setLoading:s=>{e({loading:s})},setModal:s=>{e({modal:s})}}),{name:"gaesup-admin-auth",partialize:e=>({isLoggedIn:e.isLoggedIn,user:e.user})})),p=()=>{const[e,s]=l.useState(""),[t,n]=l.useState(""),[o,u]=l.useState(""),r=c(i=>i.login),g=async i=>{i.preventDefault(),u(""),await r(e,t)||u("Invalid username or password")};return a.jsxs("div",{className:"login-container",children:[a.jsx("h1",{children:"Admin Login"}),a.jsxs("form",{onSubmit:g,className:"login-form",children:[a.jsx("input",{type:"text",value:e,onChange:i=>s(i.target.value),placeholder:"Username",className:"login-input",autoComplete:"username"}),a.jsx("input",{type:"password",value:t,onChange:i=>n(i.target.value),placeholder:"Password",className:"login-input",autoComplete:"current-password"}),a.jsx("button",{type:"submit",className:"login-button",children:"Login"}),o&&a.jsx("p",{className:"login-error",children:o})]})]})},f=({children:e,requireLogin:s=!0})=>{const t=c(n=>n.isLoggedIn);return s&&!t?a.jsx(p,{}):a.jsx(a.Fragment,{children:e})},h=d.create((e,s)=>({toasts:[],timers:new Map,addToast:t=>{const n=Date.now().toString(),o={...t,id:n};e(r=>({toasts:[...r.toasts,o]}));const u=setTimeout(()=>{s().removeToast(n)},3e3);e(r=>(r.timers.set(n,u),{}))},addToastAsync:async t=>new Promise(n=>{s().addToast(t),n()}),removeToast:t=>{const{timers:n}=s(),o=n.get(t);o&&(clearTimeout(o),n.delete(t)),e(u=>({toasts:u.toasts.filter(r=>r.id!==t)}))}}));exports.GaesupAdmin=f;exports.useAuthStore=c;exports.useToast=h;

package/dist/admin.js

@@ -1,20 +1,56 @@
-import { jsxs as l, jsx as i, Fragment as d } from "react/jsx-runtime";
-import { useState as m } from "react";
-import { u } from "./authStore-CU_xZzJ7.js";
-import { create as p } from "zustand";
-const g = () => {
-  const [s, o] = m(""), [e, t] = m(""), [n, c] = m(""), r = u((a) => a.login);
-  return /* @__PURE__ */ l("div", { className: "login-container", children: [
+import { jsxs as d, jsx as i, Fragment as m } from "react/jsx-runtime";
+import { useState as u } from "react";
+import { create as c } from "zustand";
+import { persist as p } from "zustand/middleware";
+const g = c()(
+  p(
+    (e) => ({
+      isLoggedIn: !1,
+      user: null,
+      loading: !1,
+      modal: {
+        on: !1,
+        type: "",
+        file: -1,
+        username: "",
+        gltf_url: ""
+      },
+      login: async (s, o) => {
+        e({ loading: !0 });
+        try {
+          return s === "admin" && o === "password" ? (e({ isLoggedIn: !0, user: { username: s }, loading: !1 }), !0) : (e({ loading: !1 }), !1);
+        } catch {
+          return e({ loading: !1 }), !1;
+        }
+      },
+      logout: () => {
+        e({ isLoggedIn: !1, user: null });
+      },
+      setLoading: (s) => {
+        e({ loading: s });
+      },
+      setModal: (s) => {
+        e({ modal: s });
+      }
+    }),
+    {
+      name: "gaesup-admin-auth",
+      partialize: (e) => ({ isLoggedIn: e.isLoggedIn, user: e.user })
+    }
+  )
+), f = () => {
+  const [e, s] = u(""), [o, t] = u(""), [n, l] = u(""), a = g((r) => r.login);
+  return /* @__PURE__ */ d("div", { className: "login-container", children: [
     /* @__PURE__ */ i("h1", { children: "Admin Login" }),
-    /* @__PURE__ */ l("form", { onSubmit: async (a) => {
-      a.preventDefault(), c(""), await r(s, e) || c("Invalid username or password");
+    /* @__PURE__ */ d("form", { onSubmit: async (r) => {
+      r.preventDefault(), l(""), await a(e, o) || l("Invalid username or password");
     }, className: "login-form", children: [
       /* @__PURE__ */ i(
         "input",
         {
           type: "text",
-          value: s,
-          onChange: (a) => o(a.target.value),
+          value: e,
+          onChange: (r) => s(r.target.value),
           placeholder: "Username",
           className: "login-input",
           autoComplete: "username"
@@ -24,8 +60,8 @@ const g = () => {
         "input",
         {
           type: "password",
-          value: e,
-          onChange: (a) => t(a.target.value),
+          value: o,
+          onChange: (r) => t(r.target.value),
           placeholder: "Password",
           className: "login-input",
           autoComplete: "current-password"
@@ -35,30 +71,30 @@ const g = () => {
       n && /* @__PURE__ */ i("p", { className: "login-error", children: n })
     ] })
   ] });
-}, y = ({ children: s, requireLogin: o = !0 }) => {
-  const e = u((t) => t.isLoggedIn);
-  return o && !e ? /* @__PURE__ */ i(g, {}) : /* @__PURE__ */ i(d, { children: s });
-}, N = p((s, o) => ({
+}, I = ({ children: e, requireLogin: s = !0 }) => {
+  const o = g((t) => t.isLoggedIn);
+  return s && !o ? /* @__PURE__ */ i(f, {}) : /* @__PURE__ */ i(m, { children: e });
+}, N = c((e, s) => ({
   toasts: [],
   timers: /* @__PURE__ */ new Map(),
-  addToast: (e) => {
-    const t = Date.now().toString(), n = { ...e, id: t };
-    s((r) => ({ toasts: [...r.toasts, n] }));
-    const c = setTimeout(() => {
-      o().removeToast(t);
+  addToast: (o) => {
+    const t = Date.now().toString(), n = { ...o, id: t };
+    e((a) => ({ toasts: [...a.toasts, n] }));
+    const l = setTimeout(() => {
+      s().removeToast(t);
     }, 3e3);
-    s((r) => (r.timers.set(t, c), {}));
+    e((a) => (a.timers.set(t, l), {}));
   },
-  addToastAsync: async (e) => new Promise((t) => {
-    o().addToast(e), t();
+  addToastAsync: async (o) => new Promise((t) => {
+    s().addToast(o), t();
   }),
-  removeToast: (e) => {
-    const { timers: t } = o(), n = t.get(e);
-    n && (clearTimeout(n), t.delete(e)), s((c) => ({ toasts: c.toasts.filter((r) => r.id !== e) }));
+  removeToast: (o) => {
+    const { timers: t } = s(), n = t.get(o);
+    n && (clearTimeout(n), t.delete(o)), e((l) => ({ toasts: l.toasts.filter((a) => a.id !== o) }));
   }
 }));
 export {
-  y as GaesupAdmin,
-  u as useAuthStore,
+  I as GaesupAdmin,
+  g as useAuthStore,
   N as useToast
 };

package/dist/{assetStore-BuE4mh1C.cjs → assetStore-DVPge_2j.cjs}

@@ -1 +1 @@
-"use strict";const d=require("zustand"),l=[{id:"warrior-cloth-rabbit",name:"Rabbit Warrior Cloth",kind:"characterPart",slot:"top",url:"gltf/ally_cloth_rabbit.glb",tags:["starter","cloth"]},{id:"warrior-cloth-basic",name:"Basic Warrior Cloth",kind:"characterPart",slot:"top",url:"gltf/ally_cloth.glb",tags:["starter","cloth"]},{id:"ally-hat",name:"Ally Hat",kind:"characterPart",slot:"hat",url:"gltf/ally_hat.glb",tags:["starter","hat"]},{id:"ally-glasses",name:"Ally Glasses",kind:"characterPart",slot:"face",url:"gltf/ally_glass.glb",tags:["starter","face"]},{id:"starter-weapon-layer",name:"Starter Weapon Layer",kind:"weapon",slot:"weapon",url:"gltf/ally_cloth.glb",tags:["starter","weapon","placeholder"],metadata:{placeholder:!0}},{id:"wall-soft-brick",name:"Soft Brick Wall",kind:"wall",tags:["building","wall","brick"],colors:{primary:"#b8795f"},metadata:{material:"STANDARD",roughness:.72}},{id:"tile-warm-wood",name:"Warm Wood Tile",kind:"tile",tags:["building","tile","wood"],colors:{primary:"#8b5a35"},metadata:{material:"STANDARD",roughness:.58}},{id:"material-glass-blue",name:"Blue Glass",kind:"material",tags:["building","material","glass"],colors:{primary:"#9bd7ff"},metadata:{material:"GLASS",opacity:.45,transparent:!0,roughness:.1}},{id:"prop-door-basic",name:"Door",kind:"object3d",url:"gltf/props/door.glb",tags:["starter","building","prop","door","cc0"],metadata:{source:"Poly Pizza",license:"CC0"}},{id:"prop-window-basic",name:"Window",kind:"object3d",url:"gltf/props/window.glb",tags:["starter","building","prop","window","cc0"],metadata:{source:"Poly Pizza",license:"CC0"}},{id:"prop-fence-basic",name:"Fence",kind:"object3d",url:"gltf/props/fence.glb",tags:["starter","building","prop","fence","cc0"],metadata:{source:"Poly Pizza",license:"CC0"}},{id:"prop-lamp-basic",name:"Lamp",kind:"object3d",url:"gltf/props/lamp.glb",tags:["starter","building","prop","lamp","cc0"],metadata:{source:"Poly Pizza",license:"CC0"}},{id:"prop-chair-basic",name:"Chair",kind:"object3d",url:"gltf/props/chair.glb",tags:["starter","building","prop","chair","cc0"],metadata:{source:"Poly Pizza",license:"CC0"}},{id:"prop-table-basic",name:"Table",kind:"object3d",url:"gltf/props/table.glb",tags:["starter","building","prop","table","cc0"],metadata:{source:"Poly Pizza",license:"CC0"}},{id:"prop-bed-basic",name:"Bed",kind:"object3d",url:"gltf/props/bed.glb",tags:["starter","building","prop","bed","cc0"],metadata:{source:"Poly Pizza",license:"CC0"}},{id:"prop-storage-basic",name:"Storage",kind:"object3d",url:"gltf/props/storage.glb",tags:["starter","building","prop","storage","cc0"],metadata:{source:"Poly Pizza",license:"CC0"}},{id:"prop-mailbox-basic",name:"Mailbox",kind:"object3d",url:"gltf/props/mailbox.glb",tags:["starter","building","prop","mailbox","cc0"],metadata:{source:"Poly Pizza",license:"CC0"}},{id:"prop-crafting-basic",name:"Crafting Station",kind:"object3d",url:"gltf/props/crafting.glb",tags:["starter","building","prop","crafting","cc0"],metadata:{source:"Poly Pizza",license:"CC0"}},{id:"prop-shop-stall-basic",name:"Shop Stall",kind:"object3d",url:"gltf/props/shop-stall.glb",tags:["starter","building","prop","shop","cc0"],metadata:{source:"Poly Pizza",license:"CC0"}}],n=e=>{const a={};for(const t of e)a[t.id]={...t};return a},p=(e,a)=>a?e.filter(t=>!(a.kind&&t.kind!==a.kind||a.slot&&t.slot!==a.slot||a.tag&&!t.tags?.includes(a.tag))):e,c=n(l),g=d.create((e,a)=>({records:c,ids:l.map(t=>t.id),isLoading:!1,error:null,selectedId:null,filter:{},setFilter:t=>e({filter:{...t}}),selectAsset:t=>e({selectedId:t}),registerAssets:t=>e(s=>{const r={...s.records},o=new Set(s.ids);for(const i of t)r[i.id]={...i},o.add(i.id);return{records:r,ids:Array.from(o)}}),loadAssets:async(t,s)=>{e({isLoading:!0,error:null});try{const r=await t.listAssets(s);a().registerAssets(r.length>0?r:l),e({isLoading:!1})}catch(r){a().registerAssets(l),e({isLoading:!1,error:r instanceof Error?r.message:"Failed to load assets"})}},getAsset:t=>a().records[t],listAssets:t=>{const s=a();return p(s.ids.map(r=>s.records[r]).filter(r=>!!r),t)},resetAssets:()=>e({records:c,ids:l.map(t=>t.id),isLoading:!1,error:null,selectedId:null,filter:{}})})),b=e=>a=>a.listAssets({kind:e}),u=e=>a=>a.listAssets({slot:e});exports.SEED_ASSETS=l;exports.selectAssetsByKind=b;exports.selectAssetsBySlot=u;exports.useAssetStore=g;
+"use strict";const g=require("zustand"),l=[{id:"warrior-cloth-rabbit",name:"Rabbit Warrior Cloth",kind:"characterPart",slot:"top",url:"gltf/ally_cloth_rabbit.glb",tags:["starter","cloth"]},{id:"warrior-cloth-basic",name:"Basic Warrior Cloth",kind:"characterPart",slot:"top",url:"gltf/ally_cloth.glb",tags:["starter","cloth"]},{id:"ally-hat",name:"Ally Hat",kind:"characterPart",slot:"hat",url:"gltf/ally_hat.glb",tags:["starter","hat"]},{id:"ally-glasses",name:"Ally Glasses",kind:"characterPart",slot:"face",url:"gltf/ally_glass.glb",tags:["starter","face"]},{id:"starter-weapon-layer",name:"Starter Weapon Layer",kind:"weapon",slot:"weapon",url:"gltf/ally_cloth.glb",tags:["starter","weapon","placeholder"],metadata:{placeholder:!0}},{id:"wall-soft-brick",name:"Soft Brick Wall",kind:"wall",tags:["building","wall","brick"],colors:{primary:"#b8795f"},metadata:{material:"STANDARD",roughness:.72}},{id:"tile-warm-wood",name:"Warm Wood Tile",kind:"tile",tags:["building","tile","wood"],colors:{primary:"#8b5a35"},metadata:{material:"STANDARD",roughness:.58}},{id:"material-glass-blue",name:"Blue Glass",kind:"material",tags:["building","material","glass"],colors:{primary:"#9bd7ff"},metadata:{material:"GLASS",opacity:.45,transparent:!0,roughness:.1}},{id:"prop-door-basic",name:"Door",kind:"object3d",url:"gltf/props/door.glb",tags:["starter","building","prop","door","cc0"],metadata:{source:"Poly Pizza",license:"CC0"}},{id:"prop-window-basic",name:"Window",kind:"object3d",url:"gltf/props/window.glb",tags:["starter","building","prop","window","cc0"],metadata:{source:"Poly Pizza",license:"CC0"}},{id:"prop-fence-basic",name:"Fence",kind:"object3d",url:"gltf/props/fence.glb",tags:["starter","building","prop","fence","cc0"],metadata:{source:"Poly Pizza",license:"CC0"}},{id:"prop-lamp-basic",name:"Lamp",kind:"object3d",url:"gltf/props/lamp.glb",tags:["starter","building","prop","lamp","cc0"],metadata:{source:"Poly Pizza",license:"CC0"}},{id:"prop-chair-basic",name:"Chair",kind:"object3d",url:"gltf/props/chair.glb",tags:["starter","building","prop","chair","cc0"],metadata:{source:"Poly Pizza",license:"CC0"}},{id:"prop-table-basic",name:"Table",kind:"object3d",url:"gltf/props/table.glb",tags:["starter","building","prop","table","cc0"],metadata:{source:"Poly Pizza",license:"CC0"}},{id:"prop-bed-basic",name:"Bed",kind:"object3d",url:"gltf/props/bed.glb",tags:["starter","building","prop","bed","cc0"],metadata:{source:"Poly Pizza",license:"CC0"}},{id:"prop-storage-basic",name:"Storage",kind:"object3d",url:"gltf/props/storage.glb",tags:["starter","building","prop","storage","cc0"],metadata:{source:"Poly Pizza",license:"CC0"}},{id:"prop-mailbox-basic",name:"Mailbox",kind:"object3d",url:"gltf/props/mailbox.glb",tags:["starter","building","prop","mailbox","cc0"],metadata:{source:"Poly Pizza",license:"CC0"}},{id:"prop-crafting-basic",name:"Crafting Station",kind:"object3d",url:"gltf/props/crafting.glb",tags:["starter","building","prop","crafting","cc0"],metadata:{source:"Poly Pizza",license:"CC0"}},{id:"prop-shop-stall-basic",name:"Shop Stall",kind:"object3d",url:"gltf/props/shop-stall.glb",tags:["starter","building","prop","shop","cc0"],metadata:{source:"Poly Pizza",license:"CC0"}}],p=e=>{const a={};for(const t of e)a[t.id]={...t};return a},u=(e,a)=>a?e.filter(t=>!(a.kind&&t.kind!==a.kind||a.slot&&t.slot!==a.slot||a.tag&&!t.tags?.includes(a.tag))):e,c=p(l),d={state:"seed",origin:"seed",assetCount:l.length,loadedAt:null,error:null,fallbackReason:null};function i(e,a){return a?{...e,query:{...a}}:e}const b=g.create((e,a)=>({records:c,ids:l.map(t=>t.id),isLoading:!1,error:null,catalogStatus:d,selectedId:null,filter:{},setFilter:t=>e({filter:{...t}}),selectAsset:t=>e({selectedId:t}),registerAssets:t=>e(r=>{const s={...r.records},o=new Set(r.ids);for(const n of t)s[n.id]={...n},o.add(n.id);return{records:s,ids:Array.from(o)}}),loadAssets:async(t,r)=>{e({isLoading:!0,error:null,catalogStatus:i({state:"loading",origin:"source",assetCount:a().ids.length,loadedAt:null,error:null,fallbackReason:null},r)});try{const s=await t.listAssets(r);if(s.length>0){a().registerAssets(s),e({isLoading:!1,catalogStatus:i({state:"loaded",origin:"source",assetCount:s.length,loadedAt:Date.now(),error:null,fallbackReason:null},r)});return}a().registerAssets(l),e({isLoading:!1,catalogStatus:i({state:"fallback",origin:"seed",assetCount:l.length,loadedAt:Date.now(),error:null,fallbackReason:"empty-source"},r)})}catch(s){const o=s instanceof Error?s.message:"Failed to load assets";a().registerAssets(l),e({isLoading:!1,error:o,catalogStatus:i({state:"fallback",origin:"seed",assetCount:l.length,loadedAt:Date.now(),error:o,fallbackReason:o},r)})}},getAsset:t=>a().records[t],listAssets:t=>{const r=a();return u(r.ids.map(s=>r.records[s]).filter(s=>!!s),t)},resetAssets:()=>e({records:c,ids:l.map(t=>t.id),isLoading:!1,error:null,catalogStatus:d,selectedId:null,filter:{}})})),f=e=>a=>a.listAssets({kind:e}),m=e=>a=>a.listAssets({slot:e});exports.SEED_ASSETS=l;exports.selectAssetsByKind=f;exports.selectAssetsBySlot=m;exports.useAssetStore=b;

package/dist/{assetStore-2bI2BPCn.js → assetStore-mAClONjR.js}

@@ -1,4 +1,4 @@
-import { create as d } from "zustand";
+import { create as g } from "zustand";
 const l = [
   {
     id: "warrior-cloth-rabbit",
@@ -172,61 +172,118 @@ const l = [
     tags: ["starter", "building", "prop", "shop", "cc0"],
     metadata: { source: "Poly Pizza", license: "CC0" }
   }
-], n = (r) => {
-  const t = {};
-  for (const a of r)
-    t[a.id] = { ...a };
-  return t;
-}, p = (r, t) => t ? r.filter((a) => !(t.kind && a.kind !== t.kind || t.slot && a.slot !== t.slot || t.tag && !a.tags?.includes(t.tag))) : r, c = n(l), b = d((r, t) => ({
+], p = (e) => {
+  const a = {};
+  for (const t of e)
+    a[t.id] = { ...t };
+  return a;
+}, u = (e, a) => a ? e.filter((t) => !(a.kind && t.kind !== a.kind || a.slot && t.slot !== a.slot || a.tag && !t.tags?.includes(a.tag))) : e, c = p(l), d = {
+  state: "seed",
+  origin: "seed",
+  assetCount: l.length,
+  loadedAt: null,
+  error: null,
+  fallbackReason: null
+};
+function i(e, a) {
+  return a ? { ...e, query: { ...a } } : e;
+}
+const f = g((e, a) => ({
   records: c,
-  ids: l.map((a) => a.id),
+  ids: l.map((t) => t.id),
   isLoading: !1,
   error: null,
+  catalogStatus: d,
   selectedId: null,
   filter: {},
-  setFilter: (a) => r({ filter: { ...a } }),
-  selectAsset: (a) => r({ selectedId: a }),
-  registerAssets: (a) => r((s) => {
-    const e = { ...s.records }, i = new Set(s.ids);
-    for (const o of a)
-      e[o.id] = { ...o }, i.add(o.id);
+  setFilter: (t) => e({ filter: { ...t } }),
+  selectAsset: (t) => e({ selectedId: t }),
+  registerAssets: (t) => e((r) => {
+    const s = { ...r.records }, o = new Set(r.ids);
+    for (const n of t)
+      s[n.id] = { ...n }, o.add(n.id);
     return {
-      records: e,
-      ids: Array.from(i)
+      records: s,
+      ids: Array.from(o)
     };
   }),
-  loadAssets: async (a, s) => {
-    r({ isLoading: !0, error: null });
+  loadAssets: async (t, r) => {
+    e({
+      isLoading: !0,
+      error: null,
+      catalogStatus: i({
+        state: "loading",
+        origin: "source",
+        assetCount: a().ids.length,
+        loadedAt: null,
+        error: null,
+        fallbackReason: null
+      }, r)
+    });
     try {
-      const e = await a.listAssets(s);
-      t().registerAssets(e.length > 0 ? e : l), r({ isLoading: !1 });
-    } catch (e) {
-      t().registerAssets(l), r({
+      const s = await t.listAssets(r);
+      if (s.length > 0) {
+        a().registerAssets(s), e({
+          isLoading: !1,
+          catalogStatus: i({
+            state: "loaded",
+            origin: "source",
+            assetCount: s.length,
+            loadedAt: Date.now(),
+            error: null,
+            fallbackReason: null
+          }, r)
+        });
+        return;
+      }
+      a().registerAssets(l), e({
+        isLoading: !1,
+        catalogStatus: i({
+          state: "fallback",
+          origin: "seed",
+          assetCount: l.length,
+          loadedAt: Date.now(),
+          error: null,
+          fallbackReason: "empty-source"
+        }, r)
+      });
+    } catch (s) {
+      const o = s instanceof Error ? s.message : "Failed to load assets";
+      a().registerAssets(l), e({
         isLoading: !1,
-        error: e instanceof Error ? e.message : "Failed to load assets"
+        error: o,
+        catalogStatus: i({
+          state: "fallback",
+          origin: "seed",
+          assetCount: l.length,
+          loadedAt: Date.now(),
+          error: o,
+          fallbackReason: o
+        }, r)
       });
     }
   },
-  getAsset: (a) => t().records[a],
-  listAssets: (a) => {
-    const s = t();
-    return p(
-      s.ids.map((e) => s.records[e]).filter((e) => !!e),
-      a
+  getAsset: (t) => a().records[t],
+  listAssets: (t) => {
+    const r = a();
+    return u(
+      r.ids.map((s) => r.records[s]).filter((s) => !!s),
+      t
     );
   },
-  resetAssets: () => r({
+  resetAssets: () => e({
     records: c,
-    ids: l.map((a) => a.id),
+    ids: l.map((t) => t.id),
     isLoading: !1,
     error: null,
+    catalogStatus: d,
     selectedId: null,
     filter: {}
   })
-})), u = (r) => (t) => t.listAssets({ kind: r }), m = (r) => (t) => t.listAssets({ slot: r });
+})), m = (e) => (a) => a.listAssets({ kind: e }), h = (e) => (a) => a.listAssets({ slot: e });
 export {
   l as S,
-  m as a,
-  u as s,
-  b as u
+  h as a,
+  m as s,
+  f as u
 };

package/dist/assets.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./assetStore-BuE4mh1C.cjs"),s=require("./index-DCa_lUwq.cjs"),t=require("./api-B58jaq5T.cjs");exports.SEED_ASSETS=e.SEED_ASSETS;exports.selectAssetsByKind=e.selectAssetsByKind;exports.selectAssetsBySlot=e.selectAssetsBySlot;exports.useAssetStore=e.useAssetStore;exports.AssetPreviewCanvas=s.AssetPreviewCanvas;exports.assetToMeshConfig=s.assetToMeshConfig;exports.createScopedAssetMeshConfig=s.createScopedAssetMeshConfig;exports.createScopedBuildingMeshId=s.createScopedBuildingMeshId;exports.HttpAssetSource=t.HttpAssetSource;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./assetStore-DVPge_2j.cjs"),s=require("./index-DCa_lUwq.cjs"),l=require("./api-B58jaq5T.cjs"),t="gltf/ally_body.glb",a={ally:"gltf/ally.glb",allyBody:t,allyCloth:"gltf/ally_cloth.glb",allyRabbitCloth:"gltf/ally_cloth_rabbit.glb",allyHat:"gltf/ally_hat.glb",allyGlass:"gltf/ally_glass.glb"};exports.SEED_ASSETS=e.SEED_ASSETS;exports.selectAssetsByKind=e.selectAssetsByKind;exports.selectAssetsBySlot=e.selectAssetsBySlot;exports.useAssetStore=e.useAssetStore;exports.AssetPreviewCanvas=s.AssetPreviewCanvas;exports.assetToMeshConfig=s.assetToMeshConfig;exports.createScopedAssetMeshConfig=s.createScopedAssetMeshConfig;exports.createScopedBuildingMeshId=s.createScopedBuildingMeshId;exports.HttpAssetSource=l.HttpAssetSource;exports.GAESUP_WORLD_CHARACTER_ASSETS=a;exports.GAESUP_WORLD_DEFAULT_CHARACTER_URL=t;

package/dist/assets.d.cts

@@ -1 +1,10 @@
 export * from './core/assets';
+export declare const GAESUP_WORLD_DEFAULT_CHARACTER_URL = "gltf/ally_body.glb";
+export declare const GAESUP_WORLD_CHARACTER_ASSETS: {
+    readonly ally: "gltf/ally.glb";
+    readonly allyBody: "gltf/ally_body.glb";
+    readonly allyCloth: "gltf/ally_cloth.glb";
+    readonly allyRabbitCloth: "gltf/ally_cloth_rabbit.glb";
+    readonly allyHat: "gltf/ally_hat.glb";
+    readonly allyGlass: "gltf/ally_glass.glb";
+};

package/dist/assets.d.ts

@@ -1 +1,10 @@
 export * from './core/assets';
+export declare const GAESUP_WORLD_DEFAULT_CHARACTER_URL = "gltf/ally_body.glb";
+export declare const GAESUP_WORLD_CHARACTER_ASSETS: {
+    readonly ally: "gltf/ally.glb";
+    readonly allyBody: "gltf/ally_body.glb";
+    readonly allyCloth: "gltf/ally_cloth.glb";
+    readonly allyRabbitCloth: "gltf/ally_cloth_rabbit.glb";
+    readonly allyHat: "gltf/ally_hat.glb";
+    readonly allyGlass: "gltf/ally_glass.glb";
+};

package/dist/assets.js

@@ -1,14 +1,24 @@
-import { S as t, s as a, a as o, u as r } from "./assetStore-2bI2BPCn.js";
-import { A as c, a as A, b as i, c as p } from "./index-C-ViQFGa.js";
+import { S as e, s as o, a as g, u as y } from "./assetStore-mAClONjR.js";
+import { A as S, a as _, b as r, c as b } from "./index-C-ViQFGa.js";
 import { H as f } from "./api-BRV101Zn.js";
+const l = "gltf/ally_body.glb", s = {
+  ally: "gltf/ally.glb",
+  allyBody: l,
+  allyCloth: "gltf/ally_cloth.glb",
+  allyRabbitCloth: "gltf/ally_cloth_rabbit.glb",
+  allyHat: "gltf/ally_hat.glb",
+  allyGlass: "gltf/ally_glass.glb"
+};
 export {
-  c as AssetPreviewCanvas,
+  S as AssetPreviewCanvas,
+  s as GAESUP_WORLD_CHARACTER_ASSETS,
+  l as GAESUP_WORLD_DEFAULT_CHARACTER_URL,
   f as HttpAssetSource,
-  t as SEED_ASSETS,
-  A as assetToMeshConfig,
-  i as createScopedAssetMeshConfig,
-  p as createScopedBuildingMeshId,
-  a as selectAssetsByKind,
-  o as selectAssetsBySlot,
-  r as useAssetStore
+  e as SEED_ASSETS,
+  _ as assetToMeshConfig,
+  r as createScopedAssetMeshConfig,
+  b as createScopedBuildingMeshId,
+  o as selectAssetsByKind,
+  g as selectAssetsBySlot,
+  y as useAssetStore
 };

package/dist/authority-BOPCXUrV.cjs

@@ -0,0 +1 @@
+"use strict";function v(e){return`${e}-${Date.now()}-${Math.random().toString(36).slice(2,8)}`}function l(e){return{version:e.version??1,commandId:e.commandId??v("cmd"),domain:e.domain,action:e.action,actorId:e.actorId,submittedAt:e.submittedAt??Date.now(),payload:e.payload,...e.targetId?{targetId:e.targetId}:{},...e.clientSequence!==void 0?{clientSequence:e.clientSequence}:{},...e.expectedRevision!==void 0?{expectedRevision:e.expectedRevision}:{},...e.traceId?{traceId:e.traceId}:{}}}function i(e){return{version:e.version??1,eventId:e.eventId??v("evt"),domain:e.domain,type:e.type,occurredAt:e.occurredAt??Date.now(),payload:e.payload,...e.commandId?{commandId:e.commandId}:{},...e.actorId?{actorId:e.actorId}:{},...e.serverRevision!==void 0?{serverRevision:e.serverRevision}:{},...e.traceId?{traceId:e.traceId}:{}}}function R(e){return{version:e.version??1,deltaId:e.deltaId??v("delta"),domain:e.domain,path:e.path,op:e.op,serverRevision:e.serverRevision,changedAt:e.changedAt??Date.now(),...e.entityId?{entityId:e.entityId}:{},...e.commandId?{commandId:e.commandId}:{},..."value"in e?{value:e.value}:{}}}function s(e){return{version:e.version??1,ackId:e.ackId??v("ack"),snapshotId:e.snapshotId,kind:e.kind,acceptedAt:e.acceptedAt??Date.now(),...e.worldId?{worldId:e.worldId}:{},...e.playerId?{playerId:e.playerId}:{},...e.roomId?{roomId:e.roomId}:{},...e.serverRevision!==void 0?{serverRevision:e.serverRevision}:{},...e.domains?{domains:e.domains}:{}}}function n(e){return`${e.domain}:${e.action??"*"}`}function y(e,r){return`${e}-${r.commandId}`}function h(e,r={}){return{accepted:!0,command:e,events:r.events??[],deltas:r.deltas??[],...r.serverRevision!==void 0?{serverRevision:r.serverRevision}:{}}}function u(e,r,a={}){const t=i({eventId:a.eventId??`rejected-${e.commandId}`,domain:e.domain,type:"command.rejected",occurredAt:a.occurredAt??Date.now(),commandId:e.commandId,actorId:e.actorId,payload:{action:e.action,reason:r},...a.serverRevision!==void 0?{serverRevision:a.serverRevision}:{},...e.traceId?{traceId:e.traceId}:{}});return{accepted:!1,command:e,reason:r,events:[t],deltas:[],...a.serverRevision!==void 0?{serverRevision:a.serverRevision}:{}}}function A(e={}){const r=new Map,a=e.now??Date.now,t=e.createId??y,m={now:a,createId:t};return{register:(d,c)=>{const I=n(d);return r.set(I,c),()=>{r.delete(I)}},handle:async d=>{const c=r.get(n({domain:d.domain,action:d.action}))??r.get(n({domain:d.domain,action:"*"}));return c?c(d,m):u(d,`No authority handler registered for ${d.domain}:${d.action}.`,{eventId:t("rejected",d),occurredAt:a()})},has:d=>r.has(n(d)),clear:()=>{r.clear()}}}exports.createCommandAcceptedResult=h;exports.createCommandAuthorityRouter=A;exports.createCommandRejectedResult=u;exports.createGameCommand=l;exports.createServerEvent=i;exports.createSnapshotAck=s;exports.createStateDelta=R;