@7n/rules-lang-js 0.3.1 → 0.4.0

package/rules/js/tooling/data/tooling/oxlint-canonical.json

@@ -0,0 +1,400 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "plugins": ["unicorn", "oxc", "import", "jsdoc", "promise", "node", "vue"],
+  "jsPlugins": ["@e18e/eslint-plugin"],
+  "categories": {},
+  "rules": {
+    "e18e/prefer-includes": "error",
+    "e18e/prefer-array-fill": "deny",
+    "e18e/prefer-array-to-reversed": "deny",
+    "e18e/prefer-array-to-sorted": "deny",
+    "e18e/prefer-array-to-spliced": "deny",
+    "e18e/prefer-nullish-coalescing": "deny",
+    "e18e/prefer-spread-syntax": "deny",
+    "e18e/prefer-url-canparse": "deny",
+    "e18e/ban-dependencies": ["deny", { "allowed": ["globby"] }],
+    "e18e/prefer-array-from-map": "deny",
+    "e18e/prefer-timer-args": "deny",
+    "e18e/prefer-static-regex": "deny",
+    "e18e/prefer-date-now": "deny",
+    "e18e/prefer-regex-test": "deny",
+    "array-callback-return": "deny",
+    "no-new-wrappers": "deny",
+    "import/no-named-as-default": "deny",
+    "oxc/uninvoked-array-callback": "deny",
+    "typescript/no-non-null-assertion": "deny",
+    "unicorn/prefer-date-now": "deny",
+    "no-obj-calls": "deny",
+    "default-case-last": "deny",
+    "import/no-webpack-loader-syntax": "deny",
+    "promise/no-promise-in-callback": "deny",
+    "typescript/no-unnecessary-type-constraint": "deny",
+    "unicorn/prefer-dom-node-remove": "deny",
+    "for-direction": "deny",
+    "no-prototype-builtins": "deny",
+    "typescript/no-useless-empty-export": "deny",
+    "unicorn/prefer-includes": "deny",
+    "guard-for-in": "deny",
+    "no-restricted-globals": "deny",
+    "promise/prefer-await-to-then": "off",
+    "typescript/prefer-as-const": "deny",
+    "unicorn/prefer-math-trunc": "deny",
+    "no-self-assign": "deny",
+    "max-params": "off",
+    "react/button-has-type": "deny",
+    "typescript/prefer-function-type": "deny",
+    "unicorn/prefer-native-coercion-functions": "deny",
+    "no-extra-label": "deny",
+    "no-shadow-restricted-names": "deny",
+    "react/iframe-missing-sandbox": "deny",
+    "typescript/prefer-ts-expect-error": "deny",
+    "unicorn/prefer-number-properties": "off",
+    "no-labels": "deny",
+    "no-ternary": "off",
+    "react/jsx-key": "deny",
+    "unicorn/consistent-empty-array-spread": "deny",
+    "unicorn/prefer-query-selector": "deny",
+    "no-object-constructor": "deny",
+    "react/jsx-no-script-url": "deny",
+    "unicorn/empty-brace-spaces": "deny",
+    "unicorn/prefer-set-has": "deny",
+    "no-array-constructor": "deny",
+    "react/jsx-no-useless-fragment": "deny",
+    "unicorn/explicit-length-check": "off",
+    "unicorn/prefer-string-replace-all": "deny",
+    "no-bitwise": "deny",
+    "no-unsafe-optional-chaining": "deny",
+    "react/no-children-prop": "deny",
+    "unicorn/no-abusive-eslint-disable": "deny",
+    "unicorn/prefer-string-trim-start-end": "deny",
+    "no-class-assign": "deny",
+    "no-unused-private-class-members": "deny",
+    "react/no-direct-mutation-state": "deny",
+    "unicorn/no-array-reduce": "deny",
+    "unicorn/require-array-join-separator": "deny",
+    "no-console": "off",
+    "no-useless-concat": "deny",
+    "react/no-render-return-value": "deny",
+    "unicorn/no-console-spaces": "deny",
+    "unicorn/text-encoding-identifier-case": "deny",
+    "no-constant-condition": "deny",
+    "no-useless-rename": "deny",
+    "react/no-unescaped-entities": "deny",
+    "unicorn/no-hex-escape": "deny",
+    "no-control-regex": "deny",
+    "no-with": "deny",
+    "react/react-in-jsx-scope": "deny",
+    "unicorn/no-length-as-slice-end": "deny",
+    "no-div-regex": "deny",
+    "prefer-numeric-literals": "deny",
+    "react/self-closing-comp": "deny",
+    "unicorn/no-negation-in-equality-check": "deny",
+    "no-dupe-keys": "deny",
+    "prefer-rest-params": "deny",
+    "unicorn/no-new-buffer": "deny",
+    "no-empty-character-class": "deny",
+    "require-await": "deny",
+    "node/no-exports-assign": "deny",
+    "unicorn/no-process-exit": "deny",
+    "no-empty-static-block": "deny",
+    "sort-keys": "off",
+    "oxc/bad-array-method-on-arguments": "deny",
+    "unicorn/no-thenable": "deny",
+    "typescript/ban-ts-comment": "deny",
+    "no-eval": "deny",
+    "unicode-bom": "deny",
+    "jsdoc/check-access": "deny",
+    "oxc/bad-comparison-sequence": "deny",
+    "unicorn/no-unnecessary-await": "deny",
+    "typescript/consistent-generic-constructors": "deny",
+    "no-extra-boolean-cast": "deny",
+    "vars-on-top": "deny",
+    "jsdoc/empty-tags": "deny",
+    "oxc/bad-replace-all-arg": "deny",
+    "unicorn/no-useless-fallback-in-spread": "deny",
+    "no-global-assign": "deny",
+    "jsdoc/require-param": "deny",
+    "oxc/erasing-op": "deny",
+    "unicorn/no-useless-spread": "deny",
+    "typescript/no-confusing-non-null-assertion": "deny",
+    "no-invalid-regexp": "deny",
+    "import/no-namespace": "off",
+    "jsdoc/require-param-type": "deny",
+    "oxc/no-accumulating-spread": "deny",
+    "typescript/no-empty-interface": "deny",
+    "unicorn/no-zero-fractions": "deny",
+    "import/namespace": "deny",
+    "jsdoc/require-property-name": "deny",
+    "no-label-var": "deny",
+    "typescript/no-extra-non-null-assertion": "deny",
+    "oxc/no-barrel-file": "deny",
+    "unicorn/prefer-spread": "deny",
+    "no-negated-condition": "deny",
+    "import/no-cycle": "deny",
+    "jsdoc/require-returns-description": "deny",
+    "typescript/no-misused-new": "deny",
+    "oxc/no-optional-chaining": "off",
+    "unicorn/prefer-array-flat-map": "deny",
+    "no-new-native-nonconstructor": "deny",
+    "import/no-dynamic-require": "deny",
+    "oxc/only-used-in-recursion": "deny",
+    "typescript/no-non-null-asserted-optional-chain": "deny",
+    "unicorn/prefer-code-point": "deny",
+    "default-case": "off",
+    "no-nonoctal-decimal-escape": "deny",
+    "import/no-self-import": "deny",
+    "promise/catch-or-return": "deny",
+    "typescript/no-this-alias": "deny",
+    "unicorn/prefer-dom-node-dataset": "deny",
+    "eqeqeq": "deny",
+    "no-proto": "deny",
+    "promise/no-new-statics": "deny",
+    "typescript/no-unsafe-function-type": "deny",
+    "unicorn/prefer-event-target": "deny",
+    "no-regex-spaces": "deny",
+    "promise/prefer-await-to-callbacks": "off",
+    "typescript/no-wrapper-object-types": "deny",
+    "unicorn/prefer-math-min-max": "deny",
+    "max-lines": "off",
+    "no-script-url": "deny",
+    "promise/valid-params": "deny",
+    "typescript/prefer-for-of": "deny",
+    "unicorn/prefer-modern-math-apis": "deny",
+    "no-useless-call": "deny",
+    "no-setter-return": "deny",
+    "typescript/prefer-namespace-keyword": "deny",
+    "unicorn/prefer-node-protocol": "deny",
+    "no-nested-ternary": "off",
+    "no-template-curly-in-string": "deny",
+    "react/jsx-curly-brace-presence": "deny",
+    "unicorn/catch-error-name": "deny",
+    "unicorn/prefer-prototype-methods": "deny",
+    "no-throw-literal": "deny",
+    "react/jsx-no-duplicate-props": "deny",
+    "unicorn/consistent-function-scoping": "deny",
+    "unicorn/prefer-regexp-test": "deny",
+    "no-alert": "deny",
+    "no-unexpected-multiline": "deny",
+    "react/jsx-no-undef": "deny",
+    "unicorn/escape-case": "deny",
+    "unicorn/prefer-string-raw": "deny",
+    "no-await-in-loop": "off",
+    "no-unsafe-negation": "deny",
+    "react/no-array-index-key": "deny",
+    "unicorn/new-for-builtins": "deny",
+    "unicorn/prefer-string-starts-ends-with": "deny",
+    "no-case-declarations": "deny",
+    "no-unused-labels": "deny",
+    "react/no-danger": "deny",
+    "unicorn/no-array-for-each": "deny",
+    "unicorn/prefer-type-error": "deny",
+    "no-cond-assign": "deny",
+    "no-useless-catch": "deny",
+    "react/no-is-mounted": "deny",
+    "unicorn/no-await-in-promise-methods": "deny",
+    "unicorn/switch-case-braces": "deny",
+    "no-constant-binary-expression": "deny",
+    "no-useless-escape": "deny",
+    "react/no-string-refs": "deny",
+    "unicorn/no-empty-file": "deny",
+    "no-void": "deny",
+    "unicorn/no-invalid-remove-event-listener": "deny",
+    "react/prefer-es6-class": "deny",
+    "no-delete-var": "deny",
+    "prefer-exponentiation-operator": "deny",
+    "react/rules-of-hooks": "deny",
+    "unicorn/no-magic-array-flat-depth": "deny",
+    "no-dupe-else-if": "deny",
+    "prefer-object-spread": "deny",
+    "react/void-dom-elements-no-children": "deny",
+    "unicorn/no-new-array": "deny",
+    "no-else-return": "deny",
+    "radix": "off",
+    "unicorn/no-object-as-default-parameter": "deny",
+    "no-empty-pattern": "deny",
+    "sort-imports": "off",
+    "oxc/approx-constant": "deny",
+    "typescript/array-type": "deny",
+    "unicorn/no-static-only-class": "deny",
+    "no-eq-null": "deny",
+    "symbol-description": "deny",
+    "oxc/bad-char-at-comparison": "deny",
+    "typescript/ban-types": "deny",
+    "unicorn/no-typeof-undefined": "deny",
+    "no-extend-native": "deny",
+    "valid-typeof": "deny",
+    "jsdoc/check-tag-names": "deny",
+    "oxc/bad-object-literal-comparison": "deny",
+    "typescript/consistent-type-definitions": "deny",
+    "unicorn/no-unreadable-iife": "deny",
+    "no-func-assign": "deny",
+    "import/default": "deny",
+    "jsdoc/no-defaults": "deny",
+    "oxc/double-comparisons": "deny",
+    "typescript/no-inferrable-types": "deny",
+    "unicorn/no-useless-promise-resolve-reject": "deny",
+    "no-inner-declarations": "deny",
+    "import/no-named-default": "deny",
+    "oxc/missing-throw": "deny",
+    "jsdoc/require-param-name": "deny",
+    "typescript/no-dynamic-delete": "deny",
+    "unicorn/no-useless-undefined": "deny",
+    "no-iterator": "deny",
+    "jsdoc/require-property-description": "deny",
+    "oxc/no-async-endpoint-handlers": "deny",
+    "typescript/no-explicit-any": "deny",
+    "unicorn/numeric-separators-style": "off",
+    "no-magic-numbers": "off",
+    "import/no-commonjs": "off",
+    "jsdoc/require-returns": "deny",
+    "typescript/no-import-type-side-effects": "deny",
+    "unicorn/prefer-array-flat": "deny",
+    "no-new-func": "deny",
+    "import/no-duplicates": "deny",
+    "jsdoc/require-yields": "deny",
+    "oxc/number-arg-out-of-range": "deny",
+    "typescript/no-non-null-asserted-nullish-coalescing": "deny",
+    "unicorn/prefer-blob-reading-methods": "deny",
+    "no-new": "deny",
+    "import/no-named-as-default-member": "off",
+    "promise/avoid-new": "deny",
+    "typescript/no-require-imports": "deny",
+    "unicorn/prefer-dom-node-append": "deny",
+    "default-param-last": "deny",
+    "no-plusplus": "off",
+    "import/unambiguous": "off",
+    "promise/no-callback-in-promise": "deny",
+    "typescript/no-unsafe-declaration-merging": "deny",
+    "unicorn/prefer-dom-node-text-content": "deny",
+    "func-names": "off",
+    "no-redeclare": "deny",
+    "promise/param-names": "deny",
+    "typescript/no-var-requires": "deny",
+    "unicorn/prefer-logical-operator-over-ternary": "deny",
+    "max-classes-per-file": "deny",
+    "no-return-assign": "deny",
+    "promise/spec-only": "deny",
+    "typescript/prefer-enum-initializers": "deny",
+    "unicorn/prefer-modern-dom-apis": "deny",
+    "new-cap": "off",
+    "no-self-compare": "deny",
+    "react/checked-requires-onchange-or-readonly": "deny",
+    "typescript/prefer-literal-enum-member": "deny",
+    "unicorn/prefer-negative-index": "deny",
+    "no-multi-assign": "deny",
+    "no-sparse-arrays": "deny",
+    "typescript/triple-slash-reference": "deny",
+    "react/jsx-boolean-value": "deny",
+    "unicorn/prefer-optional-catch-binding": "deny",
+    "no-lone-blocks": "deny",
+    "no-this-before-super": "deny",
+    "react/jsx-no-comment-textnodes": "deny",
+    "unicorn/consistent-existence-index-check": "deny",
+    "unicorn/prefer-reflect-apply": "deny",
+    "no-duplicate-imports": "deny",
+    "no-undefined": "off",
+    "react/jsx-no-target-blank": "deny",
+    "unicorn/prefer-set-size": "deny",
+    "unicorn/error-message": "deny",
+    "no-async-promise-executor": "deny",
+    "no-unsafe-finally": "deny",
+    "react/jsx-props-no-spread-multi": "deny",
+    "unicorn/filename-case": "off",
+    "unicorn/prefer-string-slice": "deny",
+    "no-caller": "deny",
+    "no-unused-expressions": "deny",
+    "react/no-danger-with-children": "deny",
+    "unicorn/no-anonymous-default-export": "off",
+    "unicorn/prefer-structured-clone": "deny",
+    "no-compare-neg-zero": "deny",
+    "no-unused-vars": "deny",
+    "react/no-find-dom-node": "deny",
+    "unicorn/no-await-expression-member": "deny",
+    "unicorn/require-number-to-fixed-digits-argument": "deny",
+    "no-const-assign": "deny",
+    "no-useless-constructor": "deny",
+    "react/no-set-state": "deny",
+    "unicorn/no-document-cookie": "deny",
+    "unicorn/throw-new-error": "deny",
+    "no-constructor-return": "deny",
+    "no-var": "deny",
+    "react/no-unknown-property": "deny",
+    "unicorn/no-instanceof-array": "deny",
+    "no-debugger": "deny",
+    "prefer-promise-reject-errors": "deny",
+    "unicorn/no-lonely-if": "deny",
+    "no-dupe-class-members": "deny",
+    "prefer-object-has-own": "deny",
+    "react/style-prop-object": "deny",
+    "unicorn/no-nested-ternary": "off",
+    "no-duplicate-case": "deny",
+    "prefer-spread": "deny",
+    "unicorn/no-null": "off",
+    "no-empty-function": "deny",
+    "require-yield": "deny",
+    "node/no-new-require": "deny",
+    "typescript/adjacent-overload-signatures": "deny",
+    "unicorn/no-single-promise-in-promise-methods": "deny",
+    "no-empty": "deny",
+    "sort-vars": "deny",
+    "oxc/bad-bitwise-operator": "deny",
+    "typescript/ban-tslint-comment": "deny",
+    "unicorn/no-this-assignment": "deny",
+    "no-ex-assign": "deny",
+    "use-isnan": "deny",
+    "jsdoc/check-property-names": "deny",
+    "oxc/bad-min-max-func": "deny",
+    "typescript/consistent-indexed-object-style": "deny",
+    "unicorn/no-unreadable-array-destructuring": "deny",
+    "no-fallthrough": "deny",
+    "yoda": "deny",
+    "jsdoc/implements-on-classes": "deny",
+    "oxc/const-comparisons": "deny",
+    "unicorn/no-useless-length-check": "deny",
+    "typescript/explicit-function-return-type": "deny",
+    "no-import-assign": "deny",
+    "import/first": "deny",
+    "jsdoc/require-param-description": "deny",
+    "typescript/no-duplicate-enum-values": "deny",
+    "oxc/misrefactored-assign-op": "deny",
+    "unicorn/no-useless-switch-case": "deny",
+    "no-irregular-whitespace": "deny",
+    "import/max-dependencies": "off",
+    "jsdoc/require-property": "deny",
+    "oxc/no-async-await": "off",
+    "typescript/no-empty-object-type": "deny",
+    "unicorn/number-literal-case": "deny",
+    "no-loss-of-precision": "deny",
+    "import/no-amd": "deny",
+    "jsdoc/require-property-type": "deny",
+    "oxc/no-const-enum": "deny",
+    "typescript/no-extraneous-class": "deny",
+    "unicorn/prefer-add-event-listener": "deny",
+    "no-multi-str": "deny",
+    "import/no-default-export": "off",
+    "jsdoc/require-returns-type": "deny",
+    "oxc/no-rest-spread-properties": "off",
+    "typescript/no-namespace": "deny",
+    "unicorn/prefer-array-some": "deny"
+  },
+  "settings": {
+    "next": {
+      "rootDir": []
+    },
+    "jsdoc": {
+      "ignorePrivate": false,
+      "ignoreInternal": false,
+      "ignoreReplacesDocs": true,
+      "overrideReplacesDocs": true,
+      "augmentsExtendsReplacesDocs": false,
+      "implementsReplacesDocs": false,
+      "exemptDestructuredRootsFromChecks": false,
+      "tagNamePreference": {}
+    }
+  },
+  "env": {
+    "builtin": true
+  },
+  "globals": {},
+  "ignorePatterns": ["npm/types/**", "demo/node/rules-demo.js", "**/schema.graphql", "**/auto-imports.d.ts"]
+}

package/rules/js/tooling/docs/main.md

@@ -0,0 +1,53 @@
+---
+type: JS Module
+title: main.mjs
+resource: plugins/lang-js/rules/js/tooling/main.mjs
+docgen:
+  crc: 76437b89
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Шляхи до канонічних JSON-конфігурацій для `oxlint` та `knip` доступні через
+`OXLINT_CANONICAL_JSON_PATH` та `KNIP_CANONICAL_JSON_PATH`. Модуль перевіряє,
+чи відповідає `.oxlintrc.json` канону (`verifyOxlintRcAgainstCanonical`), і
+будує детермінований merge до канону (`planOxlintrcFix`) — джерело правди для
+T0-автофіксу `js/check` (`fix-check.mjs`), без LLM.
+
+## Поведінка
+
+- `OXLINT_CANONICAL_JSON_PATH` / `KNIP_CANONICAL_JSON_PATH` — шляхи до
+  канонічних JSON-конфігів `oxlint`/`knip` у цьому пакеті.
+- `OXLINTRC_MISSING` / `OXLINTRC_DRIFT` — стабільні reason-коди для
+  порушень `.oxlintrc.json` (відсутній файл / розходження з каноном),
+  які `js/check` проставляє через `createViolationReporter`, а T0-патерн
+  `js-check-oxlintrc` розпізнає для автофіксу.
+- `verifyOxlintRcAgainstCanonical(cfg, canonical)` — звіряє `.oxlintrc.json`
+  проти канону: усі `rules`-ключі канону мають точний збіг значення (зайві
+  локальні ключі дозволені), `ignorePatterns` канону мають бути присутні
+  (локальні розширення дозволені), решта полів — точний глибокий збіг.
+- `planOxlintrcFix(actual, canonical)` — чиста функція, що дзеркалить
+  правила `verifyOxlintRcAgainstCanonical` у зворотний бік: будує обʼєкт
+  `.oxlintrc.json`, який гарантовано проходить повторну перевірку.
+  Відсутній `actual` (`null`) трактується як порожній файл — результат
+  дорівнює канону. Наявний `actual` доповнюється до канону без втрати
+  project-specific розширень: зайві `rules`-ключі й `ignorePatterns`
+  зберігаються, а канонічні `rules`-значення й поля верхнього рівня
+  перезаписуються канонічними (єдине валідне значення для перевірки).
+
+## Публічний API
+
+- `OXLINT_CANONICAL_JSON_PATH` — шлях до канонічного конфігу `oxlint` для перевірки/T0-фіксу.
+- `KNIP_CANONICAL_JSON_PATH` — шлях до канонічного конфігу `knip`, що копіюється у корінь проєкту-споживача, якщо відсутній.
+- `OXLINTRC_MISSING` / `OXLINTRC_DRIFT` — reason-коди порушень `.oxlintrc.json`.
+- `verifyOxlintRcAgainstCanonical(cfg, canonical)` → `{ ok, failures }` — перевірка `.oxlintrc.json` проти канону.
+- `planOxlintrcFix(actual, canonical)` → злитий обʼєкт `.oxlintrc.json` — детермінований T0-фікс без LLM.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД); запис у `.oxlintrc.json` — відповідальність виклику (T0 `fix-check.mjs`).
+- `planOxlintrcFix` — чиста функція без side effects; той самий вхід завжди дає той самий вихід.

package/rules/js/tooling/main.mjs

@@ -0,0 +1,183 @@
+/** @see ./docs/tooling.md */
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+/** Шлях до канонічного oxlint JSON у цьому пакеті (для перевірки та тестів). */
+export const OXLINT_CANONICAL_JSON_PATH = join(
+  dirname(fileURLToPath(import.meta.url)),
+  'data',
+  'tooling',
+  'oxlint-canonical.json'
+)
+
+/** Шлях до канонічного knip JSON у цьому пакеті — копіюється у корінь проєкту-споживача, якщо відсутній. */
+export const KNIP_CANONICAL_JSON_PATH = join(
+  dirname(fileURLToPath(import.meta.url)),
+  'data',
+  'tooling',
+  'knip-canonical.json'
+)
+
+/** `.oxlintrc.json` відсутній — T0 копіює канон (`fix-check.mjs`). */
+export const OXLINTRC_MISSING = 'oxlintrc-missing'
+/** `.oxlintrc.json` існує, але розходиться з каноном — T0 доводить до відповідності детермінованим merge. */
+export const OXLINTRC_DRIFT = 'oxlintrc-drift'
+
+// Канонічний рядок `lint-js`-скрипта і мінімальна версія `@nitra/eslint-config` —
+// у rego (`npm/policy/js_lint/package_json/`). JS-копії (`CANONICAL_LINT_JS`,
+// `isCanonicalLintJs`, `nitraEslintConfigMeetsMinVersion`) видалено, щоб не
+// було двох джерел істини й ризику дрифту.
+
+/**
+ * Рекурсивне порівняння фрагментів канону oxlint (масиви — порядок як у каноні; об'єкти — той самий набір ключів і вкладеність).
+ * @param {unknown} actual значення з `.oxlintrc.json`
+ * @param {unknown} expected значення з канону
+ * @returns {boolean} true, якщо значення збігаються за правилами канону
+ */
+function deepEqualOxlintCanonical(actual, expected) {
+  if (expected === null || typeof expected !== 'object') {
+    return actual === expected
+  }
+  if (Array.isArray(expected)) {
+    return Array.isArray(actual) && JSON.stringify(actual) === JSON.stringify(expected)
+  }
+  if (typeof actual !== 'object' || actual === null || Array.isArray(actual)) {
+    return false
+  }
+  const exp = /** @type {Record<string, unknown>} */ (expected)
+  const act = /** @type {Record<string, unknown>} */ (actual)
+  const expKeys = Object.keys(exp)
+  const actKeys = Object.keys(act)
+  if (expKeys.length !== actKeys.length) {
+    return false
+  }
+  for (const k of expKeys) {
+    if (!(k in act) || !deepEqualOxlintCanonical(act[k], exp[k])) {
+      return false
+    }
+  }
+  return true
+}
+
+/**
+ * Безпечний доступ як до plain-object запису.
+ * @param {unknown} v будь-яке значення
+ * @returns {Record<string, unknown>} запис або пустий обʼєкт, якщо `v` не plain-object
+ */
+function asRecordOrEmpty(v) {
+  return v && typeof v === 'object' && !Array.isArray(v) ? /** @type {Record<string, unknown>} */ (v) : {}
+}
+
+/**
+ * Звіряє блок `rules`: кожне правило з канону має точне збіжне значення в actual.
+ * @param {unknown} expected канонічне значення для `rules`
+ * @param {unknown} actual поточне значення для `rules`
+ * @param {string[]} failures буфер для помилок
+ */
+function compareOxlintRules(expected, actual, failures) {
+  const er = asRecordOrEmpty(expected)
+  const ar = asRecordOrEmpty(actual)
+  for (const [ruleKey, expectedValue] of Object.entries(er)) {
+    if (!deepEqualOxlintCanonical(ar[ruleKey], expectedValue)) {
+      failures.push(
+        `.oxlintrc.json: rules["${ruleKey}"] очікується ${JSON.stringify(expectedValue)}, зараз ${JSON.stringify(ar[ruleKey])}`
+      )
+    }
+  }
+}
+
+/**
+ * Звіряє блок `ignorePatterns`: кожен патерн із канону має бути присутній в actual; додаткові локальні
+ * патерни дозволені (канон задає мінімум, проєкт може розширити).
+ * @param {unknown} expected канонічний масив `ignorePatterns`
+ * @param {unknown} actual поточний `ignorePatterns` із `.oxlintrc.json`
+ * @param {string[]} failures буфер для помилок
+ */
+function compareOxlintIgnorePatterns(expected, actual, failures) {
+  if (!Array.isArray(expected)) {
+    return
+  }
+  if (!Array.isArray(actual)) {
+    failures.push(
+      '.oxlintrc.json: поле "ignorePatterns" має бути масивом (канон задає мінімум, додаткові патерни дозволені)'
+    )
+    return
+  }
+  const set = new Set(actual)
+  const missing = expected.filter(p => !set.has(p))
+  if (missing.length > 0) {
+    failures.push(
+      `.oxlintrc.json: ignorePatterns має містити канонічні патерни — додай: ${missing.map(p => JSON.stringify(p)).join(', ')}`
+    )
+  }
+}
+
+/**
+ * Перевіряє `.oxlintrc.json` проти канону пакета `@7n/rules` (усі правила з канону та інші поля з `oxlint-canonical.json`).
+ * Додаткові ключі лише в `rules` дозволені; інші поля мають збігатися з каноном.
+ * @param {unknown} cfg корінь JSON з `.oxlintrc.json`
+ * @param {unknown} canonical розпарений `oxlint-canonical.json`
+ * @returns {{ ok: boolean, failures: string[] }} статус і повідомлення для `fail`
+ */
+export function verifyOxlintRcAgainstCanonical(cfg, canonical) {
+  if (!cfg || typeof cfg !== 'object' || Array.isArray(cfg)) {
+    return { ok: false, failures: ['.oxlintrc.json: корінь має бути значенням типу object'] }
+  }
+  if (!canonical || typeof canonical !== 'object' || Array.isArray(canonical)) {
+    return { ok: false, failures: ['внутрішня помилка: канон oxlint має бути object'] }
+  }
+  const failures = []
+  const o = /** @type {Record<string, unknown>} */ (cfg)
+  const c = /** @type {Record<string, unknown>} */ (canonical)
+
+  for (const [key, expected] of Object.entries(c)) {
+    const actual = o[key]
+
+    if (key === 'rules') {
+      compareOxlintRules(expected, actual, failures)
+      continue
+    }
+
+    if (key === 'ignorePatterns') {
+      compareOxlintIgnorePatterns(expected, actual, failures)
+      continue
+    }
+
+    if (!deepEqualOxlintCanonical(actual, expected)) {
+      failures.push(
+        `.oxlintrc.json: поле "${key}" має збігатися з каноном пакета @7n/rules (npm/rules/js/tooling/data/tooling/oxlint-canonical.json)`
+      )
+    }
+  }
+
+  return { ok: failures.length === 0, failures }
+}
+
+/**
+ * Детермінований merge `.oxlintrc.json` до відповідності канону (T0 `fix-check.mjs`) —
+ * дзеркалить правила `verifyOxlintRcAgainstCanonical`, тож результат завжди проходить
+ * повторну перевірку без LLM. Project-specific розширення зберігаються: зайві ключі в
+ * `rules` і зайві `ignorePatterns` не видаляються, лише доповнюються канонічними.
+ * @param {unknown} actual поточний вміст `.oxlintrc.json` (`null`/будь-що не-object — трактується як відсутній файл)
+ * @param {Record<string, unknown>} canonical розпарсений `oxlint-canonical.json`
+ * @returns {Record<string, unknown>} злитий обʼєкт, готовий до запису у `.oxlintrc.json`
+ */
+export function planOxlintrcFix(actual, canonical) {
+  const merged = { ...asRecordOrEmpty(actual) }
+  for (const [key, expected] of Object.entries(canonical)) {
+    if (key === 'rules') {
+      merged.rules = { ...asRecordOrEmpty(merged.rules), ...asRecordOrEmpty(expected) }
+      continue
+    }
+    if (key === 'ignorePatterns') {
+      const existing = Array.isArray(merged.ignorePatterns) ? merged.ignorePatterns : []
+      const canonPatterns = Array.isArray(expected) ? expected : []
+      merged.ignorePatterns = [...existing, ...canonPatterns.filter(p => !existing.includes(p))]
+      continue
+    }
+    // Інші поля вимагають точного збігу з каноном (verifyOxlintRcAgainstCanonical) —
+    // єдине валідне значення й так канонічне, тож перезапис безпечний.
+    merged[key] = expected
+  }
+  return merged
+}

package/rules/js/utils_imports/concern.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
+  "lint": { "scope": "full", "glob": ["**/utils/**/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx}"] }
+}