stylelint-logical-spec

A stylelint plugin to enforce the use of logical properties and values instead of physical ones.

[!NOTE] This project is a fork of Jordan-Hall/stylelint-use-logical-spec (originally inspired by csstools/stylelint-use-logical).

Why this fork exists:

• Modernization: Full migration to TypeScript for better type safety and developer experience.
• Compatibility: Support for Stylelint 16 and 17+.
• Standardization: Converted to a native ES Module (ESM) and modernized testing infrastructure.

Installation

npm install stylelint-logical-spec --save-dev

Usage

Add it to your stylelint configuration:

{
  "plugins": ["stylelint-logical-spec"],
  "rules": {
    "liberty/use-logical-spec": true
  }
}

Rules

liberty/use-logical-spec

Enforces logical properties and values like margin-block-start instead of physical ones like margin-top.

Options

• direction: ltr (default) or rtl. Controls the mapping of physical properties to logical ones.
• except: An array of properties or regex patterns to ignore.

{
  "rules": {
    "liberty/use-logical-spec": [true, { "direction": "rtl", "except": ["top"] }]
  }
}

Supports auto-fixing with --fix.

License

CC0-1.0