@salesforcedevs/sfdocs-liquid-lint-tag-duplicates

Overview

This plugin validates that Liquid variable names are unique within a file, preventing duplicate declarations that could cause runtime issues. It's generic and configurable, supporting any Liquid tag and directory pattern.

Features

✅ Generic & Reusable - Works with any Liquid tag (capture, assign, etc.)
✅ Directory Filtering - Only checks files in specified directories
✅ Code Block Protection - Ignores tags inside markdown code blocks
✅ Accurate Line Numbers - Reports exact location of duplicates
✅ Test Coverage - Comprehensive test suite included

Installation

yarn add @salesforcedevs/sfdocs-liquid-lint-tag-duplicates

Usage

Basic Usage

Register the plugin in your lintConfig.ts or remark configuration:

const plugins_conf = {
    // Check for duplicate capture blocks in shared/partials
    'liquid-capture-duplicates': [
        require('@salesforcedevs/sfdocs-liquid-lint-tag-duplicates'),
        ['error', { tag: 'capture', directory: 'shared/partials' }]
    ],
};

Multiple Configurations

You can use the same plugin multiple times with different configurations:

const internalPluginsConf = {
    // Check capture tags in shared/partials
    'liquid-capture-duplicates': [
        require('@salesforcedevs/sfdocs-liquid-lint-tag-duplicates'),
        ['error', { tag: 'capture', directory: 'shared/partials' }]
    ],

    // Check assign tags in templates directory
    'liquid-assign-duplicates': [
        require('@salesforcedevs/sfdocs-liquid-lint-tag-duplicates'),
        ['error', { tag: 'assign', directory: 'templates' }]
    ],
};