docs: update game patterns documentation

dragDropEventEffect

Replace Phaser event emissions with a `DragDropCallback` in
`dragDropEventEffect` to provide a more explicit and type-safe API
for handling drag-and-drop interactions.

docs/GamePatterns.md

@@ -13,7 +13,7 @@ packages/my-game/
 │   ├── game/          # Pure game logic (re-exported from boardgame-core)
 │   ├── scenes/        # Phaser scenes (MenuScene, GameScene)
 │   ├── spawners/      # Data-driven object lifecycle
-│   ├── renderers/     # Renderers for game objects
+│   ├── gameobjects/   # Phaser GameObject or Container extensions
 │   ├── state/         # UI-only reactive state
 │   ├── config.ts      # Centralized layout & style constants
 │   └── ui/App.tsx     # Preact root component
@@ -24,7 +24,7 @@ packages/my-game/
 | `game/` | State, commands, prompts, validation (pure logic) |
 | `scenes/` | Phaser lifecycle, input handling, visual composition |
 | `spawners/` | Reactive game object spawn/update/despawn |
-| `renderers/` | Phaser visual representation of game objects |
+| `gameobjects/` | Phaser GameObjects or containers |
 | `state/` | UI-only reactive state (selection, hover, etc.) |
 | `ui/` | Preact components bridging Phaser and DOM |
 
@@ -51,9 +51,9 @@ Use `MutableSignal` for UI-only state, separate from game state.
 - Clean up effects on object `'destroy'` to prevent leaks.
 - See: `packages/onitama-game/src/state/ui.ts`
 
-### 4. Custom Containers
+### 4. Custom GameObjects / Containers
 Extend `Phaser.GameObjects.Container` to encapsulate visuals and state.
-- Store logical state as private signals.
+- Use signals from `states/`, avoid relying on complex interal state.
 - Use `effect()` for reactive highlights/selections.
 
 ### 5. Tween Interruption
@@ -66,6 +66,12 @@ Otherwise the game logic will hang.
 Use `await this.sceneController.launch('SceneKey')`.
 Register scenes in `App.tsx` via `<PhaserScene>`. Pass data via `data` prop.
 
+### 7. Central Config
+Use `src/config/layout.ts` for shared constants like `CELL_SIZE`, `BOARD_OFFSET`, etc.
+Use `src/config/colors.ts` for shared colors.
+Use `src/config/text.ts` for text styles.
+
+
 ## Best Practices
 
 - **Centralize Config**: Keep `CELL_SIZE`, `BOARD_OFFSET`, colors, etc., in `src/config.ts` with `as const`. Avoid magic numbers.

packages/framework/src/index.ts

@@ -4,7 +4,7 @@ export type { IDisposable, DisposableItem } from "./utils";
 
 // Drag & drop utilities
 export { dragDropEventEffect, DragDropEventType } from "./utils";
-export type { DragDropEvent } from "./utils";
+export type { DragDropEvent, DragDropCallback } from "./utils";
 
 // Data-driven object spawning
 export { spawnEffect } from "./spawner";

packages/framework/src/utils/dnd.ts

@@ -18,8 +18,11 @@ export type DragDropEvent = {
   deltaY: number;
 };
 
+export type DragDropCallback = (event: DragDropEvent) => void;
+
 export function dragDropEventEffect(
   gameObject: Phaser.GameObjects.GameObject,
+  callback: DragDropCallback,
   disposables?: DisposableBag,
 ): () => void {
   let isDragging = false;
@@ -35,8 +38,7 @@ export function dragDropEventEffect(
       deltaX: 0,
       deltaY: 0,
     };
-    gameObject.emit("drag", event);
+    callback(event);
-    gameObject.emit("dragstart", event);
   }
 
   function onPointerUp(pointer: Phaser.Input.Pointer) {
@@ -46,8 +48,7 @@ export function dragDropEventEffect(
     const deltaX = pointer.x - down.x;
     const deltaY = pointer.y - down.y;
     const event: DragDropEvent = { type: DragDropEventType.UP, deltaX, deltaY };
-    gameObject.emit("drag", event);
+    callback(event);
-    gameObject.emit("dragend", event);
     down = null;
   }
 
@@ -61,8 +62,7 @@ export function dragDropEventEffect(
       deltaX,
       deltaY,
     };
-    gameObject.emit("drag", event);
+    callback(event);
-    gameObject.emit("dragmove", event);
   }
 
   gameObject.on("pointerdown", onPointerDown);

packages/framework/src/utils/index.ts

@@ -4,4 +4,5 @@ export {
   dragDropEventEffect,
   DragDropEventType,
   type DragDropEvent,
+  type DragDropCallback,
 } from "./dnd";