@foxford/eslint-plugin-analytics 0.0.0-stage → 1.0.1

package/README.mdx

@@ -0,0 +1,54 @@
+# @foxford/eslint-plugin-analytics
+
+ESLint-плагин для валидации разметки `data-fxa-*` в JSX (система декларативной аналитики Foxford FXA).
+
+## Правила
+
+| Правило | Описание | Уровень |
+|---------|----------|---------|
+| `valid-fxa-format` | Проверка формата значений `data-fxa-*` (regex + длина) | error |
+| `known-fxa-value` | Проверка значений по реестрам `@foxford/analytics-registries` | error |
+| `valid-fxa-combo` | Combo `data-fxa-path` + `data-fxa-action` только на разрешённых тегах | error |
+| `no-useless-fxa-kind` | Предупреждение на `data-fxa-kind` без `data-fxa-path` или на семантическом теге | warn |
+| `registry-freshness` | Предупреждение при устаревших реестрах (>7 дней) | warn |
+
+## Использование
+
+### ESLint 9 (flat config)
+
+```js
+// eslint.config.mjs
+import analyticsPlugin from '@foxford/eslint-plugin-analytics'
+
+export default [
+  analyticsPlugin.configs.recommended,
+]
+```
+
+### ESLint 8 (legacy .eslintrc)
+
+```js
+// .eslintrc.js
+module.exports = {
+  plugins: ['@foxford/analytics'],
+  extends: ['plugin:@foxford/analytics/legacy'],
+}
+```
+
+Или через явное указание правил:
+
+```js
+// .eslintrc.js
+const analyticsPlugin = require('@foxford/eslint-plugin-analytics')
+
+module.exports = {
+  plugins: ['@foxford/analytics'],
+  rules: analyticsPlugin.configs.legacy.rules,
+}
+```
+
+## Сборка и публикация
+
+`pnpm run build` собирает ESM, CommonJS и декларации типов в `build/`. Команда `fox deploy npm` публикует содержимое этого каталога; поле `files` в собранном `package.json` включает JavaScript и декларации относительно корня npm-пакета. Версия в `plugin.meta.version` берётся из исходного `package.json` при сборке.
+
+`pnpm run test` проверяет состав npm-архива через `npm pack --dry-run` после свежей сборки в отдельном временном каталоге. Проверка также загружает упакованные файлы через `import` и `require` и сверяет версию плагина с манифестом.

package/index.cjs

@@ -0,0 +1,541 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  default: () => plugin,
+  legacyConfig: () => legacyConfig,
+  recommendedConfig: () => recommendedConfig,
+  rules: () => rules
+});
+module.exports = __toCommonJS(index_exports);
+
+// ../../node_modules/.pnpm/tsup@8.5.1_@swc+core@1.15.18_@swc+helpers@0.5.23__jiti@1.21.7_postcss@8.5.25_supports-c_091cfba73c92b8fea62c19628bddae8d/node_modules/tsup/assets/cjs_shims.js
+var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
+var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
+
+// src/utils/jsx-helpers.ts
+function getJSXAttributeStringValue(attr) {
+  const { value } = attr;
+  if (!value) return null;
+  if (value.type === "Literal" && typeof value.value === "string") {
+    return value.value;
+  }
+  if (value.type === "JSXExpressionContainer" && value.expression.type === "Literal" && typeof value.expression.value === "string") {
+    return value.expression.value;
+  }
+  return null;
+}
+function getJSXElementName(node) {
+  const { name } = node;
+  if (name.type === "JSXIdentifier") {
+    return name.name;
+  }
+  if (name.type === "JSXNamespacedName") {
+    return `${name.namespace.name}:${name.name.name}`;
+  }
+  return null;
+}
+function findJSXAttribute(node, attrName) {
+  return node.attributes.find(
+    (attr) => attr.type === "JSXAttribute" && attr.name.type === "JSXIdentifier" && attr.name.name === attrName
+  );
+}
+function hasJSXAttribute(node, attrName) {
+  return findJSXAttribute(node, attrName) !== void 0;
+}
+
+// src/utils/registry-loader.ts
+var import_node_fs = __toESM(require("fs"), 1);
+var import_node_module = require("module");
+
+// ../analytics-registries/src/registries/actions.json
+var actions_default = [
+  "buy",
+  "open",
+  "close",
+  "submit-order",
+  "toggle",
+  "select-day",
+  "apply-promo",
+  "accept-invite",
+  "favorite",
+  "confirm",
+  "cancel",
+  "nav-profile",
+  "nav-settings",
+  "nav-billing",
+  "logout",
+  "select-tab",
+  "prev-month",
+  "next-month",
+  "input-name",
+  "input-email",
+  "select-card",
+  "select-sbp"
+];
+
+// ../analytics-registries/src/registries/kinds.json
+var kinds_default = [
+  "modal",
+  "card",
+  "accordion",
+  "tabs",
+  "banner",
+  "tooltip",
+  "dropdown",
+  "menu",
+  "calendar"
+];
+
+// ../analytics-registries/src/registries/paths.json
+var paths_default = [
+  "dashboard",
+  "checkout",
+  "course-card",
+  "invite-banner",
+  "my-courses",
+  "main-nav",
+  "search-results",
+  "site-header",
+  "recommendations",
+  "reschedule",
+  "user-menu",
+  "faq",
+  "date-picker",
+  "days-grid",
+  "footer",
+  "personal",
+  "payment",
+  "method",
+  "items"
+];
+
+// ../analytics-registries/src/types.ts
+var actions = actions_default;
+var kinds = kinds_default;
+var paths = paths_default;
+
+// ../analytics-registries/src/validation.ts
+var MAX_VALUE_LENGTH = 32;
+function sanitizeValue(value) {
+  return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, MAX_VALUE_LENGTH);
+}
+var actionsSet = new Set(actions);
+var kindsSet = new Set(kinds);
+var pathsSet = new Set(paths);
+
+// ../analytics-registries/src/constants.ts
+var COMBO_TAG_WHITELIST = ["a", "form", "button", "label", "summary"];
+
+// src/utils/registry-loader.ts
+var REGISTRIES = {
+  actions,
+  kinds,
+  paths
+};
+var requireModule = (0, import_node_module.createRequire)(importMetaUrl);
+function loadRegistry(name) {
+  return REGISTRIES[name];
+}
+function getRegistryMtime(_name) {
+  try {
+    const pkgPath = requireModule.resolve("@foxford/analytics-registries/package.json");
+    return import_node_fs.default.statSync(pkgPath).mtime;
+  } catch {
+    return null;
+  }
+}
+
+// src/rules/known-fxa-value.ts
+var ATTR_TO_REGISTRY = {
+  "data-fxa-action": "actions",
+  "data-fxa-kind": "kinds",
+  "data-fxa-path": "paths"
+};
+var KNOWN_SETS = {
+  actions: new Set(loadRegistry("actions")),
+  kinds: new Set(loadRegistry("kinds")),
+  paths: new Set(loadRegistry("paths"))
+};
+var rule = {
+  create(context) {
+    return {
+      JSXOpeningElement(rawNode) {
+        const node = rawNode;
+        for (const [attrName, registryName] of Object.entries(ATTR_TO_REGISTRY)) {
+          const attr = findJSXAttribute(node, attrName);
+          if (!attr) continue;
+          const value = getJSXAttributeStringValue(attr);
+          if (value === null) continue;
+          const registry = loadRegistry(registryName);
+          const knownSet = KNOWN_SETS[registryName];
+          if (!knownSet.has(value)) {
+            const known = registry.slice(0, 10).join(", ") + (registry.length > 10 ? ", ..." : "");
+            context.report({
+              data: { attr: attrName, known, value },
+              messageId: "unknownValue",
+              node: attr
+            });
+          }
+        }
+      }
+    };
+  },
+  meta: {
+    docs: {
+      description: "\u041F\u0440\u043E\u0432\u0435\u0440\u044F\u0435\u0442 \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u044F \u0430\u0442\u0440\u0438\u0431\u0443\u0442\u043E\u0432 data-fxa-* \u043F\u043E \u0440\u0435\u0435\u0441\u0442\u0440\u0430\u043C @foxford/analytics-registries",
+      recommended: true,
+      url: "https://github.com/foxford/frontend-platform"
+    },
+    messages: {
+      unknownValue: '\u041D\u0435\u0438\u0437\u0432\u0435\u0441\u0442\u043D\u043E\u0435 \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u0435 "{{value}}" \u0434\u043B\u044F {{attr}}. \u0414\u043E\u043F\u0443\u0441\u0442\u0438\u043C\u044B\u0435 \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u044F: {{known}}'
+    },
+    schema: [],
+    type: "problem"
+  }
+};
+
+// src/rules/no-useless-fxa-kind.ts
+var SEMANTIC_TAGS_WITH_TYPE = /* @__PURE__ */ new Set([
+  "form",
+  "nav",
+  "header",
+  "footer",
+  "main",
+  "aside",
+  "section",
+  "article",
+  "dialog",
+  "figure",
+  "details"
+]);
+var rule2 = {
+  create(context) {
+    return {
+      JSXOpeningElement(rawNode) {
+        const node = rawNode;
+        const kindAttr = findJSXAttribute(node, "data-fxa-kind");
+        if (!kindAttr) return;
+        const kindNode = kindAttr;
+        const tagName = getJSXElementName(node);
+        if (tagName !== null && SEMANTIC_TAGS_WITH_TYPE.has(tagName)) {
+          context.report({
+            data: { tag: tagName },
+            messageId: "redundantKindOnSemanticTag",
+            node: kindNode
+          });
+        }
+        if (!hasJSXAttribute(node, "data-fxa-path")) {
+          context.report({
+            messageId: "kindWithoutPath",
+            node: kindNode
+          });
+        }
+      }
+    };
+  },
+  meta: {
+    docs: {
+      description: "\u041F\u0440\u0435\u0434\u0443\u043F\u0440\u0435\u0436\u0434\u0430\u0435\u0442 \u043E\u0431 \u0438\u0437\u0431\u044B\u0442\u043E\u0447\u043D\u043E\u043C data-fxa-kind: \u0431\u0435\u0437 data-fxa-path \u0438\u043B\u0438 \u043D\u0430 \u0441\u0435\u043C\u0430\u043D\u0442\u0438\u0447\u0435\u0441\u043A\u043E\u043C \u0442\u0435\u0433\u0435",
+      recommended: true,
+      url: "https://github.com/foxford/frontend-platform"
+    },
+    messages: {
+      kindWithoutPath: "data-fxa-kind \u0431\u0435\u0437 data-fxa-path \u043D\u0430 \u0442\u043E\u043C \u0436\u0435 \u044D\u043B\u0435\u043C\u0435\u043D\u0442\u0435 \u043D\u0435 \u0438\u043C\u0435\u0435\u0442 \u0441\u043C\u044B\u0441\u043B\u0430",
+      redundantKindOnSemanticTag: "\u0418\u0437\u0431\u044B\u0442\u043E\u0447\u043D\u044B\u0439 data-fxa-kind \u043D\u0430 \u0442\u0435\u0433\u0435 <{{tag}}> \u2014 \u0442\u0435\u0433 \u0443\u0436\u0435 \u043F\u0440\u0435\u0434\u043E\u0441\u0442\u0430\u0432\u043B\u044F\u0435\u0442 \u0441\u0435\u043C\u0430\u043D\u0442\u0438\u0447\u0435\u0441\u043A\u0438\u0439 \u0442\u0438\u043F"
+    },
+    schema: [],
+    type: "suggestion"
+  }
+};
+
+// src/rules/registry-freshness.ts
+var MAX_REGISTRY_AGE_MS = 7 * 24 * 60 * 60 * 1e3;
+var REGISTRY_NAMES = ["actions", "kinds", "paths"];
+var freshnessCheckResult = null;
+var rule3 = {
+  create(context) {
+    return {
+      Program(node) {
+        if (!freshnessCheckResult) {
+          const now = Date.now();
+          const stale = [];
+          for (const name of REGISTRY_NAMES) {
+            const mtime = getRegistryMtime(name);
+            if (mtime !== null && now - mtime.getTime() > MAX_REGISTRY_AGE_MS) {
+              stale.push(name);
+            }
+          }
+          freshnessCheckResult = { stale };
+        }
+        if (freshnessCheckResult.stale.length > 0) {
+          context.report({
+            data: { registries: freshnessCheckResult.stale.join(", ") },
+            messageId: "staleRegistry",
+            node
+          });
+        }
+      }
+    };
+  },
+  meta: {
+    docs: {
+      description: "\u041F\u0440\u0435\u0434\u0443\u043F\u0440\u0435\u0436\u0434\u0430\u0435\u0442 \u043F\u0440\u0438 \u0443\u0441\u0442\u0430\u0440\u0435\u0432\u0448\u0438\u0445 \u0440\u0435\u0435\u0441\u0442\u0440\u0430\u0445 data-fxa-* (\u043D\u0435 \u043E\u0431\u043D\u043E\u0432\u043B\u044F\u043B\u0438\u0441\u044C >7 \u0434\u043D\u0435\u0439)",
+      recommended: true,
+      url: "https://github.com/foxford/frontend-platform"
+    },
+    messages: {
+      staleRegistry: "\u0420\u0435\u0435\u0441\u0442\u0440 {{registries}} \u043D\u0435 \u043E\u0431\u043D\u043E\u0432\u043B\u044F\u043B\u0441\u044F \u0431\u043E\u043B\u0435\u0435 7 \u0434\u043D\u0435\u0439. \u041F\u0440\u043E\u0432\u0435\u0440\u044C\u0442\u0435 \u0430\u043A\u0442\u0443\u0430\u043B\u044C\u043D\u043E\u0441\u0442\u044C \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u0439 data-fxa-*."
+    },
+    schema: [],
+    type: "suggestion"
+  }
+};
+
+// src/rules/valid-fxa-combo.ts
+var COMBO_ALLOWED_TAGS = new Set(COMBO_TAG_WHITELIST);
+var rule4 = {
+  create(context) {
+    return {
+      JSXOpeningElement(rawNode) {
+        const node = rawNode;
+        const hasPath = hasJSXAttribute(node, "data-fxa-path");
+        const hasAction = hasJSXAttribute(node, "data-fxa-action");
+        if (!hasPath || !hasAction) return;
+        const tagName = getJSXElementName(node);
+        if (tagName === null) return;
+        if (COMBO_ALLOWED_TAGS.has(tagName)) return;
+        const actionAttr = findJSXAttribute(node, "data-fxa-action");
+        const reportNode = actionAttr ?? rawNode;
+        context.report({
+          data: {
+            allowed: Array.from(COMBO_ALLOWED_TAGS).join(", "),
+            tag: tagName
+          },
+          messageId: "invalidCombo",
+          node: reportNode
+        });
+      }
+    };
+  },
+  meta: {
+    docs: {
+      description: "Combo data-fxa-path + data-fxa-action \u0440\u0430\u0437\u0440\u0435\u0448\u0451\u043D \u0442\u043E\u043B\u044C\u043A\u043E \u043D\u0430 \u0442\u0435\u0433\u0430\u0445: a, form, button, label, summary",
+      recommended: true,
+      url: "https://github.com/foxford/frontend-platform"
+    },
+    messages: {
+      invalidCombo: "Combo data-fxa-path + data-fxa-action \u043D\u0430 \u0442\u0435\u0433\u0435 <{{tag}}> \u043D\u0435\u0434\u043E\u043F\u0443\u0441\u0442\u0438\u043C. \u0420\u0430\u0437\u0440\u0435\u0448\u0451\u043D\u043D\u044B\u0435 \u0442\u0435\u0433\u0438: {{allowed}}"
+    },
+    schema: [],
+    type: "problem"
+  }
+};
+
+// src/rules/valid-fxa-format.ts
+var CHECKED_ATTRIBUTES = ["data-fxa-path", "data-fxa-action", "data-fxa-kind"];
+var FORMAT_REGEX = /^[a-z0-9-]+$/;
+var MAX_LENGTH = 32;
+var rule5 = {
+  create(context) {
+    return {
+      JSXOpeningElement(rawNode) {
+        const node = rawNode;
+        for (const attrName of CHECKED_ATTRIBUTES) {
+          const attr = findJSXAttribute(node, attrName);
+          if (!attr) continue;
+          const value = getJSXAttributeStringValue(attr);
+          if (value === null) continue;
+          const isValid = value.length > 0 && value.length <= MAX_LENGTH && FORMAT_REGEX.test(value);
+          if (!isValid) {
+            const sanitized = sanitizeValue(value);
+            context.report({
+              data: { attr: attrName, value },
+              messageId: "invalidFormat",
+              node: attr,
+              suggest: sanitized ? [
+                {
+                  data: { sanitized },
+                  fix(fixer) {
+                    const attrValue = attr.value;
+                    if (!attrValue) return null;
+                    if (attrValue.type === "Literal") {
+                      return fixer.replaceText(attrValue, `"${sanitized}"`);
+                    }
+                    if (attrValue.type === "JSXExpressionContainer") {
+                      return fixer.replaceText(attrValue, `"${sanitized}"`);
+                    }
+                    return null;
+                  },
+                  messageId: "suggestFix"
+                }
+              ] : []
+            });
+          }
+        }
+      }
+    };
+  },
+  meta: {
+    docs: {
+      description: "\u041F\u0440\u043E\u0432\u0435\u0440\u044F\u0435\u0442 \u0444\u043E\u0440\u043C\u0430\u0442 \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u0439 \u0430\u0442\u0440\u0438\u0431\u0443\u0442\u043E\u0432 data-fxa-* (regex ^[a-z0-9-]+$, \u0434\u043B\u0438\u043D\u0430 \u226432)",
+      recommended: true,
+      url: "https://github.com/foxford/frontend-platform"
+    },
+    hasSuggestions: true,
+    messages: {
+      invalidFormat: '\u0417\u043D\u0430\u0447\u0435\u043D\u0438\u0435 "{{value}}" \u0430\u0442\u0440\u0438\u0431\u0443\u0442\u0430 {{attr}} \u043D\u0435 \u0441\u043E\u043E\u0442\u0432\u0435\u0442\u0441\u0442\u0432\u0443\u0435\u0442 \u0444\u043E\u0440\u043C\u0430\u0442\u0443 ^[a-z0-9-]+$ \u0438\u043B\u0438 \u043F\u0440\u0435\u0432\u044B\u0448\u0430\u0435\u0442 32 \u0441\u0438\u043C\u0432\u043E\u043B\u0430',
+      suggestFix: '\u0417\u0430\u043C\u0435\u043D\u0438\u0442\u044C \u043D\u0430 \u0441\u0430\u043D\u0438\u0442\u0438\u0437\u0438\u0440\u043E\u0432\u0430\u043D\u043D\u043E\u0435 \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u0435 "{{sanitized}}"'
+    },
+    schema: [],
+    type: "problem"
+  }
+};
+
+// package.json
+var package_default = {
+  name: "@foxford/eslint-plugin-analytics",
+  version: "1.0.1",
+  description: "ESLint-\u043F\u043B\u0430\u0433\u0438\u043D \u0434\u043B\u044F \u0432\u0430\u043B\u0438\u0434\u0430\u0446\u0438\u0438 \u0440\u0430\u0437\u043C\u0435\u0442\u043A\u0438 data-fxa-* \u0432 JSX (\u0441\u0438\u0441\u0442\u0435\u043C\u0430 \u0434\u0435\u043A\u043B\u0430\u0440\u0430\u0442\u0438\u0432\u043D\u043E\u0439 \u0430\u043D\u0430\u043B\u0438\u0442\u0438\u043A\u0438 Foxford)",
+  keywords: [
+    "foxford",
+    "eslint-plugin",
+    "analytics",
+    "fxa"
+  ],
+  homepage: "https://github.com/foxford/frontend-platform",
+  bugs: "https://github.com/foxford/frontend-platform/issues",
+  repository: {
+    type: "git",
+    url: "git+https://github.com/foxford/frontend-platform.git",
+    directory: "packages/eslint-plugin-analytics"
+  },
+  license: "MIT",
+  author: "Foxford Co",
+  maintainers: [
+    {
+      name: "Roman Olin",
+      email: "r.v.olin@foxford.ru",
+      team: "core-frontend"
+    }
+  ],
+  main: "src/index.ts",
+  type: "module",
+  exports: {
+    ".": {
+      import: "./src/index.ts",
+      default: "./src/index.ts"
+    }
+  },
+  files: [
+    "build"
+  ],
+  scripts: {
+    "============================ BUILD =============================": "",
+    build: "tsup",
+    "============================ DEPLOY ============================": "",
+    deploy: "fox deploy npm",
+    "deploy:npm": "fox deploy npm --local-dir=build",
+    "============================ LINT ==============================": "",
+    "lint:clean": "rm -f .eslintcache",
+    "lint:type-check": "tsc --noEmit --pretty",
+    "lint:eslint": "eslint --cache --cache-strategy content --max-warnings=0 ./",
+    "============================ TEST ==============================": "",
+    test: "vitest run",
+    "test:watch": "vitest"
+  },
+  dependencies: {
+    "@foxford/analytics-registries": "workspace:*"
+  },
+  peerDependencies: {
+    eslint: ">=8.0.0"
+  },
+  devDependencies: {
+    "@foxford/eslint-config": "workspace:*",
+    "@foxford/prettier-config": "workspace:*",
+    "@foxford/typescript-config": "workspace:*",
+    "@foxford/vitest-config": "workspace:*",
+    "@types/node": "catalog:dev",
+    eslint: "catalog:linter",
+    tsup: "catalog:dev",
+    typescript: "catalog:dev",
+    vitest: "catalog:dev"
+  }
+};
+
+// src/index.ts
+var { version } = package_default;
+var rules = {
+  "known-fxa-value": rule,
+  "no-useless-fxa-kind": rule2,
+  "registry-freshness": rule3,
+  "valid-fxa-combo": rule4,
+  "valid-fxa-format": rule5
+};
+var recommendedConfig = {
+  plugins: {
+    "@foxford/analytics": { rules }
+  },
+  rules: {
+    "@foxford/analytics/known-fxa-value": "error",
+    "@foxford/analytics/no-useless-fxa-kind": "warn",
+    "@foxford/analytics/registry-freshness": "warn",
+    "@foxford/analytics/valid-fxa-combo": "error",
+    "@foxford/analytics/valid-fxa-format": "error"
+  }
+};
+var legacyConfig = {
+  plugins: ["@foxford/analytics"],
+  rules: {
+    "@foxford/analytics/known-fxa-value": "error",
+    "@foxford/analytics/no-useless-fxa-kind": "warn",
+    "@foxford/analytics/registry-freshness": "warn",
+    "@foxford/analytics/valid-fxa-combo": "error",
+    "@foxford/analytics/valid-fxa-format": "error"
+  }
+};
+var plugin = {
+  configs: {
+    legacy: legacyConfig,
+    recommended: recommendedConfig
+  },
+  meta: {
+    name: "@foxford/eslint-plugin-analytics",
+    version
+  },
+  rules
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  legacyConfig,
+  recommendedConfig,
+  rules
+});

package/index.d.cts

@@ -0,0 +1,17 @@
+import { ESLint, Linter, Rule } from 'eslint';
+
+/** Карта правил плагина */
+declare const rules: Record<string, Rule.RuleModule>;
+/** Рекомендованная конфигурация плагина для ESLint 9 (flat config, eslint.config.mjs) */
+declare const recommendedConfig: Linter.Config;
+/** Конфигурация плагина для ESLint 8 (legacy .eslintrc) */
+declare const legacyConfig: Linter.LegacyConfig;
+/** ESLint-плагин `@foxford/analytics` для валидации разметки data-fxa-* в JSX */
+declare const plugin: ESLint.Plugin & {
+    configs: {
+        recommended: Linter.Config;
+        legacy: Linter.LegacyConfig;
+    };
+};
+
+export { plugin as default, legacyConfig, recommendedConfig, rules };

package/index.d.ts

@@ -0,0 +1,17 @@
+import { ESLint, Linter, Rule } from 'eslint';
+
+/** Карта правил плагина */
+declare const rules: Record<string, Rule.RuleModule>;
+/** Рекомендованная конфигурация плагина для ESLint 9 (flat config, eslint.config.mjs) */
+declare const recommendedConfig: Linter.Config;
+/** Конфигурация плагина для ESLint 8 (legacy .eslintrc) */
+declare const legacyConfig: Linter.LegacyConfig;
+/** ESLint-плагин `@foxford/analytics` для валидации разметки data-fxa-* в JSX */
+declare const plugin: ESLint.Plugin & {
+    configs: {
+        recommended: Linter.Config;
+        legacy: Linter.LegacyConfig;
+    };
+};
+
+export { plugin as default, legacyConfig, recommendedConfig, rules };

package/index.js

@@ -0,0 +1,498 @@
+// src/utils/jsx-helpers.ts
+function getJSXAttributeStringValue(attr) {
+  const { value } = attr;
+  if (!value) return null;
+  if (value.type === "Literal" && typeof value.value === "string") {
+    return value.value;
+  }
+  if (value.type === "JSXExpressionContainer" && value.expression.type === "Literal" && typeof value.expression.value === "string") {
+    return value.expression.value;
+  }
+  return null;
+}
+function getJSXElementName(node) {
+  const { name } = node;
+  if (name.type === "JSXIdentifier") {
+    return name.name;
+  }
+  if (name.type === "JSXNamespacedName") {
+    return `${name.namespace.name}:${name.name.name}`;
+  }
+  return null;
+}
+function findJSXAttribute(node, attrName) {
+  return node.attributes.find(
+    (attr) => attr.type === "JSXAttribute" && attr.name.type === "JSXIdentifier" && attr.name.name === attrName
+  );
+}
+function hasJSXAttribute(node, attrName) {
+  return findJSXAttribute(node, attrName) !== void 0;
+}
+
+// src/utils/registry-loader.ts
+import fs from "fs";
+import { createRequire } from "module";
+
+// ../analytics-registries/src/registries/actions.json
+var actions_default = [
+  "buy",
+  "open",
+  "close",
+  "submit-order",
+  "toggle",
+  "select-day",
+  "apply-promo",
+  "accept-invite",
+  "favorite",
+  "confirm",
+  "cancel",
+  "nav-profile",
+  "nav-settings",
+  "nav-billing",
+  "logout",
+  "select-tab",
+  "prev-month",
+  "next-month",
+  "input-name",
+  "input-email",
+  "select-card",
+  "select-sbp"
+];
+
+// ../analytics-registries/src/registries/kinds.json
+var kinds_default = [
+  "modal",
+  "card",
+  "accordion",
+  "tabs",
+  "banner",
+  "tooltip",
+  "dropdown",
+  "menu",
+  "calendar"
+];
+
+// ../analytics-registries/src/registries/paths.json
+var paths_default = [
+  "dashboard",
+  "checkout",
+  "course-card",
+  "invite-banner",
+  "my-courses",
+  "main-nav",
+  "search-results",
+  "site-header",
+  "recommendations",
+  "reschedule",
+  "user-menu",
+  "faq",
+  "date-picker",
+  "days-grid",
+  "footer",
+  "personal",
+  "payment",
+  "method",
+  "items"
+];
+
+// ../analytics-registries/src/types.ts
+var actions = actions_default;
+var kinds = kinds_default;
+var paths = paths_default;
+
+// ../analytics-registries/src/validation.ts
+var MAX_VALUE_LENGTH = 32;
+function sanitizeValue(value) {
+  return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, MAX_VALUE_LENGTH);
+}
+var actionsSet = new Set(actions);
+var kindsSet = new Set(kinds);
+var pathsSet = new Set(paths);
+
+// ../analytics-registries/src/constants.ts
+var COMBO_TAG_WHITELIST = ["a", "form", "button", "label", "summary"];
+
+// src/utils/registry-loader.ts
+var REGISTRIES = {
+  actions,
+  kinds,
+  paths
+};
+var requireModule = createRequire(import.meta.url);
+function loadRegistry(name) {
+  return REGISTRIES[name];
+}
+function getRegistryMtime(_name) {
+  try {
+    const pkgPath = requireModule.resolve("@foxford/analytics-registries/package.json");
+    return fs.statSync(pkgPath).mtime;
+  } catch {
+    return null;
+  }
+}
+
+// src/rules/known-fxa-value.ts
+var ATTR_TO_REGISTRY = {
+  "data-fxa-action": "actions",
+  "data-fxa-kind": "kinds",
+  "data-fxa-path": "paths"
+};
+var KNOWN_SETS = {
+  actions: new Set(loadRegistry("actions")),
+  kinds: new Set(loadRegistry("kinds")),
+  paths: new Set(loadRegistry("paths"))
+};
+var rule = {
+  create(context) {
+    return {
+      JSXOpeningElement(rawNode) {
+        const node = rawNode;
+        for (const [attrName, registryName] of Object.entries(ATTR_TO_REGISTRY)) {
+          const attr = findJSXAttribute(node, attrName);
+          if (!attr) continue;
+          const value = getJSXAttributeStringValue(attr);
+          if (value === null) continue;
+          const registry = loadRegistry(registryName);
+          const knownSet = KNOWN_SETS[registryName];
+          if (!knownSet.has(value)) {
+            const known = registry.slice(0, 10).join(", ") + (registry.length > 10 ? ", ..." : "");
+            context.report({
+              data: { attr: attrName, known, value },
+              messageId: "unknownValue",
+              node: attr
+            });
+          }
+        }
+      }
+    };
+  },
+  meta: {
+    docs: {
+      description: "\u041F\u0440\u043E\u0432\u0435\u0440\u044F\u0435\u0442 \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u044F \u0430\u0442\u0440\u0438\u0431\u0443\u0442\u043E\u0432 data-fxa-* \u043F\u043E \u0440\u0435\u0435\u0441\u0442\u0440\u0430\u043C @foxford/analytics-registries",
+      recommended: true,
+      url: "https://github.com/foxford/frontend-platform"
+    },
+    messages: {
+      unknownValue: '\u041D\u0435\u0438\u0437\u0432\u0435\u0441\u0442\u043D\u043E\u0435 \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u0435 "{{value}}" \u0434\u043B\u044F {{attr}}. \u0414\u043E\u043F\u0443\u0441\u0442\u0438\u043C\u044B\u0435 \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u044F: {{known}}'
+    },
+    schema: [],
+    type: "problem"
+  }
+};
+
+// src/rules/no-useless-fxa-kind.ts
+var SEMANTIC_TAGS_WITH_TYPE = /* @__PURE__ */ new Set([
+  "form",
+  "nav",
+  "header",
+  "footer",
+  "main",
+  "aside",
+  "section",
+  "article",
+  "dialog",
+  "figure",
+  "details"
+]);
+var rule2 = {
+  create(context) {
+    return {
+      JSXOpeningElement(rawNode) {
+        const node = rawNode;
+        const kindAttr = findJSXAttribute(node, "data-fxa-kind");
+        if (!kindAttr) return;
+        const kindNode = kindAttr;
+        const tagName = getJSXElementName(node);
+        if (tagName !== null && SEMANTIC_TAGS_WITH_TYPE.has(tagName)) {
+          context.report({
+            data: { tag: tagName },
+            messageId: "redundantKindOnSemanticTag",
+            node: kindNode
+          });
+        }
+        if (!hasJSXAttribute(node, "data-fxa-path")) {
+          context.report({
+            messageId: "kindWithoutPath",
+            node: kindNode
+          });
+        }
+      }
+    };
+  },
+  meta: {
+    docs: {
+      description: "\u041F\u0440\u0435\u0434\u0443\u043F\u0440\u0435\u0436\u0434\u0430\u0435\u0442 \u043E\u0431 \u0438\u0437\u0431\u044B\u0442\u043E\u0447\u043D\u043E\u043C data-fxa-kind: \u0431\u0435\u0437 data-fxa-path \u0438\u043B\u0438 \u043D\u0430 \u0441\u0435\u043C\u0430\u043D\u0442\u0438\u0447\u0435\u0441\u043A\u043E\u043C \u0442\u0435\u0433\u0435",
+      recommended: true,
+      url: "https://github.com/foxford/frontend-platform"
+    },
+    messages: {
+      kindWithoutPath: "data-fxa-kind \u0431\u0435\u0437 data-fxa-path \u043D\u0430 \u0442\u043E\u043C \u0436\u0435 \u044D\u043B\u0435\u043C\u0435\u043D\u0442\u0435 \u043D\u0435 \u0438\u043C\u0435\u0435\u0442 \u0441\u043C\u044B\u0441\u043B\u0430",
+      redundantKindOnSemanticTag: "\u0418\u0437\u0431\u044B\u0442\u043E\u0447\u043D\u044B\u0439 data-fxa-kind \u043D\u0430 \u0442\u0435\u0433\u0435 <{{tag}}> \u2014 \u0442\u0435\u0433 \u0443\u0436\u0435 \u043F\u0440\u0435\u0434\u043E\u0441\u0442\u0430\u0432\u043B\u044F\u0435\u0442 \u0441\u0435\u043C\u0430\u043D\u0442\u0438\u0447\u0435\u0441\u043A\u0438\u0439 \u0442\u0438\u043F"
+    },
+    schema: [],
+    type: "suggestion"
+  }
+};
+
+// src/rules/registry-freshness.ts
+var MAX_REGISTRY_AGE_MS = 7 * 24 * 60 * 60 * 1e3;
+var REGISTRY_NAMES = ["actions", "kinds", "paths"];
+var freshnessCheckResult = null;
+var rule3 = {
+  create(context) {
+    return {
+      Program(node) {
+        if (!freshnessCheckResult) {
+          const now = Date.now();
+          const stale = [];
+          for (const name of REGISTRY_NAMES) {
+            const mtime = getRegistryMtime(name);
+            if (mtime !== null && now - mtime.getTime() > MAX_REGISTRY_AGE_MS) {
+              stale.push(name);
+            }
+          }
+          freshnessCheckResult = { stale };
+        }
+        if (freshnessCheckResult.stale.length > 0) {
+          context.report({
+            data: { registries: freshnessCheckResult.stale.join(", ") },
+            messageId: "staleRegistry",
+            node
+          });
+        }
+      }
+    };
+  },
+  meta: {
+    docs: {
+      description: "\u041F\u0440\u0435\u0434\u0443\u043F\u0440\u0435\u0436\u0434\u0430\u0435\u0442 \u043F\u0440\u0438 \u0443\u0441\u0442\u0430\u0440\u0435\u0432\u0448\u0438\u0445 \u0440\u0435\u0435\u0441\u0442\u0440\u0430\u0445 data-fxa-* (\u043D\u0435 \u043E\u0431\u043D\u043E\u0432\u043B\u044F\u043B\u0438\u0441\u044C >7 \u0434\u043D\u0435\u0439)",
+      recommended: true,
+      url: "https://github.com/foxford/frontend-platform"
+    },
+    messages: {
+      staleRegistry: "\u0420\u0435\u0435\u0441\u0442\u0440 {{registries}} \u043D\u0435 \u043E\u0431\u043D\u043E\u0432\u043B\u044F\u043B\u0441\u044F \u0431\u043E\u043B\u0435\u0435 7 \u0434\u043D\u0435\u0439. \u041F\u0440\u043E\u0432\u0435\u0440\u044C\u0442\u0435 \u0430\u043A\u0442\u0443\u0430\u043B\u044C\u043D\u043E\u0441\u0442\u044C \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u0439 data-fxa-*."
+    },
+    schema: [],
+    type: "suggestion"
+  }
+};
+
+// src/rules/valid-fxa-combo.ts
+var COMBO_ALLOWED_TAGS = new Set(COMBO_TAG_WHITELIST);
+var rule4 = {
+  create(context) {
+    return {
+      JSXOpeningElement(rawNode) {
+        const node = rawNode;
+        const hasPath = hasJSXAttribute(node, "data-fxa-path");
+        const hasAction = hasJSXAttribute(node, "data-fxa-action");
+        if (!hasPath || !hasAction) return;
+        const tagName = getJSXElementName(node);
+        if (tagName === null) return;
+        if (COMBO_ALLOWED_TAGS.has(tagName)) return;
+        const actionAttr = findJSXAttribute(node, "data-fxa-action");
+        const reportNode = actionAttr ?? rawNode;
+        context.report({
+          data: {
+            allowed: Array.from(COMBO_ALLOWED_TAGS).join(", "),
+            tag: tagName
+          },
+          messageId: "invalidCombo",
+          node: reportNode
+        });
+      }
+    };
+  },
+  meta: {
+    docs: {
+      description: "Combo data-fxa-path + data-fxa-action \u0440\u0430\u0437\u0440\u0435\u0448\u0451\u043D \u0442\u043E\u043B\u044C\u043A\u043E \u043D\u0430 \u0442\u0435\u0433\u0430\u0445: a, form, button, label, summary",
+      recommended: true,
+      url: "https://github.com/foxford/frontend-platform"
+    },
+    messages: {
+      invalidCombo: "Combo data-fxa-path + data-fxa-action \u043D\u0430 \u0442\u0435\u0433\u0435 <{{tag}}> \u043D\u0435\u0434\u043E\u043F\u0443\u0441\u0442\u0438\u043C. \u0420\u0430\u0437\u0440\u0435\u0448\u0451\u043D\u043D\u044B\u0435 \u0442\u0435\u0433\u0438: {{allowed}}"
+    },
+    schema: [],
+    type: "problem"
+  }
+};
+
+// src/rules/valid-fxa-format.ts
+var CHECKED_ATTRIBUTES = ["data-fxa-path", "data-fxa-action", "data-fxa-kind"];
+var FORMAT_REGEX = /^[a-z0-9-]+$/;
+var MAX_LENGTH = 32;
+var rule5 = {
+  create(context) {
+    return {
+      JSXOpeningElement(rawNode) {
+        const node = rawNode;
+        for (const attrName of CHECKED_ATTRIBUTES) {
+          const attr = findJSXAttribute(node, attrName);
+          if (!attr) continue;
+          const value = getJSXAttributeStringValue(attr);
+          if (value === null) continue;
+          const isValid = value.length > 0 && value.length <= MAX_LENGTH && FORMAT_REGEX.test(value);
+          if (!isValid) {
+            const sanitized = sanitizeValue(value);
+            context.report({
+              data: { attr: attrName, value },
+              messageId: "invalidFormat",
+              node: attr,
+              suggest: sanitized ? [
+                {
+                  data: { sanitized },
+                  fix(fixer) {
+                    const attrValue = attr.value;
+                    if (!attrValue) return null;
+                    if (attrValue.type === "Literal") {
+                      return fixer.replaceText(attrValue, `"${sanitized}"`);
+                    }
+                    if (attrValue.type === "JSXExpressionContainer") {
+                      return fixer.replaceText(attrValue, `"${sanitized}"`);
+                    }
+                    return null;
+                  },
+                  messageId: "suggestFix"
+                }
+              ] : []
+            });
+          }
+        }
+      }
+    };
+  },
+  meta: {
+    docs: {
+      description: "\u041F\u0440\u043E\u0432\u0435\u0440\u044F\u0435\u0442 \u0444\u043E\u0440\u043C\u0430\u0442 \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u0439 \u0430\u0442\u0440\u0438\u0431\u0443\u0442\u043E\u0432 data-fxa-* (regex ^[a-z0-9-]+$, \u0434\u043B\u0438\u043D\u0430 \u226432)",
+      recommended: true,
+      url: "https://github.com/foxford/frontend-platform"
+    },
+    hasSuggestions: true,
+    messages: {
+      invalidFormat: '\u0417\u043D\u0430\u0447\u0435\u043D\u0438\u0435 "{{value}}" \u0430\u0442\u0440\u0438\u0431\u0443\u0442\u0430 {{attr}} \u043D\u0435 \u0441\u043E\u043E\u0442\u0432\u0435\u0442\u0441\u0442\u0432\u0443\u0435\u0442 \u0444\u043E\u0440\u043C\u0430\u0442\u0443 ^[a-z0-9-]+$ \u0438\u043B\u0438 \u043F\u0440\u0435\u0432\u044B\u0448\u0430\u0435\u0442 32 \u0441\u0438\u043C\u0432\u043E\u043B\u0430',
+      suggestFix: '\u0417\u0430\u043C\u0435\u043D\u0438\u0442\u044C \u043D\u0430 \u0441\u0430\u043D\u0438\u0442\u0438\u0437\u0438\u0440\u043E\u0432\u0430\u043D\u043D\u043E\u0435 \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u0435 "{{sanitized}}"'
+    },
+    schema: [],
+    type: "problem"
+  }
+};
+
+// package.json
+var package_default = {
+  name: "@foxford/eslint-plugin-analytics",
+  version: "1.0.1",
+  description: "ESLint-\u043F\u043B\u0430\u0433\u0438\u043D \u0434\u043B\u044F \u0432\u0430\u043B\u0438\u0434\u0430\u0446\u0438\u0438 \u0440\u0430\u0437\u043C\u0435\u0442\u043A\u0438 data-fxa-* \u0432 JSX (\u0441\u0438\u0441\u0442\u0435\u043C\u0430 \u0434\u0435\u043A\u043B\u0430\u0440\u0430\u0442\u0438\u0432\u043D\u043E\u0439 \u0430\u043D\u0430\u043B\u0438\u0442\u0438\u043A\u0438 Foxford)",
+  keywords: [
+    "foxford",
+    "eslint-plugin",
+    "analytics",
+    "fxa"
+  ],
+  homepage: "https://github.com/foxford/frontend-platform",
+  bugs: "https://github.com/foxford/frontend-platform/issues",
+  repository: {
+    type: "git",
+    url: "git+https://github.com/foxford/frontend-platform.git",
+    directory: "packages/eslint-plugin-analytics"
+  },
+  license: "MIT",
+  author: "Foxford Co",
+  maintainers: [
+    {
+      name: "Roman Olin",
+      email: "r.v.olin@foxford.ru",
+      team: "core-frontend"
+    }
+  ],
+  main: "src/index.ts",
+  type: "module",
+  exports: {
+    ".": {
+      import: "./src/index.ts",
+      default: "./src/index.ts"
+    }
+  },
+  files: [
+    "build"
+  ],
+  scripts: {
+    "============================ BUILD =============================": "",
+    build: "tsup",
+    "============================ DEPLOY ============================": "",
+    deploy: "fox deploy npm",
+    "deploy:npm": "fox deploy npm --local-dir=build",
+    "============================ LINT ==============================": "",
+    "lint:clean": "rm -f .eslintcache",
+    "lint:type-check": "tsc --noEmit --pretty",
+    "lint:eslint": "eslint --cache --cache-strategy content --max-warnings=0 ./",
+    "============================ TEST ==============================": "",
+    test: "vitest run",
+    "test:watch": "vitest"
+  },
+  dependencies: {
+    "@foxford/analytics-registries": "workspace:*"
+  },
+  peerDependencies: {
+    eslint: ">=8.0.0"
+  },
+  devDependencies: {
+    "@foxford/eslint-config": "workspace:*",
+    "@foxford/prettier-config": "workspace:*",
+    "@foxford/typescript-config": "workspace:*",
+    "@foxford/vitest-config": "workspace:*",
+    "@types/node": "catalog:dev",
+    eslint: "catalog:linter",
+    tsup: "catalog:dev",
+    typescript: "catalog:dev",
+    vitest: "catalog:dev"
+  }
+};
+
+// src/index.ts
+var { version } = package_default;
+var rules = {
+  "known-fxa-value": rule,
+  "no-useless-fxa-kind": rule2,
+  "registry-freshness": rule3,
+  "valid-fxa-combo": rule4,
+  "valid-fxa-format": rule5
+};
+var recommendedConfig = {
+  plugins: {
+    "@foxford/analytics": { rules }
+  },
+  rules: {
+    "@foxford/analytics/known-fxa-value": "error",
+    "@foxford/analytics/no-useless-fxa-kind": "warn",
+    "@foxford/analytics/registry-freshness": "warn",
+    "@foxford/analytics/valid-fxa-combo": "error",
+    "@foxford/analytics/valid-fxa-format": "error"
+  }
+};
+var legacyConfig = {
+  plugins: ["@foxford/analytics"],
+  rules: {
+    "@foxford/analytics/known-fxa-value": "error",
+    "@foxford/analytics/no-useless-fxa-kind": "warn",
+    "@foxford/analytics/registry-freshness": "warn",
+    "@foxford/analytics/valid-fxa-combo": "error",
+    "@foxford/analytics/valid-fxa-format": "error"
+  }
+};
+var plugin = {
+  configs: {
+    legacy: legacyConfig,
+    recommended: recommendedConfig
+  },
+  meta: {
+    name: "@foxford/eslint-plugin-analytics",
+    version
+  },
+  rules
+};
+export {
+  plugin as default,
+  legacyConfig,
+  recommendedConfig,
+  rules
+};

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "@foxford/eslint-plugin-analytics",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.1",
+  "description": "ESLint-плагин для валидации разметки data-fxa-* в JSX (система декларативной аналитики Foxford)",
+  "keywords": [
+    "foxford",
+    "eslint-plugin",
+    "analytics",
+    "fxa"
+  ],
+  "homepage": "https://github.com/foxford/frontend-platform",
+  "bugs": "https://github.com/foxford/frontend-platform/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/foxford/frontend-platform.git",
+    "directory": "packages/eslint-plugin-analytics"
+  },
+  "license": "MIT",
+  "author": "Foxford Co",
+  "maintainers": [
+    {
+      "name": "Roman Olin",
+      "email": "r.v.olin@foxford.ru",
+      "team": "core-frontend"
+    }
+  ],
+  "type": "module",
+  "files": [
+    "*.js",
+    "*.cjs",
+    "*.d.ts",
+    "*.d.cts",
+    "README.mdx"
+  ],
+  "dependencies": {
+    "@foxford/analytics-registries": "1.0.1"
+  },
+  "peerDependencies": {
+    "eslint": ">=8.0.0"
+  },
+  "main": "./index.cjs",
+  "module": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./index.js",
+      "require": "./index.cjs",
+      "types": "./index.d.ts"
+    }
+  },
+  "sha": "6bf9ff8",
+  "scripts": {}
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-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.