miaoda-game-grid-piece-react

Use this React adapter to render multi-cell pieces in sliding puzzles, grid inventories, and placement UIs. It exposes core placements and absolute occupied cells without owning drag animation or a physics loop.

Install and use

pnpm add miaoda-game-grid-piece-core miaoda-game-grid-piece-react

const controller = new GridPieceController({ width: 8, height: 8 });
const view = useGridPieceView(controller);
controller.add({ id: 'crate', shape: rect(2, 2) }, { x: 1, y: 1 });
controller.rotate('crate');

view.pieces.map((piece) => renderPiece(piece.placement, piece.cells));

Use cellState(x, y) for drop previews. Collision, walls, rotation normalization, and legality remain in core; React maps the latest event or view to CSS transitions.