@itcase/lint 1.1.98 → 1.1.99

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+## [1.1.99](https://github.com/ITCase/itcase-lint/compare/v1.1.98...v1.1.99) (2026-03-06)
+
+### Features
+
+* **eslint:** Add new rules / refactoring in exist rule / change rulees names ([206ee3c](https://github.com/ITCase/itcase-lint/commit/206ee3c9924d98ad7791d9c9bba294bf49440bb9))
+* **eslint:** Add regexp ([a7b4756](https://github.com/ITCase/itcase-lint/commit/a7b47566b2bb2ec199c015abf46863fdaefd546a))
+* **eslint:** Add restrict words ([3bfb815](https://github.com/ITCase/itcase-lint/commit/3bfb81569d16388ac3d4d1ea071b8a9a5d397c56))
+
 ## [1.1.98](https://github.com/ITCase/itcase-lint/compare/v1.1.97...v1.1.98) (2026-03-05)
 
 ### Bug Fixes

package/README.md

@@ -87,9 +87,22 @@ import eslintReactNative from '@itcase/lint/eslint/react-native/index.js'
 export default [...eslint, ...eslintMobx, ...eslintReactNative]
 ```
 
-### ESLint with data-test-id-plugin
+### Плагины ESLint
 
-`data-test-id-plugin` accepts these options:
+В пакет входят кастомные плагины, которые подключаются отдельно:
+
+| Плагин | Описание | Подключение |
+|--------|----------|-------------|
+| **itcase-lint/react-data-test-id** | Требует атрибут `data-test-id` / `dataTestId` у указанных компонентов | Входит в базовый `@itcase/lint/eslint`, правило включается вручную для нужных путей |
+| **itcase-lint/storybook-meta-parameters-design** | Требует в Storybook-сториз ссылку на Figma в `parameters.design` | `import eslintStorybook from '@itcase/lint/eslint/storybook'` и `...eslintStorybook` в конфиге |
+
+Ниже — подробное описание и примеры для каждого плагина.
+
+---
+
+### ESLint with itcase-lint/react-data-test-id
+
+`itcase-lint/react-data-test-id` принимает опции:
 
 ```ts
 appendElementNamesToCheck?: string[] | null
@@ -121,7 +134,7 @@ export default [
     ignores: ['./**/*.stories.*'],
     files: ['./packages/*.{ts,tsx,js,jsx}'],
     rules: {
-      'data-test-id-plugin/data-test-id': 'warn',
+      'itcase-lint/react-data-test-id': 'warn',
     },
   },
 ]
@@ -138,7 +151,7 @@ export default [
     ignores: ['./**/*.stories.*'],
     files: ['./packages/*.{ts,tsx,js,jsx}'],
     rules: {
-      'data-test-id-plugin/data-test-id': [
+      'itcase-lint/react-data-test-id': [
         'warn',
         {
           overrideElementNamesToIgnore: ['IgnoredElement', 'Html', 'SkipMe'],
@@ -151,6 +164,39 @@ export default [
 ]
 ```
 
+### ESLint with Storybook (itcase-lint/storybook-meta-parameters-design)
+
+The `itcase-lint/storybook-meta-parameters-design` rule checks that Storybook stories include a `parameters.design` block with `type: 'figma'` and a non-empty `url` containing `figma.com`.
+
+**Setup**
+
+Add the Storybook config to `eslint.config.mjs`:
+
+```js
+import eslint from '@itcase/lint/eslint'
+import eslintStorybook from '@itcase/lint/eslint/storybook'
+
+export default [...eslint, ...eslintStorybook]
+```
+
+The rule `itcase-lint/storybook-meta-parameters-design` is enabled by default with level `warn` for files `**/*.stories.{ts,tsx,js,jsx,mjs,cjs}`.
+
+**Meta requirements**
+
+If the story’s default export has `parameters`, it must include a `parameters.design` object with `type: 'figma'` and a non-empty `url` containing `figma.com`. Example:
+
+```js
+export default {
+  component: MyComponent,
+  parameters: {
+    design: {
+      type: 'figma',
+      url: 'https://www.figma.com/design/...',
+    },
+  },
+}
+```
+
 ### Stylelint
 
 Create a `eslint.config.mjs` configuration file in the root of your project with the following content:

package/dist/eslint/plugin.d.ts

@@ -0,0 +1,17 @@
+import type { TSESLint } from '@typescript-eslint/utils';
+declare const itcaseLintPlugin: {
+    meta: {
+        name: string;
+        version: string;
+    };
+    processors: {};
+    rules: {
+        "react-data-test-id": TSESLint.RuleModule<"missingAttribute" | "missingAttributeValue", import("./react/dataTestIdPlugin/interface").Options, unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        "storybook-meta-parameters-design": TSESLint.RuleModule<"missingOrEmptyUrl" | "typeMustBeFigma" | "urlMustContainFigma", [], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+    };
+};
+export { itcaseLintPlugin };

package/dist/eslint/react/dataTestIdPlugin/example.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+declare const TestComponent4: () => React.JSX.Element;
+type SomeType = {};
+declare const TestComponent: React.ForwardRefExoticComponent<React.RefAttributes<unknown>>;
+declare function TestComponent2(_params: SomeType): React.JSX.Element;
+declare function TestComponent3(_params: SomeType): React.JSX.Element;
+declare function TestComponentWithMultipleGroups(): React.JSX.Element;
+declare const TestComponentWithDifferentElements: () => React.JSX.Element;
+declare const renderFunction: any;
+declare const anonymousRenderFunction: any;
+declare const anonymousRenderFunction2: any;
+declare const TestComponentWithRender: () => React.JSX.Element;
+export { anonymousRenderFunction, anonymousRenderFunction2, renderFunction, TestComponent, TestComponent2, TestComponent3, TestComponent4, TestComponentWithDifferentElements, TestComponentWithMultipleGroups, TestComponentWithRender, };

package/dist/eslint/react/dataTestIdPlugin/extra.d.ts

@@ -0,0 +1,8 @@
+import type { Context, Options, RuleVisitorsType } from './interface';
+declare const createRule: <Options extends readonly unknown[], MessageIds extends string>({ meta, name, ...rule }: Readonly<import("@typescript-eslint/utils/eslint-utils").RuleWithMetaAndName<Options, MessageIds, unknown>>) => import("@typescript-eslint/utils/ts-eslint").RuleModule<MessageIds, Options, unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+    name: string;
+};
+declare const ruleName = "react-data-test-id";
+declare const pluginName = "itcase-lint";
+declare const defaultOptions: Options;
+export { type Context, createRule, defaultOptions, type Options, pluginName, ruleName, type RuleVisitorsType as RuleVisitors, };

package/dist/eslint/react/dataTestIdPlugin/interface.d.ts

@@ -0,0 +1,12 @@
+import type { RuleContext, RuleVisitors } from '../../utils/types';
+import { type MessageIds } from './constants';
+type Options = [
+    {
+        appendElementNamesToCheck?: string[] | null;
+        overrideElementNamesToCheck?: string[] | null;
+        overrideElementNamesToIgnore?: string[] | null;
+    }
+];
+type Context = RuleContext<keyof MessageIds, Options>;
+type RuleVisitorsType = RuleVisitors<keyof MessageIds, Options>;
+export type { Context, Options, RuleVisitorsType };

package/dist/eslint/react/dataTestIdPlugin/plugin.d.ts

@@ -0,0 +1,46 @@
+import parser from '@typescript-eslint/parser';
+import { TSESLint } from '@typescript-eslint/utils';
+declare const pluginWithConfigs: {
+    configs: {
+        recommended: {
+            languageOptions: {
+                ecmaVersion: "latest";
+                parser: typeof parser;
+            };
+            plugins: {
+                "itcase-lint": {
+                    meta: {
+                        name: string;
+                        version: string;
+                    };
+                    processors: {};
+                    rules: {
+                        "react-data-test-id": TSESLint.RuleModule<"missingAttribute" | "missingAttributeValue", import("./interface").Options, unknown, TSESLint.RuleListener> & {
+                            name: string;
+                        };
+                        "storybook-meta-parameters-design": TSESLint.RuleModule<"missingOrEmptyUrl" | "typeMustBeFigma" | "urlMustContainFigma", [], unknown, TSESLint.RuleListener> & {
+                            name: string;
+                        };
+                    };
+                };
+            };
+            rules: {
+                "itcase-lint/react-data-test-id": "off";
+            };
+        };
+    };
+    meta: {
+        name: string;
+        version: string;
+    };
+    processors: {};
+    rules: {
+        "react-data-test-id": TSESLint.RuleModule<"missingAttribute" | "missingAttributeValue", import("./interface").Options, unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        "storybook-meta-parameters-design": TSESLint.RuleModule<"missingOrEmptyUrl" | "typeMustBeFigma" | "urlMustContainFigma", [], unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+    };
+};
+export default pluginWithConfigs;

package/dist/eslint/restrictWords/config.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Запрещённые сокращения и допустимые замены.
+ * Все проверяются на вхождение в идентификатор (camelCase): например "btn" ловит btn, primaryBtn, submitBtn, но не button.
+ * - forbidden: сокращение для сообщения об ошибке.
+ * - use: что писать вместо (строка или массив вариантов).
+ */
+export declare const RESTRICTED_WORDS: ReadonlyArray<{
+    forbidden: string;
+    use: string | readonly [string, ...string[]];
+}>;
+export type RestrictedWordEntry = (typeof RESTRICTED_WORDS)[number];

package/dist/eslint/restrictWords/index.d.ts

@@ -0,0 +1,6 @@
+type NoRestrictedSyntaxEntry = 'off' | ['error', ...Array<{
+    message: string;
+    selector: string;
+}>];
+export declare const noRestrictedSyntaxRestrictWords: NoRestrictedSyntaxEntry;
+export { RESTRICTED_WORDS } from './config';

package/dist/eslint/restrictWords.js

@@ -0,0 +1,79 @@
+/**
+ * Запрещённые сокращения и допустимые замены.
+ * Все проверяются на вхождение в идентификатор (camelCase): например "btn" ловит btn, primaryBtn, submitBtn, но не button.
+ * - forbidden: сокращение для сообщения об ошибке.
+ * - use: что писать вместо (строка или массив вариантов).
+ */
+const RESTRICTED_WORDS = [
+    { forbidden: 'btn', use: 'button' },
+    { forbidden: 'lbl', use: 'label' },
+    { forbidden: 'lnk', use: 'link' },
+    { forbidden: 'tbl', use: 'table' },
+    { forbidden: 'txt', use: ['text', 'input'] },
+    { forbidden: 'pw', use: 'password' },
+    { forbidden: 'pwd', use: 'password' },
+    { forbidden: 'usr', use: 'user' },
+    { forbidden: 'mod', use: ['modify', 'module'] },
+    { forbidden: 'tmp', use: 'temporary' },
+    { forbidden: 'dir', use: ['directory', 'direction'] },
+    { forbidden: 'pos', use: 'position' },
+    { forbidden: 'cnt', use: 'count' },
+    { forbidden: 'curr', use: 'current' },
+    { forbidden: 'def', use: 'default' },
+    { forbidden: 'doc', use: 'document' },
+    { forbidden: 'elem', use: 'element' },
+    { forbidden: 'fn', use: ['function', 'callback'] },
+    { forbidden: 'idx', use: 'index' },
+    { forbidden: 'len', use: 'length' },
+    { forbidden: 'msg', use: 'message' },
+    { forbidden: 'num', use: 'number' },
+    { forbidden: 'opt', use: 'option' },
+    { forbidden: 'qty', use: 'quantity' },
+    { forbidden: 'req', use: 'request' },
+    { forbidden: 'str', use: 'string' },
+    { forbidden: 'tst', use: 'test' },
+    { forbidden: 'val', use: 'value' },
+];
+
+/** Escape special regex characters in the forbidden word. */
+function escapeRegex(source) {
+    return source.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Regex to match abbreviation inside identifier (camelCase):
+ * - at start (^) or after lowercase ([a-z]);
+ * - then the abbreviation (first char may be upper in camelCase, e.g. Btn);
+ * - then end ($) or next uppercase ([A-Z]).
+ * Matches: "btn", "primaryBtn", "submitBtn". Does not match: "button".
+ */
+function abbreviationPattern(forbidden) {
+    if (forbidden.length === 0)
+        return '(?!.)';
+    const first = forbidden[0];
+    const restEscaped = escapeRegex(forbidden.slice(1));
+    const firstCharClass = first === first.toUpperCase()
+        ? escapeRegex(first)
+        : `[${first}${first.toUpperCase()}]`;
+    return `(^|[a-z])${firstCharClass}${restEscaped}([A-Z]|$)`;
+}
+function buildNoRestrictedSyntaxOptions() {
+    if (RESTRICTED_WORDS.length === 0) {
+        return 'off';
+    }
+    const selectors = RESTRICTED_WORDS.map(({ forbidden, use }) => {
+        const useList = Array.isArray(use) ? use : [use];
+        const useText = useList.length === 1
+            ? `Use "${useList[0]}" instead.`
+            : `Use "${useList.join('" or "')}" instead.`;
+        const pattern = abbreviationPattern(forbidden);
+        const patternEscaped = pattern.replace(/\//g, '\\/');
+        return {
+            message: `Using "${forbidden}" (or containing it) as an identifier is not allowed. ${useText}`,
+            selector: `Identifier[name=/${patternEscaped}/]`,
+        };
+    });
+    return ['error', ...selectors];
+}
+const noRestrictedSyntaxRestrictWords = buildNoRestrictedSyntaxOptions();
+
+export { RESTRICTED_WORDS, noRestrictedSyntaxRestrictWords };

package/dist/eslint/storybook/index.d.ts

@@ -1,7 +1,22 @@
 declare const _default: {
     files: string[];
     plugins: {
-        strorybook: {
+        "itcase-lint": {
+            meta: {
+                name: string;
+                version: string;
+            };
+            processors: {};
+            rules: {
+                "react-data-test-id": import("@typescript-eslint/utils/ts-eslint").RuleModule<"missingAttribute" | "missingAttributeValue", import("../react/dataTestIdPlugin/interface").Options, unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+                    name: string;
+                };
+                "storybook-meta-parameters-design": import("@typescript-eslint/utils/ts-eslint").RuleModule<"missingOrEmptyUrl" | "typeMustBeFigma" | "urlMustContainFigma", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+                    name: string;
+                };
+            };
+        };
+        storybook: {
             configs: {
                 csf: {
                     plugins: string[];
@@ -404,5 +419,8 @@ declare const _default: {
             };
         };
     };
+    rules: {
+        "itcase-lint/storybook-meta-parameters-design": string;
+    };
 }[];
 export default _default;

package/dist/eslint/storybook/metaParametersDesign/constants.d.ts

@@ -0,0 +1,12 @@
+declare const MESSAGE_IDS: {
+    readonly missingOrEmptyUrl: "missingOrEmptyUrl";
+    readonly typeMustBeFigma: "typeMustBeFigma";
+    readonly urlMustContainFigma: "urlMustContainFigma";
+};
+type MessageIds = keyof typeof MESSAGE_IDS;
+declare const MESSAGES: {
+    missingOrEmptyUrl: string;
+    typeMustBeFigma: string;
+    urlMustContainFigma: string;
+};
+export { MESSAGE_IDS, type MessageIds, MESSAGES };

package/dist/eslint/storybook/metaParametersDesign/extra.d.ts

@@ -0,0 +1,8 @@
+import type { Context, Options, RuleVisitorsType } from './interface';
+declare const createRule: <Options extends readonly unknown[], MessageIds extends string>({ meta, name, ...rule }: Readonly<import("@typescript-eslint/utils/eslint-utils").RuleWithMetaAndName<Options, MessageIds, unknown>>) => import("@typescript-eslint/utils/ts-eslint").RuleModule<MessageIds, Options, unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+    name: string;
+};
+declare const ruleName = "storybook-meta-parameters-design";
+declare const pluginName = "itcase-lint";
+declare const defaultOptions: Options;
+export { type Context, createRule, defaultOptions, type Options, pluginName, ruleName, type RuleVisitorsType as RuleVisitors, };

package/dist/eslint/storybook/metaParametersDesign/interface.d.ts

@@ -0,0 +1,6 @@
+import type { RuleContext, RuleVisitors } from '../../utils/types';
+import { type MessageIds } from './constants';
+type Options = [];
+type Context = RuleContext<MessageIds, Options>;
+type RuleVisitorsType = RuleVisitors<MessageIds, Options>;
+export type { Context, Options, RuleVisitorsType };

package/dist/eslint/storybook/metaParametersDesign/plugin.d.ts

@@ -0,0 +1,12 @@
+import { pluginName, ruleName } from './extra';
+declare const plugin: {
+    meta: {
+        name: string;
+        version: string;
+    };
+    processors: {};
+    rules: {
+        [ruleName]: import("@typescript-eslint/utils/ts-eslint").RuleModule<string, unknown[], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+    };
+};
+export { plugin, pluginName, ruleName };

package/dist/eslint/storybook/metaParametersDesign/rule.d.ts

@@ -0,0 +1,5 @@
+import { ESLintUtils } from '@typescript-eslint/utils';
+declare const rule: ESLintUtils.RuleModule<"missingOrEmptyUrl" | "typeMustBeFigma" | "urlMustContainFigma", [], unknown, ESLintUtils.RuleListener> & {
+    name: string;
+};
+export { rule };

package/dist/eslint/storybook/metaParametersDesign/ruleVisitors.d.ts

@@ -0,0 +1,3 @@
+import { type RuleVisitors } from './extra';
+declare const ruleVisitors: RuleVisitors;
+export { ruleVisitors };

package/dist/eslint/storybook/metaParametersDesign/utils.d.ts

@@ -0,0 +1,6 @@
+import { type TSESTree } from '@typescript-eslint/utils';
+declare function getPropertyName(key: TSESTree.Property['key']): string | undefined;
+declare function findProperty(node: TSESTree.ObjectExpression, name: string): TSESTree.Property | undefined;
+declare function getStringLiteralValue(node: TSESTree.Node): string | undefined;
+declare function resolveMetaObject(declaration: TSESTree.ExportDefaultDeclaration['declaration'], sourceCode: Readonly<TSESTree.Program>): TSESTree.ObjectExpression | null;
+export { findProperty, getPropertyName, getStringLiteralValue, resolveMetaObject, };

package/dist/eslint/storybook.js

@@ -1,10 +1,3 @@
-import eslintStorybook from 'eslint-plugin-storybook';
-
-var index = [
-    {
-        files: ['**/*.stories.@(ts|tsx|js|jsx|mjs|cjs)'],
-        plugins: { strorybook: eslintStorybook },
-    },
-];
-
-export { index as default };
+import 'eslint-plugin-storybook';
+export { s as default } from '../index_CChA61aj.js';
+import '@typescript-eslint/utils';

package/dist/eslint/utils/createPlugin.d.ts

@@ -0,0 +1,14 @@
+import type { TSESLint } from '@typescript-eslint/utils';
+declare function createPlugin(pluginName: string, ruleName: string, rule: TSESLint.RuleModule<string, unknown[]>, options?: {
+    version?: string;
+}): {
+    meta: {
+        name: string;
+        version: string;
+    };
+    processors: {};
+    rules: {
+        [ruleName]: TSESLint.RuleModule<string, unknown[], unknown, TSESLint.RuleListener>;
+    };
+};
+export { createPlugin };

package/dist/eslint/utils/createRuleCreator.d.ts

@@ -0,0 +1,5 @@
+import { ESLintUtils } from '@typescript-eslint/utils';
+declare function createRuleCreator(pluginPath: string): <Options extends readonly unknown[], MessageIds extends string>({ meta, name, ...rule }: Readonly<ESLintUtils.RuleWithMetaAndName<Options, MessageIds, unknown>>) => ESLintUtils.RuleModule<MessageIds, Options, unknown, ESLintUtils.RuleListener> & {
+    name: string;
+};
+export { createRuleCreator };

package/dist/eslint/utils/types.d.ts

@@ -0,0 +1,4 @@
+import type { TSESLint } from '@typescript-eslint/utils';
+type RuleContext<MessageIds extends string, Options extends readonly unknown[]> = Readonly<TSESLint.RuleContext<MessageIds, Options>>;
+type RuleVisitors<MessageIds extends string, Options extends readonly unknown[]> = (context: RuleContext<MessageIds, Options>, optionsWithDefault: Readonly<Options>) => TSESLint.RuleListener;
+export type { RuleContext, RuleVisitors };