[codex] Add shared time manager module

[RSamaium]

Summary

This PR proposes a shared Time Manager design that can be registered through the existing module providers instead of adding more public methods to RpgMap.

The intended DX is:

provideServerModules([
  withTimeManager({ start: '0001-01-01 08:00', scale: 10 })
])

provideClientModules([
  withTimeManager()
])

Design

• Adds withTimeManager() in @rpgjs/common as a shared module factory.
• Adds TimeManager in @rpgjs/server for authoritative server-side time control.
• Adds ClientTimeManager in @rpgjs/client for local display projection.
• Stores the synchronized map snapshot in an internal namespaced field, __rpgjsTime.
• Keeps the client non-authoritative: it infers display time from elapsedMinutes, scale, paused, and serverTimestamp.
• Keeps RpgMap public API unchanged.
• Supports calendars, pause/resume, scale changes, manual time setting, time advancement, and optional lighting integration through existing lighting APIs.

Developer Impact

Game code can register one shared module on both client and server while using focused services for behavior:

const time = inject(TimeManager)
time.set({ hour: 22, minute: 30 })
time.pause()
time.resume()

const time = inject(ClientTimeManager)
const now = time.state()

Documentation

Adds docs/guide/time-manager.md and links it near the existing lighting/weather guides.

Validation

• pnpm vitest run packages/server/tests/time-manager.spec.ts
• pnpm vitest run packages/server/tests/lighting.spec.ts packages/client/src/i18n.spec.ts packages/server/tests/module.spec.ts
• pnpm --dir packages/common build
• pnpm --dir packages/server build
• pnpm --dir packages/client build

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
rpgjs	🟢 Ready	View Preview	Jul 2, 2026, 12:18 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.