@application-kit/lint-config 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# @application-kit/lint-config
+
+## 0.1.0
+
+### Minor Changes
+
+- fc09818: Первый выпуск: `defineApplicationEslintConfig({ shellModule, roleDictionary })` — flat-config ESLint приложения на базе
+  `@libs-for-dev/eslint-rules` с общестековыми настройками, allow-list подпутей пакетов `@application-kit`, запретами
+  UI-вендора и границами слоёв по раскладке приложения (`defineRestrictedImportBlocks` — те же границы отдельно). Пакет
+  только ESM.
+
+### Patch Changes
+
+- Updated dependencies [d048984]
+  - @application-kit/ui@0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 application-kit
+
+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,61 @@
-# Temporary Holding Version
+# @application-kit/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 приложения на пакетах `@application-kit`: flat-config — база `@libs-for-dev/eslint-rules`, общестековые
+настройки, разрешённые подпути пакетов, запреты UI-вендора и границы слоёв по раскладке приложения. Списков и путей
+продукта в пакете нет: модуль-оболочку и путь словаря ролей приложение передаёт параметрами, игноры своих каталогов и
+свои правила дописывает после пресета.
+
+## Установка
+
+```sh
+yarn add --dev @application-kit/lint-config
+```
+
+Peer-зависимости: `eslint`, `@libs-for-dev/eslint-rules`. Пакет только ESM: его грузит ESM-конфиг `eslint.config.ts`.
+
+## Входы
+
+| Вход | Для чего | Тянет |
+|------|----------|-------|
+| `@application-kit/lint-config` | `defineApplicationEslintConfig`, `defineRestrictedImportBlocks`, `ApplicationEslintConfigOptionsInterface` | `@libs-for-dev/eslint-rules`, `@application-kit/ui/lint` |
+
+## ESLint
+
+```ts
+import { defineApplicationEslintConfig } from '@application-kit/lint-config'
+
+export default [
+  ...defineApplicationEslintConfig({ roleDictionary: '@/libs/shared/role', shellModule: 'client' }),
+  { ignores: ['docs/', 'ops/static/'] },
+]
+```
+
+Порядок блоков: база `configs.*` → общестековые настройки (`complexity` 7, allow-list `import-x/no-internal-modules`,
+`.vue`, миграции, `shared/`, спеки, мапперы и DTO, ключи `tsconfig.json`) → границы слоёв → порядок `mutate` в
+`stryker.conf.json`. Блоки продукта идут после пресета. Плоский конфиг заменяет правило целиком: правило, которое пресет
+уже задаёт тем же файлам, приложение переопределяет полным набором опций.
+
+Границы слоёв (`defineRestrictedImportBlocks`) — набор запретов на область; следующий блок заменяет набор предыдущего
+для своих файлов, поэтому порядок блоков — часть правила:
+
+| Область | Запреты `no-restricted-imports` |
+|---------|---------------------------------|
+| `src/modules/*/**` кроме оболочки | внутренности оболочки, второй путь словаря ролей, вендор, внутренности субмодулей |
+| `src/modules/*/modules/**` | то же без внутренностей субмодулей: изнутри субмодуля можно |
+| `src/libs/**` | импорт модулей, вендор |
+| `src/modules/<оболочка>/**` | второй путь словаря ролей, вендор |
+| `src/**/*.vue` | классы вендора — правилом `vue/no-restricted-class` |
+| `src/modules/**/user-interface/client/**` | набор корня модуля и серверный GraphQL-класс |
+| `src/modules/<оболочка>/user-interface/**` | набор оболочки, внутренности субмодулей и серверный GraphQL-класс |
+
+Каждый запрет держит два якоря — алиас `@/…` и относительную форму того же пути. `shellModule` — имя папки в
+kebab-case, `roleDictionary` — путь вида `@/<полка>/<путь>` из таких имён; иное значение роняет сборку конфига.
+
+Allow-list подпутей `@application-kit/*` спека пакета сверяет с `exports` пакетов монорепы в обе стороны: новый вход
+пакета без записи и запись без входа краснеют в CI монорепы.
+
+## Вендор
+
+Шаблоны вендора — строка импорта, CSS-класс, разрешённые подпути — и имена обёрток полей для
+`vuejs-accessibility/label-has-for` пресет берёт из `@application-kit/ui/lint`. Смена вендора — релиз `ui`: конфиг
+приложения не меняется.

package/dist/application-eslint-config-options.interface.d.ts

@@ -0,0 +1,4 @@
+export interface ApplicationEslintConfigOptionsInterface {
+    roleDictionary: string;
+    shellModule: string;
+}

package/dist/application-eslint-config-options.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/define-application-eslint-config.d.ts

@@ -0,0 +1,3 @@
+import type { Linter } from 'eslint';
+import type { ApplicationEslintConfigOptionsInterface } from './application-eslint-config-options.interface.js';
+export declare const defineApplicationEslintConfig: (options: ApplicationEslintConfigOptionsInterface) => Linter.Config[];

package/dist/define-application-eslint-config.js

@@ -0,0 +1,111 @@
+import { UI_FORM_CONTROL_COMPONENTS, UI_VENDOR_INTERNAL_MODULES } from '@application-kit/ui/lint';
+import { configs } from '@libs-for-dev/eslint-rules';
+import { defineRestrictedImportBlocks } from './restricted-import-blocks.js';
+const APPLICATION_KIT_ENTRIES = [
+    '@application-kit/*/nest',
+    '@application-kit/*/testing',
+    '@application-kit/*/vite-plugin',
+    '@application-kit/bootstrap/*',
+    '@application-kit/feature-flags/vue',
+    '@application-kit/graphql/client',
+    '@application-kit/i18n/server',
+    '@application-kit/i18n/vue',
+    '@application-kit/kafka/event-contract',
+    '@application-kit/observability/*',
+    '@application-kit/observability/health/*',
+    '@application-kit/testing/vitest',
+    '@application-kit/typeorm/*',
+    '@application-kit/ui/lint',
+    '@application-kit/ui/style.css',
+    '@application-kit/ui/styles/*',
+    '@application-kit/vue-ssr/server',
+];
+const isRecord = (value) => typeof value === 'object' && value !== null;
+const optionsOf = (entry) => Array.isArray(entry) && entry[1];
+const BASE_KEY_NAME_CASING = optionsOf(configs.json.rules?.['jsonc/key-name-casing']);
+const STACK_CONFIG = [
+    configs.json,
+    configs.ignores,
+    configs.markdown,
+    configs.packageJson,
+    configs.typescript,
+    configs.vitest,
+    configs.vue,
+    { linterOptions: { reportUnusedDisableDirectives: 'error' } },
+    {
+        plugins: { ...configs.packageJson.plugins },
+        rules: {
+            'package-json/require-funding': 'off',
+            'package-json/require-main': 'off',
+        },
+    },
+    { rules: { '@typescript-eslint/consistent-type-definitions': 'off' } },
+    {
+        files: ['**/*.cjs', '**/*.cts', '**/*.js', '**/*.mjs', '**/*.mts', '**/*.ts', '**/*.vue'],
+        rules: { 'unicorn/comment-content': ['error', { replacements: { '\\burl\\b': false } }] },
+    },
+    {
+        plugins: { ...configs.javascript.plugins },
+        rules: {
+            complexity: ['error', { max: 7 }],
+            'import-x/no-cycle': 'off',
+            'import-x/no-internal-modules': [
+                'error',
+                { allow: ['@apollo/**/*', ...APPLICATION_KIT_ENTRIES, ...UI_VENDOR_INTERNAL_MODULES, 'vitest/*', 'vue/*'] },
+            ],
+        },
+    },
+    {
+        files: ['src/**/*.vue'],
+        rules: {
+            'vue/require-default-prop': 'off',
+            'vuejs-accessibility/label-has-for': ['error', { controlComponents: [...UI_FORM_CONTROL_COMPONENTS] }],
+        },
+    },
+    {
+        files: ['src/**/typeorm/migrations/*.ts'],
+        rules: { 'check-file/filename-naming-convention': 'off' },
+    },
+    {
+        files: ['src/**/shared/**', 'src/**/domain/value-objects/**'],
+        rules: { 'unicorn/no-barrel-files': 'off' },
+    },
+    {
+        files: ['src/**/*.spec.ts'],
+        rules: {
+            '@typescript-eslint/no-magic-numbers': 'off',
+            'max-lines-per-function': 'off',
+            'max-statements': 'off',
+            'unicorn/no-unreadable-new-expression': 'off',
+        },
+    },
+    {
+        files: ['src/**/*.mapper.ts', 'src/**/*.dto.ts'],
+        rules: { 'max-statements': 'off' },
+    },
+    {
+        files: ['tsconfig.json'],
+        rules: {
+            'jsonc/key-name-casing': [
+                'error',
+                { ...isRecord(BASE_KEY_NAME_CASING) && BASE_KEY_NAME_CASING, ignores: ['@/*', 'ts-node'] },
+            ],
+        },
+    },
+    {
+        files: ['src/modules/**/client/**/*.vue'],
+        rules: {
+            'import-x/no-internal-modules': 'off',
+            'import-x/no-relative-parent-imports': 'off',
+        },
+    },
+];
+const STRYKER_CONFIG = {
+    files: ['stryker.conf.json'],
+    rules: { 'jsonc/sort-array-values': ['error', { order: { type: 'asc' }, pathPattern: String.raw `^(?!mutate$).*` }] },
+};
+export const defineApplicationEslintConfig = (options) => [
+    ...STACK_CONFIG,
+    ...defineRestrictedImportBlocks(options),
+    STRYKER_CONFIG,
+];

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './application-eslint-config-options.interface.js';
+export * from './define-application-eslint-config.js';
+export * from './restricted-import-blocks.js';

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './application-eslint-config-options.interface.js';
+export * from './define-application-eslint-config.js';
+export * from './restricted-import-blocks.js';

package/dist/restricted-import-blocks.d.ts

@@ -0,0 +1,3 @@
+import type { Linter } from 'eslint';
+import type { ApplicationEslintConfigOptionsInterface } from './application-eslint-config-options.interface.js';
+export declare const defineRestrictedImportBlocks: (options: ApplicationEslintConfigOptionsInterface) => Linter.Config[];

package/dist/restricted-import-blocks.js

@@ -0,0 +1,76 @@
+import { UI_VENDOR_CLASS_PATTERN, UI_VENDOR_IMPORT_PATTERN } from '@application-kit/ui/lint';
+const RELATIVE_UP = String.raw `(?:\.\./)+`;
+const RELATIVE_ANY = String.raw `(?:\.\.?/)+`;
+const RELATIVE_SEGMENTS = String.raw `(?:[^/.][^/]*/)*`;
+const ALIAS = '@/';
+const PATH_SEGMENT = /^[0-9a-z]+(?:-[0-9a-z]+)*$/u;
+const UI_VENDOR_IMPORT = {
+    message: 'UI-вендор импортируется только пакетом @application-kit/ui: в приложении — его обёртки.',
+    regex: UI_VENDOR_IMPORT_PATTERN,
+};
+const SERVER_GRAPHQL_CLASS_IMPORT = {
+    message: 'Клиент не типизируется серверным GraphQL-классом: '
+        + 'общая часть — wire-контракт в @/modules/<module>/shared/*.wire.',
+    regex: String.raw `^(?:@/modules/.*user-interface/|${RELATIVE_UP}${RELATIVE_SEGMENTS})controllers/`,
+};
+const LIBS_TO_MODULES_IMPORT = {
+    message: 'Из src/libs модули не импортируются: общий код объявляется общим переездом в src/libs.',
+    regex: String.raw `^(?:@/|${RELATIVE_UP})modules/`,
+};
+const SUBMODULE_INTERNALS_IMPORT = {
+    message: 'Внутренности субмодуля наружу не видны: наружу смотрят только application/ports и libs.',
+    regex: String.raw `^(?:@/modules/[^/]+/|${RELATIVE_ANY}${RELATIVE_SEGMENTS})`
+        + String.raw `modules/[^/]+/(?:domain|infrastructure|user-interface)/`,
+};
+const isPathSegment = (value) => PATH_SEGMENT.test(value);
+const isAliasPath = ([alias, ...segments]) => alias === '@'
+    && segments.length > 1
+    && segments.every((segment) => isPathSegment(segment));
+const assertLayout = ({ roleDictionary, shellModule }) => {
+    if (!isPathSegment(shellModule)) {
+        throw new Error(`shellModule — папка модуля в src/modules в kebab-case, получено «${shellModule}»`);
+    }
+    if (!isAliasPath(roleDictionary.split('/'))) {
+        throw new Error(`roleDictionary — путь от алиаса вида @/<полка>/<путь> в kebab-case, получено «${roleDictionary}»`);
+    }
+};
+const shellInternalsImport = (shellModule) => ({
+    message: `Внутренности модуля ${shellModule} не импортируются извне: общий код — в src/libs.`,
+    regex: String.raw `^(?:@/modules/|${RELATIVE_UP}(?:modules/)?)${shellModule}/`,
+});
+const roleDictionaryImport = (roleDictionary) => {
+    const aliasPath = roleDictionary.slice(ALIAS.length);
+    const shelf = aliasPath.slice(0, aliasPath.indexOf('/'));
+    const dictionary = aliasPath.slice(shelf.length + 1);
+    return {
+        message: `Словарь ролей импортируется только из ${roleDictionary}.`,
+        regex: String.raw `^(?:@/modules/.*|${RELATIVE_ANY}(?!${shelf}/)${RELATIVE_SEGMENTS})${dictionary}$`,
+    };
+};
+const restrictedImports = (patterns) => ({
+    'no-restricted-imports': ['error', { patterns }],
+});
+export const defineRestrictedImportBlocks = (options) => {
+    assertLayout(options);
+    const { roleDictionary, shellModule } = options;
+    const shellInternals = shellInternalsImport(shellModule);
+    const roleDictionaryPath = roleDictionaryImport(roleDictionary);
+    const modules = [shellInternals, roleDictionaryPath, UI_VENDOR_IMPORT];
+    const shell = [roleDictionaryPath, UI_VENDOR_IMPORT];
+    const moduleRoot = [...modules, SUBMODULE_INTERNALS_IMPORT];
+    return [
+        { files: ['src/modules/*/**'], ignores: [`src/modules/${shellModule}/**`], rules: restrictedImports(moduleRoot) },
+        { files: ['src/modules/*/modules/**'], rules: restrictedImports(modules) },
+        { files: ['src/libs/**'], rules: restrictedImports([LIBS_TO_MODULES_IMPORT, UI_VENDOR_IMPORT]) },
+        { files: [`src/modules/${shellModule}/**`], rules: restrictedImports(shell) },
+        { files: ['src/**/*.vue'], rules: { 'vue/no-restricted-class': ['error', UI_VENDOR_CLASS_PATTERN] } },
+        {
+            files: ['src/modules/**/user-interface/client/**'],
+            rules: restrictedImports([...moduleRoot, SERVER_GRAPHQL_CLASS_IMPORT]),
+        },
+        {
+            files: [`src/modules/${shellModule}/user-interface/**`],
+            rules: restrictedImports([...shell, SUBMODULE_INTERNALS_IMPORT, SERVER_GRAPHQL_CLASS_IMPORT]),
+        },
+    ];
+};

package/package.json

@@ -1,6 +1,67 @@
 {
   "name": "@application-kit/lint-config",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Пресет ESLint приложения на пакетах @application-kit: flat-config с границами слоёв, разрешёнными подпутями пакетов и запретами UI-вендора",
+  "keywords": [
+    "eslint-config",
+    "flat-config",
+    "lint"
+  ],
+  "homepage": "https://gitlab.com/application-kit/application-kit/-/tree/main/packages/lint-config",
+  "bugs": "https://gitlab.com/application-kit/application-kit/-/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/application-kit/application-kit.git",
+    "directory": "packages/lint-config"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "application-kit"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rm -rf ./dist && node ../../scripts/barrels.mjs create ./src && tsc --project tsconfig.build.json && node ../../scripts/barrels.mjs clean ./src",
+    "lint:tsc": "tsc --noEmit --pretty --project .",
+    "test:mutation": "stryker run",
+    "test:unit": "vitest run"
+  },
+  "dependencies": {
+    "@application-kit/ui": "^0.3.0"
+  },
+  "devDependencies": {
+    "@libs-for-dev/eslint-rules": "3.4.0",
+    "@stryker-mutator/core": "^10.0.0",
+    "@stryker-mutator/vitest-runner": "^10.0.0",
+    "@types/node": "^26.2.0",
+    "eslint": "^10.8.1",
+    "minimatch": "^10.2.5",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.11"
+  },
+  "peerDependencies": {
+    "@libs-for-dev/eslint-rules": "^3.3.0",
+    "eslint": "^10.0.0"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
 }