CODE_STYLE.md

Code Style

Formatting

Prettier enforces: 4-space indent, single quotes, no semicolons, 120 char width.

See CONTRIBUTING.md for commands.

Naming

• PascalCase - Components, classes, types, interfaces
• camelCase - Functions, variables, methods

Nullish Handling

Use ?? for default values (checks null/undefined only):

const value = input ?? 'default'

Use || only when checking all falsy values.

No Dead Code

Remove unused variables, imports, and commented-out code immediately.

Comments

Explain "why", not "what". Code should be self-documenting.

Early Returns

Use guard clauses to avoid deep nesting:

function process(item) {
  if (!item) return
  if (!item.isValid) return
  // main logic here
}

Single Responsibility

Functions should do one thing. Consider refactoring if exceeding 20-30 lines.

Magic Numbers

Use named constants:

const STATUS_PRINTING = 3
if (status === STATUS_PRINTING) { ... }

Performance

Use @Debounce(ms) for inputs triggering API calls. Use throttle() for resize handlers.

Console Logging

No raw console.log in production code.

For debug output, define a class method with a descriptive prefix:

log(msg: string, obj?: unknown): void {
    const message = `[MyFeature] ${msg}`
    if (obj) {
        window.console.log(message, obj)
        return
    }
    window.console.log(message)
}