How secondsun-technologies/games-sdk works
The repository provides a games SDK plus a browser simulator for exercising registered games. The principal workflow is to register a game, render it within platform-managed context and session lifecycle, use declared capabilities and SDK UI primitives, then emit validated observational events. The simulator adds profile-driven runtime overrides and event inspection. Several runtime modules are named by the SOURCE INDEX but were not excerpted; edges are limited to relationships explicitly visible in excerpts or the README.
Main entry points: App.tsx Simulator app · renderGame.ts Platform game renderer · create-game.ts Game registration · harness.ts Development harness
Components 33
Game Contract
- Game registration
packages/games-sdk/src/core/create-game.ts - Game metadata
packages/games-sdk/src/types/metadata.ts - Branded identifiers
packages/games-sdk/src/types/branded.ts - Capability guard
packages/games-sdk/src/core/capability-guard.ts - Capability contracts
packages/games-sdk/src/types/capabilities.ts - Lifecycle context
packages/games-sdk/src/types/context.ts - Dev capability APIs
packages/games-sdk/src/dev/capability-apis.ts - Development harness
packages/games-sdk/src/dev/harness.ts - Mock contexts
packages/games-sdk/src/dev/mock-context.ts - SDK event inspector
packages/games-sdk/src/dev/event-inspector.ts
Platform Runtime
- Session lifecycle
packages/games-sdk/src/platform/session.ts - Platform game renderer
packages/games-sdk/src/platform/renderGame.ts - Platform runtime
packages/games-sdk/src/platform/runtime.ts - Event gate
packages/games-sdk/src/platform/eventGate.ts
Events and State
- Event contracts
packages/games-sdk/src/events/event-types.ts - Event emitter
packages/games-sdk/src/events/event-emitter.ts - Event validation
packages/games-sdk/src/events/event-validators.ts - Game state API
packages/games-sdk/src/state/index.ts
Game UI
- Theme tokens
packages/games-sdk/src/theme/tokens.ts - Theme defaults
packages/games-sdk/src/theme/defaults.ts - Theme context
packages/games-sdk/src/theme/context.tsx - UI primitives
packages/games-sdk/src/ui/primitives - Motion helpers
packages/games-sdk/src/ui/animation/motion.ts
SDK Simulator
- Simulator app
packages/games-sdk-simulator/src/App.tsx - Device profiles
packages/games-sdk-simulator/src/deviceProfiles.ts - Runtime builder
packages/games-sdk-simulator/src/runtimeBuilder.ts - Game loader
packages/games-sdk-simulator/src/gameLoader.ts - Control panel
packages/games-sdk-simulator/src/components/ControlPanel.tsx - Device frame
packages/games-sdk-simulator/src/components/DeviceFrame.tsx - Session controls
packages/games-sdk-simulator/src/components/SessionControls.tsx - Event inspector
packages/games-sdk-simulator/src/components/EventInspector.tsx
Other components
- Game developer
- Simulator user
Connections 35
- Game developer → Game registration: registers game
- Game registration → Game metadata: validates metadata
packages/games-sdk/src/core/create-game.ts - Game developer → Capability guard: requests capabilities
- Capability guard → Capability contracts: checks declarations
packages/games-sdk/src/core/capability-guard.ts - Game registration → Capability contracts: checks declarations
packages/games-sdk/src/core/create-game.ts - Session lifecycle → Lifecycle context: creates snapshots
packages/games-sdk/src/platform/session.ts - Platform game renderer → Game registration: renders registered game
packages/games-sdk/src/platform/renderGame.ts - Platform game renderer → Lifecycle context: provides context
packages/games-sdk/src/platform/renderGame.ts - Platform game renderer → Platform runtime: uses runtime
packages/games-sdk/src/platform/renderGame.ts - Platform game renderer → Session lifecycle: uses session
packages/games-sdk/src/platform/renderGame.ts - Platform game renderer → Event gate: uses event gate
packages/games-sdk/src/platform/renderGame.ts - Game developer → Event emitter: emits observations
- Event emitter → Event validation: validates events
packages/games-sdk/src/events/event-emitter.ts - Event emitter → Event contracts: accepts event types
packages/games-sdk/src/events/event-emitter.ts - Event validation → Event contracts: validates event shapes
packages/games-sdk/src/events/event-validators.ts - Game developer → Game state API: requests state save
- Theme context → Theme tokens: uses tokens
packages/games-sdk/src/theme/context.tsx - Theme context → Theme defaults: loads defaults
packages/games-sdk/src/theme/context.tsx - UI primitives → Theme tokens: styles with tokens
packages/games-sdk/src/ui/primitives/View.tsx - Simulator user → Simulator app: configures and inspects
packages/games-sdk-simulator/src/App.tsx - Simulator app → Device profiles: selects profile
packages/games-sdk-simulator/src/App.tsx - Simulator app → Runtime builder: builds runtime
packages/games-sdk-simulator/src/App.tsx - Simulator app → Control panel: renders controls
packages/games-sdk-simulator/src/App.tsx - Simulator app → Device frame: renders device
packages/games-sdk-simulator/src/App.tsx - Simulator app → Event inspector: renders events
packages/games-sdk-simulator/src/App.tsx - Device frame → Game loader: loads game
packages/games-sdk-simulator/src/components/DeviceFrame.tsx - Device frame → Session controls: renders controls
packages/games-sdk-simulator/src/components/DeviceFrame.tsx - Simulator app → Event inspector: records events
packages/games-sdk-simulator/src/App.tsx - Game loader → Game registration: loads SDK game
packages/games-sdk-simulator/src/gameLoader.ts - Dev capability APIs → Capability contracts: implements APIs
- Development harness → Mock contexts: uses mock contexts
packages/games-sdk/src/dev/index.ts - Development harness → Dev capability APIs: uses capability APIs
packages/games-sdk/src/dev/index.ts - Development harness → SDK event inspector: uses event inspector
packages/games-sdk/src/dev/index.ts - Mock contexts → Branded identifiers: creates branded values
packages/games-sdk/src/dev/mock-context.ts - Motion helpers → UI primitives: supports UI motion