prettier-plugin-xcbasic

Totally vibecoded Prettier plugin for formatting XC=BASIC source files (.bas).

What it formats

• keyword casing (upper, lower, or preserve)
• spacing around commas and operators (=, <, >, <=, >=, <>, +, -, *, /)
• unary sign handling (keeps -x, +x, a * -b, 1e-3 readable without breaking exponent notation)
• statement separators (:) as " : "
• indentation for common block structures (IF ... THEN, FOR, DO, SELECT CASE, TYPE, FUNCTION, SUB)
• preserves ASM ... END ASM block contents (only trims trailing whitespace)

Install

npm install --save-dev prettier prettier-plugin-xcbasic

Use

npx prettier --plugin prettier-plugin-xcbasic --write "**/*.bas"

Or in .prettierrc:

{
  "plugins": ["prettier-plugin-xcbasic"],
  "xcBasicKeywordCase": "upper",
  "xcBasicIndentSize": 2
}

Options

• xcBasicKeywordCase: upper (default), lower, preserve
• xcBasicIndentSize: integer spaces for indent (default: 2)

Validation

npm test
npm run test:corpus

• npm test runs fixture-based regression tests and idempotency checks.
• npm run test:corpus validates idempotency across ../examples/**/*.bas.

Release checklist

• Run npm run test:all on a clean checkout.
• Review examples/ formatting diff before tagging.
• Publish as a beta first (0.1.0-beta.x), then promote to stable after user feedback.