eslint-plugin-light 1.0.22 → 1.0.24

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## <small>1.0.24 (2026-06-02)</small>
+
+* feat(eslint-plugin-light): add no-barrel-import ([38dfe30](https://github.com/novlan1/plugin-light/commits/38dfe30))
+* chore: update plugin-light docs address ([9c7d627](https://github.com/novlan1/plugin-light/commits/9c7d627))
+
+
+
+## <small>1.0.23 (2026-04-27)</small>
+
+* feat(plugin-light): 三元表达式不修复 ([ecabda4](https://github.com/novlan1/plugin-light/commits/ecabda4))
+* chore: update docs ([84adc98](https://github.com/novlan1/plugin-light/commits/84adc98))
+
+
+
 ## <small>1.0.22 (2026-03-24)</small>
 
 * feat: add no-complex-style-class rule ([2cc25ee](https://github.com/novlan1/plugin-light/commits/2cc25ee))

package/README.md

@@ -5,8 +5,8 @@
   <img src="https://img.shields.io/npm/unpacked-size/eslint-plugin-light">
   <img src="https://img.shields.io/npm/v/eslint-plugin-light">
   <img src="https://img.shields.io/npm/l/eslint-plugin-light">
-  <img src="https://img.shields.io/github/last-commit/novlan1/plugin-light">
-  <img src="https://img.shields.io/github/created-at/novlan1/plugin-light">
+  <img src="https://img.shields.io/badge/TypeScript-strict-blue?logo=typescript&logoColor=white" alt="TypeScript strict">
+  <img src="https://img.shields.io/badge/created-2022--01-blue?logo=github&logoColor=white">
 </p>
 
 简单、易用的 ESLint 插件库。
@@ -870,6 +870,88 @@ module.exports = {
 <div :style="{ color: getColor() }" />
 ```
 
+### 4.20. no-barrel-import
+
+禁止从指定包的入口（barrel / 桶文件）直接 `import`，必须按子路径引入。
+
+背景：
+
+> 从包入口直接 `import` 时，webpack 解析阶段会把整个包（含 `file-loader` 引入的图片资源）全量打入产物，tree-shaking 也无法消除这部分体积。按子路径引入可以只打包真正用到的子模块，显著减小产物体积。
+
+默认目标包是 `press-pix`，其目录结构为：包根目录下直接是 kebab-case 组件目录，每个组件目录里有同名入口文件，并且是 `export default`。
+
+错误示例：
+
+```js
+// ❌ 从 barrel 入口引入
+import { CdnImage } from 'press-pix';
+```
+
+正确示例：
+
+```js
+// ✅ 按子路径引入
+import CdnImage from 'press-pix/cdn-image/cdn-image';
+```
+
+如果加了 `--fix`，命名导入会被自动转换为子路径的默认导入：
+
+```js
+// 转换前
+import { CdnImage, IconButton } from 'press-pix';
+
+// 转换后
+import CdnImage from 'press-pix/cdn-image/cdn-image';
+import IconButton from 'press-pix/icon-button/icon-button';
+```
+
+Usage:
+
+```js
+// .eslintrc.js
+
+module.exports = {
+  plugins: [
+    'light',
+  ],
+  rules: {
+    'light/no-barrel-import': 2,
+  },
+}
+```
+
+配置选项：
+
+| 字段 | 说明 | 默认值   |
+| ------------- | -------- | --------- |
+| packages | 受限的包名列表（barrel 入口） | `['press-pix']` |
+| pathTemplate  | 子路径模板，支持 `{pkg}` 和 `{name}` 占位符                      | `'{pkg}/{name}/{name}'` |
+| defaultExport | 子模块是否默认导出（`true` 时 `--fix` 会写成 default import）| `true` |
+| mapping       | 个别命名的硬编码覆盖映射（`{ 导入名: 完整子路径 }`  | `{}` |
+
+自定义配置示例：
+
+```js
+// .eslintrc.js
+
+module.exports = {
+  plugins: [
+    'light',
+  ],
+  rules: {
+    'light/no-barrel-import': [2, {
+      packages: ['press-pix', 'some-other-pkg'],
+      pathTemplate: '{pkg}/{name}/{name}',
+      defaultExport: true,
+      mapping: {
+        // 对于命名不规则的子模块，可以单独指定路径
+        SpecialIcon: 'press-pix/icons/special',
+      },
+    }],
+  },
+}
+```
+
 ## 5. 更新日志
 
 [点此查看](./CHANGELOG.md)

package/lib/rules/img-v-lazy.js

@@ -9,11 +9,25 @@ module.exports = {
       recommended: true,
     },
     fixable: 'code',
+    messages: {
+      useVLazy: 'Use v-lazy instead of :src for image loading',
+      useVLazyManual: 'Use v-lazy instead of :src for image loading (manual replacement required: conditional or fallback expression detected)',
+    },
     schema: [],
   },
   create(context) {
     const sourceCode = context.sourceCode || context.getSourceCode();
 
+    // 判断一个节点是否含有字符串字面量（递归检查 || 链）
+    function hasStringLiteral(n) {
+      if (!n) return false;
+      if (n.type === 'Literal' && typeof n.value === 'string') return true;
+      if (n.type === 'LogicalExpression' && n.operator === '||') {
+        return hasStringLiteral(n.left) || hasStringLiteral(n.right);
+      }
+      return false;
+    }
+
     const parserServices = getParserServices(context);
     if (!parserServices?.defineTemplateBodyVisitor) {
       return {};
@@ -32,30 +46,40 @@ module.exports = {
                  && attr.key.name.name === 'lazy');
 
         if (srcBinding && !hasVLazy) {
-          context.report({
-            node,
-            message: 'Use v-lazy instead of :src for image loading',
-            fix(fixer) {
-              // 获取 :src 绑定的完整表达式文本
-              const srcText = sourceCode.getText(srcBinding.value.expression);
-
-              // 获取 :src 属性的完整文本
-              const fullSrcText = sourceCode.getText(srcBinding);
-
-              // 计算替换文本
-              let replacement;
-              if (fullSrcText.startsWith(':')) {
-                replacement = `v-lazy="${srcText}"`;
-              } else if (fullSrcText.startsWith('v-bind:')) {
-                replacement = `v-lazy="${srcText}"`;
-              } else {
-                replacement = `v-lazy="${srcText}"`;
-              }
-
-              // 精确替换，不添加额外空格
-              return fixer.replaceText(srcBinding, replacement);
-            },
-          });
+          const expr = srcBinding.value && srcBinding.value.expression;
+
+          const isConditional = expr && expr.type === 'ConditionalExpression';
+          const isLogicalOr = expr && expr.type === 'LogicalExpression' && expr.operator === '||';
+          const isLiteral = expr && expr.type === 'Literal';
+
+          // 三元表达式 → 手动
+          // 顶层字符串字面量 → 手动
+          // || 且含字符串字面量 → 用反引号自动修复
+          // || 且不含字符串字面量 → 正常双引号自动修复
+          if (isConditional || isLiteral) {
+            context.report({
+              node,
+              messageId: 'useVLazyManual',
+            });
+          } else if (isLogicalOr && hasStringLiteral(expr)) {
+            context.report({
+              node,
+              messageId: 'useVLazy',
+              fix(fixer) {
+                const srcText = sourceCode.getText(expr);
+                return fixer.replaceText(srcBinding, `v-lazy=\`${srcText}\``);
+              },
+            });
+          } else {
+            context.report({
+              node,
+              messageId: 'useVLazy',
+              fix(fixer) {
+                const srcText = sourceCode.getText(expr);
+                return fixer.replaceText(srcBinding, `v-lazy="${srcText}"`);
+              },
+            });
+          }
         }
       },
     });

package/lib/rules/no-barrel-import.js

@@ -0,0 +1,116 @@
+'use strict';
+
+/**
+ * 禁止从指定包的入口（barrel / 桶文件）直接 import，必须按子路径引入，
+ * 否则 webpack 解析阶段会把整个包（含 file-loader 引入的图片资源）
+ * 全量打入产物，tree-shaking 也救不回来。
+ *
+ * 默认配置以 press-pix 为目标包：
+ *   错误：import { CdnImage } from 'press-pix';
+ *   正确：import CdnImage from 'press-pix/cdn-image/cdn-image';
+ *
+ * press-pix 的实际目录结构：包根目录下直接是 kebab-case 组件目录，
+ * 每个组件目录里有同名入口文件，并且是 `export default`。
+ *
+ * 配置：
+ *   {
+ *     packages: ['press-pix'],            // 受限的包名（barrel 入口）
+ *     pathTemplate: '{pkg}/{name}/{name}',         // 子路径模板
+ *     defaultExport: true,                         // 子模块是否默认导出（true 时 fix 会写成 default import）
+ *     mapping: { Foo: 'press-pix/foo/foo' } // 个别命名硬编码覆盖
+ *   }
+ */
+
+function toKebabCase(str) {
+  return String(str)
+    .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+    .replace(/([A-Z]+)([A-Z][a-z])/g, '$1-$2')
+    .replace(/_/g, '-')
+    .toLowerCase();
+}
+
+function buildSubPath(pkg, specifierName, options) {
+  if (options.mapping && options.mapping[specifierName]) {
+    return options.mapping[specifierName];
+  }
+  const tpl = options.pathTemplate || '{pkg}/{name}/{name}';
+  const kebab = toKebabCase(specifierName);
+  return tpl.replace(/\{pkg\}/g, pkg).replace(/\{name\}/g, kebab);
+}
+
+module.exports = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: '禁止从包入口（barrel）直接 import，必须按子路径引入',
+      category: 'Best Practices',
+      recommended: true,
+    },
+    fixable: 'code',
+    schema: [
+      {
+        type: 'object',
+        properties: {
+          packages: { type: 'array', items: { type: 'string' } },
+          pathTemplate: { type: 'string' },
+          defaultExport: { type: 'boolean' },
+          mapping: {
+            type: 'object',
+            additionalProperties: { type: 'string' },
+          },
+        },
+        additionalProperties: false,
+      },
+    ],
+    messages: {
+      noEntryImport: '禁止从 \'{{pkg}}\' 入口直接引入，请按子路径引入（如 \'{{pkg}}/cdn-image/cdn-image\'），否则 webpack 会把整个包打进产物。',
+    },
+  },
+
+  create(context) {
+    const options = (context.options && context.options[0]) || {};
+    const packages = options.packages && options.packages.length
+      ? options.packages
+      : ['press-pix'];
+    // press-pix 的子模块都是 default 导出，所以默认 true
+    const useDefault = options.defaultExport !== false;
+
+    return {
+      ImportDeclaration(node) {
+        const importPath = node.source.value;
+        if (!packages.includes(importPath)) {
+          return;
+        }
+
+        const specifiers = node.specifiers || [];
+        // 只对 named import 提供 autofix（最常见、最安全的场景）
+        const allNamed = specifiers.length > 0
+          && specifiers.every(s => s.type === 'ImportSpecifier');
+
+        context.report({
+          node,
+          messageId: 'noEntryImport',
+          data: { pkg: importPath },
+          fix: allNamed
+            ? (fixer) => {
+              const lines = specifiers.map((s) => {
+                const importedName = s.imported.name;
+                const localName = s.local.name;
+                const subPath = buildSubPath(importPath, importedName, options);
+                if (useDefault) {
+                  // import LocalName from 'xxx';
+                  return `import ${localName} from '${subPath}';`;
+                }
+                const part = importedName === localName
+                  ? `{ ${importedName} }`
+                  : `{ ${importedName} as ${localName} }`;
+                return `import ${part} from '${subPath}';`;
+              });
+              return fixer.replaceText(node, lines.join('\n'));
+            }
+            : null,
+        });
+      },
+    };
+  },
+};

package/lib/test/img-v-lazy.js

@@ -0,0 +1,87 @@
+const { RuleTester } = require('eslint');
+
+const rule = require('../rules/img-v-lazy');
+
+const FILENAME = 'test.vue';
+
+const ruleTester = new RuleTester({
+  parser: require.resolve('vue-eslint-parser'),
+  parserOptions: {
+    ecmaVersion: 'latest',
+    sourceType: 'module',
+  },
+});
+
+ruleTester.run('img-v-lazy', rule, {
+  valid: [
+    // 已使用 v-lazy，合法
+    {
+      code: '<template><img v-lazy="imgUrl" /></template>',
+      filename: FILENAME,
+    },
+    // 静态 src（非绑定），合法
+    {
+      code: '<template><img src="https://example.com/image.png" /></template>',
+      filename: FILENAME,
+    },
+    // 已同时有 :src 和 v-lazy，合法
+    {
+      code: '<template><img :src="imgUrl" v-lazy="imgUrl" /></template>',
+      filename: FILENAME,
+    },
+    // 非 img 标签，合法
+    {
+      code: '<template><div :src="imgUrl"></div></template>',
+      filename: FILENAME,
+    },
+  ],
+  invalid: [
+    // 普通变量绑定，可自动修复
+    {
+      code: '<template><img :src="imgUrl" /></template>',
+      filename: FILENAME,
+      errors: [{ messageId: 'useVLazy' }],
+      output: '<template><img v-lazy="imgUrl" /></template>',
+    },
+    // 成员表达式，可自动修复
+    {
+      code: '<template><img :src="item.imageUrl" /></template>',
+      filename: FILENAME,
+      errors: [{ messageId: 'useVLazy' }],
+      output: '<template><img v-lazy="item.imageUrl" /></template>',
+    },
+    // 字符串字面量，需手动替换（无 output / fix）
+    {
+      code: '<template><img :src="\'https://example.com/img.png\'" /></template>',
+      filename: FILENAME,
+      errors: [{ messageId: 'useVLazyManual' }],
+    },
+    // 三元表达式，需手动替换（无 output / fix）
+    {
+      code: '<template><img :src="item.img ? item.img : \'https://example.com/default.png\'" /></template>',
+      filename: FILENAME,
+      errors: [{ messageId: 'useVLazyManual' }],
+    },
+    // 逻辑或 + 字符串字面量，用反引号自动修复
+    {
+      code: '<template><img :src="item.img || \'https://example.com/default.png\'" /></template>',
+      filename: FILENAME,
+      errors: [{ messageId: 'useVLazy' }],
+      output: '<template><img v-lazy=`item.img || \'https://example.com/default.png\'` /></template>',
+    },
+    // 逻辑或 + 两侧都是变量，正常双引号自动修复
+    {
+      code: '<template><img :src="item.img || fallbackImg" /></template>',
+      filename: FILENAME,
+      errors: [{ messageId: 'useVLazy' }],
+      output: '<template><img v-lazy="item.img || fallbackImg" /></template>',
+    },
+    // v-bind:src 写法，可自动修复
+    {
+      code: '<template><img v-bind:src="imgUrl" /></template>',
+      filename: FILENAME,
+      errors: [{ messageId: 'useVLazy' }],
+      output: '<template><img v-lazy="imgUrl" /></template>',
+    },
+  ],
+});

package/lib/test/index.js

@@ -1,3 +1,5 @@
+require('./img-v-lazy');
+require('./no-barrel-import');
 require('./no-complex-style-class');
 require('./no-decimal-in-brackets');
 require('./no-direct-img-src');

package/lib/test/no-barrel-import.js

@@ -0,0 +1,92 @@
+const { RuleTester } = require('eslint');
+
+const rule = require('../rules/no-barrel-import');
+
+const ruleTester = new RuleTester({
+  parserOptions: {
+    ecmaVersion: 2020,
+    sourceType: 'module',
+  },
+});
+
+ruleTester.run('no-barrel-import', rule, {
+  valid: [
+    // 子路径引入 —— 允许
+    'import CdnImage from \'press-pix/cdn-image/cdn-image\';',
+    'import DateTimePicker from \'press-pix/date-time-picker/date-time-picker\';',
+    'import PmgMatchingCountdown from \'press-pix/pmg-matching-countdown/pmg-matching-countdown\';',
+
+    // 不相关的包 —— 不应报错
+    'import React from \'react\';',
+    'import { something } from \'./local\';',
+    'import { CdnImage } from \'press-ui\';',
+    'import { CdnImage } from \'press-pix\';', // 没带  不在默认列表
+
+    // 自定义 packages 列表时，原默认包不应受限
+    {
+      code: 'import { CdnImage } from \'press-pix\';',
+      options: [{ packages: ['some-other-pkg'] }],
+    },
+  ],
+
+  invalid: [
+    // 默认配置：press-pix 入口引入 —— 报错并 autofix 成 default import
+    {
+      code: 'import { CdnImage } from \'press-pix\';',
+      output: 'import CdnImage from \'press-pix/cdn-image/cdn-image\';',
+      errors: [{ messageId: 'noEntryImport' }],
+    },
+    // 多个 specifier，按行拆分
+    {
+      code: 'import { CdnImage, DateTimePicker } from \'press-pix\';',
+      output: 'import CdnImage from \'press-pix/cdn-image/cdn-image\';\nimport DateTimePicker from \'press-pix/date-time-picker/date-time-picker\';',
+      errors: [{ messageId: 'noEntryImport' }],
+    },
+    // 多段大写：PmgMatchingCountdown -> pmg-matching-countdown
+    {
+      code: 'import { PmgMatchingCountdown } from \'press-pix\';',
+      output: 'import PmgMatchingCountdown from \'press-pix/pmg-matching-countdown/pmg-matching-countdown\';',
+      errors: [{ messageId: 'noEntryImport' }],
+    },
+    // 带别名：保持 default import 形态，local name 优先
+    {
+      code: 'import { CdnImage as Img } from \'press-pix\';',
+      output: 'import Img from \'press-pix/cdn-image/cdn-image\';',
+      errors: [{ messageId: 'noEntryImport' }],
+    },
+    // 默认导入：报错但不自动修复
+    {
+      code: 'import PressPix from \'press-pix\';',
+      output: null,
+      errors: [{ messageId: 'noEntryImport' }],
+    },
+    // namespace 导入：报错但不自动修复
+    {
+      code: 'import * as PressPix from \'press-pix\';',
+      output: null,
+      errors: [{ messageId: 'noEntryImport' }],
+    },
+    // 副作用引入：报错但不自动修复
+    {
+      code: 'import \'press-pix\';',
+      output: null,
+      errors: [{ messageId: 'noEntryImport' }],
+    },
+    // mapping 覆盖
+    {
+      code: 'import { Foo } from \'press-pix\';',
+      options: [{
+        mapping: { Foo: 'press-pix/foo/index' },
+      }],
+      output: 'import Foo from \'press-pix/foo/index\';',
+      errors: [{ messageId: 'noEntryImport' }],
+    },
+    // defaultExport: false 时回退到 named import
+    {
+      code: 'import { Foo } from \'press-pix\';',
+      options: [{ defaultExport: false }],
+      output: 'import { Foo } from \'press-pix/foo/foo\';',
+      errors: [{ messageId: 'noEntryImport' }],
+    },
+  ],
+});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "eslint-plugin-light",
-  "version": "1.0.22",
-  "description": "Simple Eslint Plugin",
+  "version": "1.0.24",
+  "description": "ESLint 插件",
   "keywords": [
     "eslint",
     "eslint plugin",
@@ -29,7 +29,7 @@
     "@tdesign/uniapp-chat": "^0.2.1",
     "minimatch": "^10.0.1",
     "requireindex": "^1.2.0",
-    "t-comm": "^3.0.22"
+    "t-comm": "^3.2.42"
   },
   "devDependencies": {
     "@babel/core": "^7.18.9",