Third-Person-MC AGENTS.md

AGENTS.md - Development Guide for AI Coding Agents

This document provides essential information for AI coding agents working in this repository.

---

Build, Lint, and Test Commands

Package Manager

This project uses pnpm. Always use pnpm instead of npm or yarn.

Development

pnpm dev              # Start development server with hot reload
pnpm build            # Build for production
pnpm preview          # Preview production build locally

Linting

pnpm lint             # Check code for linting errors
pnpm lint:fix         # Auto-fix linting issues

Testing

# E2E tests with Playwright (located in tests/ directory)
pnpm test:chrome      # Run tests in Chromium (headed mode)
pnpm test:firefox     # Run tests in Firefox (headed mode)
pnpm test:safari      # Run tests in WebKit/Safari (headed mode)

Running a single test:

npx playwright test tests/browsers.test.js --headed --project=chromium
npx playwright test tests/browsers.test.js:10 --headed  # Run specific line

Cleanup

pnpm clean:dist       # Remove dist directory
pnpm clean:report     # Remove Playwright test reports

---

Code Style Guidelines

Language & Modules

• Pure JavaScript (no TypeScript) with ES modules ("type": "module")
• Use .js extensions explicitly in imports
• Use JSDoc comments for type hints where beneficial

Formatting (ESLint - Antfu)

• Style Guide: Follows @antfu/eslint-config defaults
• Print width: 120 characters
• Indentation: 2 spaces (no tabs)
• Semicolons: None (Never use semicolons)
• Quotes: Single quotes (') for JS/Vue, single for JSX
• Trailing commas: All (Multi-line objects/arrays)
• Arrow parens: Always
• Line endings: CRLF (Windows)
• Plugins: prettier-plugin-tailwindcss for class sorting

CRITICAL FORMATTING RULES:

1. Respect Existing Style: When modifying a file, mimic the existing formatting (braces, blank lines, sorting) exactly.
2. Vue SFC: Do NOT indent top-level content inside <script setup> or <style>.
3. Minimal Changes: Do NOT reformat the entire file. Only apply formatting to your specific changes.
4. Antfu Nuances: Allow single-line if statements without braces.