@7n/rules 1.27.0 → 1.28.0

package/rules/npm-module/npm_package_json/npm_package_json.mdc

@@ -1,57 +0,0 @@
-## Rego-gate: валідація `npm/package.json`
-
-Rego-пакет: `npm-module.npm_package_json`
-
-Цільовий файл: `npm/package.json`
-
-### Що перевіряється
-
-**Поле `types`** (логіка в rego, не template-driven):
-
-- Має відповідати патерну `./types/index.d.ts` або `./types/<назва>.d.ts|.d.mts`.
-- Шляхи поза директорією `types/` або з іншими розширеннями (`.ts` без `.d`) — deny.
-
-**Поле `files`** (частково template-driven):
-
-- Обовʼязкове, має бути непорожнім масивом.
-- Subset-of перевірка: кожне значення з канонічного сніпету має бути присутнє у `files`. За замовчуванням — `"types"` обовʼязковий.
-
-**Поле `devDependencies`** (inverse-pattern, логіка в rego):
-
-- Не публікуються користувачам пакета — має бути відсутнє або порожнє `{}`.
-- Наявність будь-яких devDeps → deny з переліком залежностей. Dev-інструментарій переноситься у кореневий `package.json`; CLI-тули, які пакет спавнить через `bunx` у репозиторіях-споживачах (пінінг версій), — у `dependencies` (кореневе bun-правило `package_json` такі пакети в root devDeps не пускає).
-
-Канонічний сніпет `files`: [package.json.snippet.json](./template/package.json.snippet.json)
-
-FS-перевірки (наявність файлу зі шляху `types`, скан tarball на тест-патерни) — у JS-перевірці, не тут.
-
-### Приклади
-
-✓ Правильно:
-
-```json
-{
-  "name": "@7n/rules",
-  "types": "./types/bin/n-rules.d.ts",
-  "files": ["types", "mdc", "bin", "CHANGELOG.md"],
-  "dependencies": { "oxc-parser": "^0.128.0" }
-}
-```
-
-✗ Неправильно — `types` поза директорією `types/`:
-
-```json
-{ "types": "./dist/index.d.ts" }
-```
-
-✗ Неправильно — `files` без `"types"`:
-
-```json
-{ "files": ["bin", "mdc"] }
-```
-
-✗ Неправильно — наявні `devDependencies`:
-
-```json
-{ "devDependencies": { "@7n/rules": "^1.0.0" } }
-```

package/rules/npm-module/npm_package_json/npm_package_json.rego

@@ -1,73 +0,0 @@
-# Порт перевірок `npm/package.json` (npm-module.mdc).
-#
-# Канон надходить через --data: { "template": { "snippet": ... } }
-# Структура --data сформована з template/package.json.snippet.json
-# (snippet-array subset-of для whitelist `files`).
-#
-# Логіка, що ЛИШАЄТЬСЯ у rego (inverse-patterns, не виносяться у template):
-#  - форма поля `types` (regex pattern: `./types/index.d.ts` або `./types/<…>.d.ts|.d.mts`);
-#  - `devDependencies` мають бути відсутні або порожні (inverse-pattern — заборона будь-яких).
-#
-# FS-перевірки (наявність файлу зі шляху `types`, скан tarball на тест-патерни) — у JS.
-package npm_module.npm_package_json
-
-import rego.v1
-
-types_field_template := concat(" ", [
-	"npm/package.json: поле \"types\" має бути \"./types/index.d.ts\"",
-	"або \"./types/<…>.d.ts|.d.mts\" (зараз: %v) (npm-module.mdc)",
-])
-
-dev_deps_template := concat(" ", [
-	"npm/package.json: \"devDependencies\" не публікуються користувачам пакета —",
-	"dev-інструментарій перенеси у кореневий package.json, а CLI-тули, які пакет",
-	"спавнить через bunx у споживачів, — у \"dependencies\": %v (npm-module.mdc)",
-])
-
-# ── deny: types (regex — лишається в rego) ───────────────────────────────
-
-deny contains msg if {
-	types_field := object.get(input, "types", "")
-	not valid_types_field(types_field)
-	msg := sprintf(types_field_template, [types_field])
-}
-
-# ── deny: files має існувати та бути масивом ─────────────────────────────
-
-deny contains msg if {
-	not is_array(object.get(input, "files", null))
-	msg := "npm/package.json: обовʼязковий whitelist \"files\" (без нього npm пакує майже все) (npm-module.mdc)"
-}
-
-deny contains msg if {
-	is_array(input.files)
-	count(input.files) == 0
-	msg := "npm/package.json: масив \"files\" не повинен бути порожнім (npm-module.mdc: компактний пакет)"
-}
-
-# ── deny: files subset-of з template (template-driven) ──────────────────
-
-deny contains msg if {
-	some field, expected_values in data.template.snippet
-	is_array(object.get(input, field, null))
-	count(input[field]) > 0
-	actual_set := {v | some v in input[field]}
-	some required in expected_values
-	not required in actual_set
-	msg := sprintf("npm/package.json: масив \"%s\" має містити %q (npm-module.mdc)", [field, required])
-}
-
-# ── deny: devDependencies (inverse-pattern, лишається в rego) ────────────
-
-deny contains msg if {
-	dev := object.get(input, "devDependencies", {})
-	count(dev) > 0
-	names := concat(", ", sort([n | some n, _ in dev]))
-	msg := sprintf(dev_deps_template, [names])
-}
-
-# ── helpers ────────────────────────────────────────────────────────────────
-
-valid_types_field("./types/index.d.ts")
-
-valid_types_field(t) if regex.match(`^\./types/.+\.d\.(ts|mts)$`, t)

package/rules/npm-module/npm_package_json/template/package.json.snippet.json

@@ -1 +0,0 @@
-{ "files": ["types"] }

package/rules/npm-module/package_structure/concern.json

@@ -1,5 +0,0 @@
-{
-  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
-  "fixability": "structural",
-  "lint": { "scope": "full", "glob": ["**/*"] }
-}

package/rules/npm-module/package_structure/docs/main.md

@@ -1,37 +0,0 @@
----
-type: JS Module
-title: main.mjs
-resource: npm/rules/npm-module/package_structure/main.mjs
-docgen:
-  crc: 321b552d
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 85
-  issues: anchor-miss:(npm-module.mdc),surzhik,judge:inaccurate:0.99
-  judgeModel: openai-codex/gpt-5.4-mini
----
-
-## Огляд
-
-Компонент валідує відповідність проєкту стандартам, визначеним у `npm-module.mdc`, аналізуючи конфігурації (`tsconfig.emit-types.json`, `package.json`, `meta.json`). Він виконує логіку, зокрема через функції `globToRegex`, `findTestFrameworkImport`, `classifyPublishedFileAsTest` та `main`, обробляючи помилки за принципом fail-safe, ніколи не кидаючи винятків назовні. Процес роботи є read-only, і він свідомо ігнорує каталоги `.github` та `.git` під час аналізу.
-
-## Поведінка
-
-Поведінка:
-globToRegex перетворює glob-патерн у регулярний вираз з якорями початку та кінця, підтримуючи globstar, `*`, `?` та brace-альтернативи; ігнорує шляхи з `.github` та `.git`.
-findTestFrameworkImport шукає у вмісті файлу імпорти або виклики, які вказують на використання тестових фреймворків.
-classifyPublishedFileAsTest визначає, чи вважається певний опублікований файл тестовим або фікстурою на основі назви, каталогу або імпортів.
-main виконує повну перевірку відповідності проєкту конвенціям npm-module.mdc, аналізуючи структуру, конфігурації та файли, і виводить статус проходження перевірок.
-
-## Публічний API
-
-globToRegex — перетворює шаблон пошуку файлів у регулярний вираз, забезпечуючи коректне зіставлення шляхів.
-findTestFrameworkImport — виявляє, чи використовується у файлі механізм імпорту тест-фреймворку.
-classifyPublishedFileAsTest — визначає, чи повинен вважатися опублікований файл тестом або фікстурою, ґрунтуючись на його шляху та вмісті.
-main — забезпечує дотримання проєкту всіх вимог, визначених у конвенціях, описаних у npm-module.mdc.
-
-## Гарантії поведінки
-
-- Read-only: не виконує операцій запису (ФС/БД).
-- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
-- За певних помилок повертає порожнє значення (напр. `null`) замість винятку.
-- Свідомо пропускає шляхи: `.github`, `.git`.