Registry / devops / prettier-plugin-litsx

prettier-plugin-litsx

library0.3.3jsnpmunverified

Official Prettier plugin for formatting LitSX-authored source files (`.litsx` and `.litsx.jsx`). Version 0.3.3 requires Prettier ^3.0.0 and supports ESM and CJS. It preserves LitSX-specific syntax such as `@event`, `.prop`, `?attr`, and static CSS templates. CSS inside `static styles = \`...\`;` is formatted with Prettier's CSS parser only when no `${...}` interpolation is present. This plugin does not handle plain `.tsx` or `.jsx` files, focusing solely on LitSX formats. It is actively maintained with a public release.

devops

npm install prettier-plugin-litsx

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · PRETTIER-PLUGIN-LI

prettier-plugin-litsx

devopsjavascriptv0.3.3

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

plugin

✓ import plugin from 'prettier-plugin-litsx'

✗ const plugin = require('prettier-plugin-litsx')

Package exports default plugin object. CommonJS require() may not work in some bundler configurations.

parsers

✓ import { parsers } from 'prettier-plugin-litsx'

✗ const parsers = require('prettier-plugin-litsx').parsers

Named export for parsers object.

litsx & litsx-jsx

✓ import { parsers } from 'prettier-plugin-litsx'; const litsx = parsers['litsx']; const litsxJsx = parsers['litsx-jsx'];

✗ import { litsx } from 'prettier-plugin-litsx'

Individual parser names are not direct exports; access via parsers object.

Shows installation, configuration using overrides for LitSX files, and formatting command.

// Install: npm install -D prettier prettier-plugin-litsx // .prettierrc { "plugins": ["prettier-plugin-litsx"], "overrides": [ { "files": "*.litsx", "options": { "parser": "litsx" } }, { "files": "*.litsx.jsx", "options": { "parser": "litsx-jsx" } } ] } // Format command: npx prettier --write "**/*.litsx"

Debug

Known issues

breakingRequires Prettier >= 3.0.0. Works with Prettier v2? No.

fix

Update Prettier to ^3.0.0.

affects: <0.1.0

deprecatedPackage versions prior to 0.3.0 may have incomplete CSS formatting for static styles.

fix

Upgrade to 0.3.0 or later for reliable CSS formatting.

affects: <0.3.0

gotchaDoes NOT format plain .tsx or .jsx files. Only .litsx and .litsx.jsx.

fix

Use @prettier/plugin-prettier or other plugins for standard TSX/JSX.

affects: >=0.0.0

gotchaCSS formatting only applies to fully static template literals without ${...}.

fix

Ensure static styles are literal strings; interpolations will not be reformatted.

affects: >=0.0.0

deprecatedVersion 0.2.x used a different export structure.

fix

Update to 0.3.x for stable API.

affects: 0.2.x

Errors

Common errors & fixes

Error: Could not find plugin 'prettier-plugin-litsx'

Plugin not installed or Prettier version mismatch.

fix

Run 'npm install -D prettier-plugin-litsx' and ensure Prettier >=3.0.0.

TypeError: prettier.resolveConfig.sync is not a function

Using Prettier v2 API which is incompatible with v3.

fix

Upgrade Prettier to ^3.0.0 and use async APIs if needed.

Unexpected token '.' (expected 'name')

Using the plugin on a plain .jsx file without parser override.

fix

Add override for .litsx files or use correct parser explicitly.

Upgrade

Version history

0.3.3latest on npm

Audit

Dependencies

prettierrequiredpeer dependency required for plugin functionality

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/litsxdev/litsx ↗

packageprettier-plugin-litsx ↗

homepagehttps://litsx.dev/ ↗