@mednet/lint-config 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ФГБУ «ЦНИИОИЗ» Минздрава России
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,69 @@
-# Temporary Holding Version
+# @mednet/lint-config
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+ESLint и stylelint для проектов ЦНИИОИЗ: не пускают в проект чужие UI-библиотеки, примитивы мимо `@mednet/ui`, иконки не из `lucide-react` и цвета вне токенов бренда. Только встроенные правила — без своих плагинов.
+
+## ESLint (Next 16)
+
+```bash
+npm i -D eslint@^9 eslint-config-next @mednet/lint-config
+```
+
+`eslint.config.mjs` — после конфигов Next:
+
+```js
+import { defineConfig, globalIgnores } from 'eslint/config';
+import nextVitals from 'eslint-config-next/core-web-vitals';
+import nextTs from 'eslint-config-next/typescript';
+import mednet from '@mednet/lint-config/eslint';
+
+export default defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  ...mednet,
+  globalIgnores(['.next/**', 'out/**', 'build/**', 'next-env.d.ts']),
+]);
+```
+
+Свои запреты **дополняйте**, а не объявляйте заново — правило с тем же именем заменяет наше целиком:
+
+```js
+import mednet, { restrictedImports } from '@mednet/lint-config/eslint';
+
+// …после ...mednet:
+{
+  rules: {
+    'no-restricted-imports': [
+      'error',
+      { ...restrictedImports, paths: [...restrictedImports.paths, { name: 'lodash', message: 'Берите lodash-es' }] },
+    ],
+  },
+},
+```
+
+## stylelint
+
+```bash
+npm i -D stylelint @mednet/lint-config
+```
+
+`stylelint.config.mjs`:
+
+```js
+/** @type {import('stylelint').Config} */
+const config = {
+  extends: ['@mednet/lint-config/stylelint'],
+  ignoreFiles: ['.next/**', 'out/**', 'build/**'],
+};
+
+export default config;
+```
+
+`package.json`: `"lint:css": "stylelint \"**/*.css\" --allow-empty-input"`. Не подключайте `stylelint-config-standard`: на Tailwind v4 он даёт ложные ошибки.
+
+## Что не ловится
+
+Цвет через переменную (`const c = '#fff'; style={{ color: c }}`), именованные цвета в `style`, `@apply bg-[#fff]` в CSS, динамический `import('antd')`. Это ловит ревью.
+
+## Лицензия
+
+MIT, © 2026 ФГБУ «ЦНИИОИЗ» Минздрава России.

package/eslint.d.ts

@@ -0,0 +1,10 @@
+import type { Linter } from 'eslint';
+
+export declare const restrictedImports: {
+  paths: { name: string; message: string }[];
+  patterns: { group: string[]; message: string }[];
+};
+export declare const restrictedSyntax: { selector: string; message: string }[];
+
+declare const config: Linter.Config[];
+export default config;

package/eslint.js

@@ -0,0 +1,92 @@
+// @mednet/lint-config/eslint — flat config: только правила ядра ESLint, без парсера и плагинов.
+// Парсер (typescript-eslint для .ts/.tsx) приходит из eslint-config-next; ставьте этот массив после него.
+// Правила проекта с теми же именами ЗАМЕНЯЮТ наши (ESLint не сливает опции) — расширяйте
+// через экспортируемые restrictedImports / restrictedSyntax.
+
+// ---------- Импорты ----------
+
+const UI_KIT =
+  'Сторонние UI-библиотеки в проектах ЦНИИОИЗ не используются: компоненты берите из @mednet/ui (список — node_modules/@mednet/ui/llms.md).';
+const PRIMITIVES =
+  'Примитивы напрямую не импортируйте — только через @mednet/ui (например, @mednet/ui/dialog). Композиция — через проп render, не asChild.';
+const ICONS = 'Иконки — только lucide-react.';
+
+/** Опции правила no-restricted-imports; экспортируются, чтобы проект мог дополнить список. */
+export const restrictedImports = {
+  paths: [
+    { name: 'antd', message: UI_KIT },
+    { name: 'bootstrap', message: UI_KIT },
+    { name: 'react-bootstrap', message: UI_KIT },
+    { name: 'radix-ui', message: PRIMITIVES },
+    // @base-ui/react не дублируем в paths: его ловит паттерн '@base-ui/*' (иначе два сообщения на строку)
+    { name: 'react-icons', message: ICONS },
+    { name: '@tabler/icons-react', message: ICONS },
+  ],
+  patterns: [
+    {
+      group: ['antd/*', 'bootstrap/*', 'react-bootstrap/*', '@mui/*', '@mantine/*', '@chakra-ui/*'],
+      message: UI_KIT,
+    },
+    {
+      group: ['radix-ui/*', '@radix-ui/*', '@base-ui/*', '@base-ui-components/*'],
+      message: PRIMITIVES,
+    },
+    {
+      group: [
+        'react-icons/*',
+        '@tabler/icons-react/*',
+        '@heroicons/*',
+        '@fortawesome/*',
+        '@phosphor-icons/*',
+        '@hugeicons/*',
+      ],
+      message: ICONS,
+    },
+  ],
+};
+
+// ---------- Литеральные цвета ----------
+// Регулярки вставляются в селекторы esquery как /…/i. В них нельзя использовать «/»
+// (esquery заканчивает регулярку на первом «/»), флаги — только i m s u.
+// Hex: после него не буква/цифра/дефис, но «_» можно — Tailwind пишет пробелы как «_» (#fff_0%).
+// Функции: буква, цифра или дефис перед именем — часть более длинного имени (color-mix(, --x-rgb),
+// такое не ловим; «_» и пробел — разделители (shadow-[0_1px_2px_rgb(0_0_0/0.05)]), там ловим.
+
+const HEX = String.raw`#(?:[\da-f]{8}|[\da-f]{6}|[\da-f]{3,4})(?![\da-z-])`;
+const FN = String.raw`(?<![\da-z-])(?:rgba?|hsla?|hwb|lab|lch|oklab|oklch|color)\(`;
+const COLOR = `${HEX}|${FN}`;
+
+/** Строка или кусок шаблонной строки с литеральным цветом. */
+const COLOR_STRING = `:matches(Literal[value=/${COLOR}/i], TemplateElement[value.raw=/${COLOR}/i])`;
+
+const CLASS_ATTR = String.raw`JSXAttribute[name.name=/^(?:className|classNames)$|ClassName$/]`;
+const CLASS_CALL = String.raw`CallExpression[callee.name=/^(?:cn|cva|clsx|cx|tv|twMerge|twJoin)$/]`;
+const STYLE_ATTR = String.raw`JSXAttribute[name.name=/^style$|Style$/]`;
+
+/** Записи правила no-restricted-syntax; экспортируются, чтобы проект мог дополнить список. */
+export const restrictedSyntax = [
+  {
+    // Один селектор на оба контекста: className={cn('bg-[#fff]')} — одно сообщение, а не два.
+    selector: `:matches(${CLASS_ATTR}, ${CLASS_CALL}) ${COLOR_STRING}`,
+    message:
+      'Цвет литералом в классах (#fff, rgb(…), oklch(…), bg-[#…], text-[rgb(…)]) запрещён: берите семантический класс — bg-primary, text-muted-foreground, border-border, bg-destructive, bg-field — или шкалу бренда (bg-red-500).',
+  },
+  {
+    selector: `${STYLE_ATTR} ${COLOR_STRING}`,
+    message:
+      'Цвет литералом в style запрещён: используйте класс (bg-primary, text-muted-foreground, border-border) или переменную токена — var(--primary), var(--muted-foreground), var(--border).',
+  },
+];
+
+/** @type {import('eslint').Linter.Config[]} */
+const config = [
+  {
+    name: '@mednet/lint-config/eslint',
+    rules: {
+      'no-restricted-imports': ['error', restrictedImports],
+      'no-restricted-syntax': ['error', ...restrictedSyntax],
+    },
+  },
+];
+
+export default config;

package/package.json

@@ -1,6 +1,61 @@
 {
   "name": "@mednet/lint-config",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.0",
+  "description": "ESLint и stylelint для проектов ЦНИИОИЗ: защита бренда",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hpnssflw/mednet-kit.git",
+    "directory": "packages/lint-config"
+  },
+  "files": [
+    "eslint.js",
+    "eslint.d.ts",
+    "stylelint.js",
+    "stylelint.d.ts",
+    "README.md"
+  ],
+  "exports": {
+    "./eslint": {
+      "types": "./eslint.d.ts",
+      "default": "./eslint.js"
+    },
+    "./stylelint": {
+      "types": "./stylelint.d.ts",
+      "default": "./stylelint.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "eslint": "^9.0.0 || ^10.0.0",
+    "stylelint": "^17.0.0"
+  },
+  "peerDependenciesMeta": {
+    "eslint": {
+      "optional": true
+    },
+    "stylelint": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^24",
+    "eslint": "^9.39.5",
+    "eslint-config-next": "16.4.0",
+    "next": "^16.4.0",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
+    "stylelint": "^17.16.0",
+    "typescript": "~6.0.3",
+    "typescript-eslint": "^8.71.2",
+    "vitest": "^5.0.4"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json"
+  }
 }

package/stylelint.d.ts

@@ -0,0 +1,6 @@
+import type { Config } from 'stylelint';
+
+export declare const colorFunctions: string[];
+
+declare const config: Config;
+export default config;

package/stylelint.js

@@ -0,0 +1,43 @@
+// @mednet/lint-config/stylelint — только встроенные правила stylelint.
+// Не подключайте вместе с ним stylelint-config-standard: на Tailwind v4 он даёт ложные ошибки
+// (@apply, --spacing(), блочный @custom-variant) и отвергает currentColor.
+
+/** Литеральные цветовые функции. color-mix() не входит: color-mix(in oklab, var(--a) 30%, transparent) разрешён. */
+export const colorFunctions = [
+  'rgb',
+  'rgba',
+  'hsl',
+  'hsla',
+  'hwb',
+  'lab',
+  'lch',
+  'oklab',
+  'oklch',
+  'color',
+];
+
+const HINT =
+  'берите токен — var(--primary), var(--muted-foreground), var(--border) — или @apply с семантическим классом (bg-primary, text-muted-foreground, border-border); полупрозрачность — color-mix(in oklab, var(--primary) 30%, transparent)';
+
+/** @type {import('stylelint').Config} */
+const config = {
+  rules: {
+    'color-no-hex': [
+      true,
+      { message: (/** @type {string} */ hex) => `Цвет литералом (${hex}) запрещён: ${HINT}.` },
+    ],
+    'color-named': [
+      'never',
+      { message: (/** @type {string} */ name) => `Именованный цвет (${name}) запрещён: ${HINT}.` },
+    ],
+    'function-disallowed-list': [
+      colorFunctions,
+      {
+        message: (/** @type {string} */ fn) =>
+          `Цветовая функция ${fn}() с литералом запрещена: ${HINT}.`,
+      },
+    ],
+  },
+};
+
+export default config;