eslint-plugin-weld 0.0.1-test

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Arswarog
+
+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

@@ -0,0 +1,70 @@
+# WELD — Well-Encapsulated Layered Design
+
+Подход к организации кода во frontend-приложениях и инструменты для его соблюдения.
+
+## Что это
+
+WELD описывает, как разложить frontend-приложение по слоям и как провести границы между модулями
+так, чтобы эти границы держались со временем. Ключевая идея — строгая инкапсуляция: модуль публикует
+наружу узкий, осознанно спроектированный интерфейс, а всё остальное остаётся его внутренним делом.
+Слои задают направление зависимостей, инкапсуляция не даёт им расползтись.
+
+Правила такого рода почти невозможно удержать одними договорённостями в команде — поэтому
+репозиторий содержит не только документацию подхода, но и ESLint-плагин, который проверяет
+соблюдение правил автоматически.
+
+## Статус
+
+Ранняя стадия. Документация пишется; ESLint-плагин опубликован как основа — пакет собирается,
+подключается и проходит CI, но правил в нём пока нет. Правила и их именование могут меняться без
+обратной совместимости.
+
+## ESLint-плагин
+
+Пакет: [`eslint-plugin-weld`](https://www.npmjs.com/package/eslint-plugin-weld). Требует ESLint 9
+или новее и flat config (`eslint.config.js`); поддерживается только ESM-подключение.
+
+```sh
+yarn add -D eslint-plugin-weld
+```
+
+```js
+// eslint.config.js
+import weld from 'eslint-plugin-weld';
+
+export default [weld.configs.recommended];
+```
+
+Можно подключить и сам плагин, включая правила поштучно:
+
+```js
+import weld from 'eslint-plugin-weld';
+
+export default [
+    {
+        plugins: { weld },
+        rules: {
+            // правила появятся здесь по мере реализации
+        },
+    },
+];
+```
+
+## Разработка
+
+Нужен Node 20.19+ и Yarn 4 (через corepack: `corepack enable`).
+
+```sh
+yarn install          # установка зависимостей
+yarn verify           # линт, форматирование, типы, тесты, сборка
+yarn test:watch       # тесты в watch-режиме
+yarn build            # сборка в dist/
+yarn smoke [9|10]     # сборка тарбола и проверка подключения в чистом проекте
+```
+
+`yarn smoke` собирает пакет ровно так, как это сделает `npm publish`, ставит его во временный проект
+и запускает там ESLint — это защита от «локально работает, из npm не подключается».
+
+## Лицензия
+
+[MIT](LICENSE)

package/dist/index.d.ts

@@ -0,0 +1,61 @@
+import { Linter } from 'eslint';
+
+/**
+ * @fileoverview Shared types for ESLint Core.
+ */
+
+/**
+ * The human readable severity level used in a configuration.
+ */
+type SeverityName = "off" | "warn" | "error";
+/**
+ * The numeric severity level for a rule.
+ *
+ * - `0` means off.
+ * - `1` means warn.
+ * - `2` means error.
+ */
+type SeverityLevel = 0 | 1 | 2;
+/**
+ * The severity of a rule in a configuration.
+ */
+type Severity = SeverityName | SeverityLevel;
+/**
+ * The configuration for a rule.
+ */
+type RuleConfig<RuleOptions extends unknown[] = unknown[]> = Severity | [Severity, ...Partial<RuleOptions>];
+/**
+ * A collection of rules and their configurations.
+ */
+interface RulesConfig {
+    [key: string]: RuleConfig;
+}
+
+/**
+ * Реестр правил плагина.
+ *
+ * Пока пуст: плагин опубликован как основа, правила проверки импортов
+ * добавляются следующими релизами. Каждое новое правило регистрируется здесь
+ * и должно иметь парный раздел в документации подхода.
+ */
+declare const rules: {};
+
+declare const meta: {
+    name: string;
+    version: string;
+};
+/**
+ * Плагин WELD. Правил пока нет — это основа, на которую они будут добавляться.
+ */
+declare const plugin: {
+    meta: {
+        name: string;
+        version: string;
+    };
+    rules: {};
+    configs: Record<string, Linter.Config>;
+};
+
+declare const configs: Record<string, Linter.Config<RulesConfig>>;
+
+export { configs, plugin as default, meta, rules };

package/dist/index.js

@@ -0,0 +1,28 @@
+// src/rules/index.ts
+var rules = {};
+
+// src/version.ts
+var version = "0.0.1-test" ;
+
+// src/index.ts
+var meta = {
+  name: "eslint-plugin-weld",
+  version
+};
+var plugin = {
+  meta,
+  rules,
+  configs: {}
+};
+var recommended = {
+  name: "weld/recommended",
+  plugins: { weld: plugin },
+  rules: {}
+};
+plugin.configs.recommended = recommended;
+var configs = plugin.configs;
+var index_default = plugin;
+
+export { configs, index_default as default, meta, rules };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/rules/index.ts","../src/version.ts","../src/index.ts"],"names":[],"mappings":";AASO,IAAM,QAAQ;;;ACLd,IAAM,OAAA,GACgC,YAAA,CAAqB;;;ACAlE,IAAM,IAAA,GAAO;AAAA,EACT,IAAA,EAAM,oBAAA;AAAA,EACN;AACJ;AAKA,IAAM,MAAA,GAAS;AAAA,EACX,IAAA;AAAA,EACA,KAAA;AAAA,EACA,SAAS;AACb,CAAA;AAaA,IAAM,WAAA,GAA6B;AAAA,EAC/B,IAAA,EAAM,kBAAA;AAAA,EACN,OAAA,EAAS,EAAE,IAAA,EAAM,MAAA,EAAwB;AAAA,EACzC,OAAO;AACX,CAAA;AAEA,MAAA,CAAO,QAAQ,WAAA,GAAc,WAAA;AAGtB,IAAM,UAAU,MAAA,CAAO;AAE9B,IAAO,aAAA,GAAQ","file":"index.js","sourcesContent":["import type { Rule } from 'eslint';\n\n/**\n * Реестр правил плагина.\n *\n * Пока пуст: плагин опубликован как основа, правила проверки импортов\n * добавляются следующими релизами. Каждое новое правило регистрируется здесь\n * и должно иметь парный раздел в документации подхода.\n */\nexport const rules = {} satisfies Record<string, Rule.RuleModule>;\n\nexport type RuleName = keyof typeof rules;\n","// Значение подставляется на сборке (см. tsup.config.ts). При запуске исходников\n// напрямую (тесты, ts-node) подмены не происходит — тогда используем заглушку.\ndeclare const __PLUGIN_VERSION__: string;\n\nexport const version: string =\n    typeof __PLUGIN_VERSION__ === 'string' ? __PLUGIN_VERSION__ : '0.0.0-dev';\n","import type { ESLint, Linter } from 'eslint';\n\nimport { rules } from './rules/index.js';\nimport { version } from './version.js';\n\nconst meta = {\n    name: 'eslint-plugin-weld',\n    version,\n} satisfies ESLint.Plugin['meta'];\n\n/**\n * Плагин WELD. Правил пока нет — это основа, на которую они будут добавляться.\n */\nconst plugin = {\n    meta,\n    rules,\n    configs: {} as Record<string, Linter.Config>,\n} satisfies ESLint.Plugin;\n\n/**\n * Рекомендуемый набор правил (flat config).\n *\n * Подключается как элемент массива в `eslint.config.js`:\n *\n * ```js\n * import weld from 'eslint-plugin-weld';\n *\n * export default [weld.configs.recommended];\n * ```\n */\nconst recommended: Linter.Config = {\n    name: 'weld/recommended',\n    plugins: { weld: plugin as ESLint.Plugin },\n    rules: {},\n};\n\nplugin.configs.recommended = recommended;\n\nexport { meta, rules };\nexport const configs = plugin.configs;\n\nexport default plugin;\n"]}

package/package.json

@@ -0,0 +1,73 @@
+{
+    "name": "eslint-plugin-weld",
+    "version": "0.0.1-test",
+    "description": "ESLint-плагин для проверки правил WELD (Well-Encapsulated Layered Design)",
+    "keywords": [
+        "eslint",
+        "eslintplugin",
+        "eslint-plugin",
+        "weld",
+        "architecture",
+        "layers",
+        "encapsulation",
+        "imports"
+    ],
+    "homepage": "https://github.com/jt4d-lab/weld#readme",
+    "bugs": {
+        "url": "https://github.com/jt4d-lab/weld/issues"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/jt4d-lab/weld.git"
+    },
+    "license": "MIT",
+    "author": "Arswarog",
+    "type": "module",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        },
+        "./package.json": "./package.json"
+    },
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "files": [
+        "dist",
+        "README.md",
+        "LICENSE"
+    ],
+    "scripts": {
+        "build": "tsup",
+        "format": "prettier --write .",
+        "format:check": "prettier --check .",
+        "lint": "eslint .",
+        "prepack": "yarn build",
+        "smoke": "./scripts/smoke-test.sh",
+        "test": "vitest run",
+        "test:watch": "vitest",
+        "typecheck": "tsc --noEmit",
+        "verify": "yarn lint && yarn format:check && yarn typecheck && yarn test && yarn build"
+    },
+    "devDependencies": {
+        "@eslint/js": "^10.0.0",
+        "@types/node": "^26.0.0",
+        "eslint": "^10.0.0",
+        "prettier": "^3.9.0",
+        "tsup": "^8.5.0",
+        "typescript": "^5.9.0",
+        "typescript-eslint": "^8.69.0",
+        "vitest": "^4.1.0"
+    },
+    "peerDependencies": {
+        "eslint": ">=9.0.0"
+    },
+    "packageManager": "yarn@4.10.3",
+    "engines": {
+        "node": ">=20.19.0"
+    },
+    "publishConfig": {
+        "access": "public",
+        "provenance": true
+    }
+}