@overworld-engine/core

declare module '@overworld-engine/core' {
  interface OverworldEventMap {
    'market:trade': { symbol: string; amount: number }
  }
}

import { EventBus, gameEvents, type OverworldEventMap } from '@overworld-engine/core'

// 全局单例:所有系统的零配置默认总线
const off = gameEvents.on('quest:completed', ({ questId }) => {
  console.log('任务完成', questId)
})
gameEvents.emit('quest:started', { questId: 'welcome' })
off() // on/once/onAny 都返回退订函数

// 测试或多实例场景:自建总线,经各引擎的 events 配置注入
const bus = new EventBus<OverworldEventMap>()

interface EffectRef {
  type: string
  params?: Record<string, unknown>
}

interface ConditionRef {
  type: string
  params?: Record<string, unknown>
  negate?: boolean   // 取反条件结果
}

import {
  createConditionRegistry, createEffectRegistry,
  runEffects, evaluateConditions,
} from '@overworld-engine/core'

const conditions = createConditionRegistry<GameCtx>()
const effects = createEffectRegistry<GameCtx>()

// 游戏启动时注册处理器
conditions.register('minLevel', (params, ctx) => ctx.player.level >= (params.level as number))
effects.register('wallet.addGold', (params, ctx) => ctx.wallet.add(params.amount as number))

// 内容数据里只写声明式引用
runEffects(effects, [{ type: 'wallet.addGold', params: { amount: 100 } }], gameCtx)
evaluateConditions(conditions, [{ type: 'minLevel', params: { level: 3 } }], gameCtx) // boolean

import { create } from 'zustand'
import { persist } from 'zustand/middleware'
import { persistOptions } from '@overworld-engine/core'

const useStore = create<State>()(
  persist(initializer, persistOptions({ name: 'inventory', version: 1 }))
)
// 实际存储 key:overworld:inventory

import { createRestStorage, persistOptions } from '@overworld-engine/core'

const storage = createRestStorage({
  baseUrl: 'https://api.example.com/saves',
  headers: () => ({ authorization: `Bearer ${getToken()}` }), // 每次请求都重新求值
})

const useStore = create<State>()(
  persist(initializer, persistOptions({ name: 'inventory', storage: () => storage }))
)

window.addEventListener('beforeunload', () => {
  void storage.flush()   // 或 flushRestStorage(storage)
})

import { createSaveSlots } from '@overworld-engine/core'

const slots = createSaveSlots()   // 默认 localStorage,前缀 overworld
slots.saveTo('slot-1')            // 把 live 存档复制进槽位
slots.clearCurrent()              // 新游戏:清空 live 存档(槽位不受影响)
slots.loadFrom('slot-1')          // 把槽位恢复为 live 存档
slots.listSlots()                 // [{ slot: 'slot-1', savedAt: 1710000000000 }]

/** X/Y/Z 三轴的位置或旋转元组 */
type Vec3 = [number, number, number]

/** 框架已知的世界实体种类 */
type EntityKind = 'npc' | 'building' | 'item' | 'decoration'

/** 世界实体引用 */
interface EntityRef {
  kind: EntityKind
  id: string
}