feat: setup project

packages/shared/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@idle/shared",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "scripts": {
+    "build": "tsc --noEmit",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0"
+  }
+}

packages/shared/src/index.ts

@@ -0,0 +1 @@
+export * from './protocol';

packages/shared/src/protocol.ts

@@ -0,0 +1,41 @@
+/**
+ * Протокол WS — контракт между сервером и клиентами (overlay / web).
+ * Клиенты зависят только от него; язык сервера можно сменить позже.
+ * Версия проверяется в рукопожатии (hello/welcome), чтобы OBS со старым
+ * бандлом не висел молча.
+ */
+
+export const PROTOCOL_VERSION = 1;
+
+export interface AvatarState {
+  id: string;
+  name: string;
+  /** Цвет ника из тегов чата Twitch. */
+  color: string;
+  /** Позиция в мировых координатах, px. */
+  x: number;
+  y: number;
+  face: 'left' | 'right';
+  moving: boolean;
+}
+
+export interface WelcomeMsg {
+  t: 'welcome';
+  v: number;
+  /** Период тика симуляции, мс — клиенту для отрисовки прогрессов. */
+  tickMs: number;
+}
+
+/** M0: полный снапшот каждый тик; дельты появятся с M1. */
+export interface SnapshotMsg {
+  t: 'snapshot';
+  tick: number;
+  avatars: AvatarState[];
+}
+
+export type ServerMessage = WelcomeMsg | SnapshotMsg;
+
+export type ClientMessage = {
+  t: 'hello';
+  v: number;
+};

packages/shared/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "lib": ["ES2022"]
+  },
+  "include": ["src"]
+}