@dereekb/util 13.11.18 → 13.12.1

package/eslint/index.esm.js

@@ -268,21 +268,21 @@
     return result;
 }
 
-function _array_like_to_array$d(arr, len) {
+function _array_like_to_array$c(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
 }
-function _array_with_holes$b(arr) {
+function _array_with_holes$a(arr) {
     if (Array.isArray(arr)) return arr;
 }
 function _array_without_holes$4(arr) {
-    if (Array.isArray(arr)) return _array_like_to_array$d(arr);
+    if (Array.isArray(arr)) return _array_like_to_array$c(arr);
 }
 function _iterable_to_array$4(iter) {
     if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
 }
-function _iterable_to_array_limit$b(arr, i) {
+function _iterable_to_array_limit$a(arr, i) {
     var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
     if (_i == null) return;
     var _arr = [];
@@ -306,25 +306,25 @@ function _iterable_to_array_limit$b(arr, i) {
     }
     return _arr;
 }
-function _non_iterable_rest$b() {
+function _non_iterable_rest$a() {
     throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _non_iterable_spread$4() {
     throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
-function _sliced_to_array$b(arr, i) {
-    return _array_with_holes$b(arr) || _iterable_to_array_limit$b(arr, i) || _unsupported_iterable_to_array$d(arr, i) || _non_iterable_rest$b();
+function _sliced_to_array$a(arr, i) {
+    return _array_with_holes$a(arr) || _iterable_to_array_limit$a(arr, i) || _unsupported_iterable_to_array$c(arr, i) || _non_iterable_rest$a();
 }
 function _to_consumable_array$4(arr) {
-    return _array_without_holes$4(arr) || _iterable_to_array$4(arr) || _unsupported_iterable_to_array$d(arr) || _non_iterable_spread$4();
+    return _array_without_holes$4(arr) || _iterable_to_array$4(arr) || _unsupported_iterable_to_array$c(arr) || _non_iterable_spread$4();
 }
-function _unsupported_iterable_to_array$d(o, minLen) {
+function _unsupported_iterable_to_array$c(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$d(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$c(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$d(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$c(o, minLen);
 }
 /**
  * The JSDoc tag identifying a function as a factory in the @dereekb conventions.
@@ -457,7 +457,7 @@ function pickMessageId(hasOverloads, jsdoc) {
             ], "// ".concat(NO_SIDE_EFFECTS_TAG, "\n").concat(indent));
         }
         function buildRedundantRemovalFix(fixer, redundant) {
-            var _redundant_range = _sliced_to_array$b(redundant.range, 2), start = _redundant_range[0], end = _redundant_range[1];
+            var _redundant_range = _sliced_to_array$a(redundant.range, 2), start = _redundant_range[0], end = _redundant_range[1];
             var removeEnd = end;
             while(removeEnd < sourceText.length && (sourceText.charAt(removeEnd) === ' ' || sourceText.charAt(removeEnd) === '\t'))removeEnd += 1;
             if (sourceText.charAt(removeEnd) === '\n') removeEnd += 1;
@@ -525,15 +525,15 @@ function pickMessageId(hasOverloads, jsdoc) {
     }
 };
 
-function _array_like_to_array$c(arr, len) {
+function _array_like_to_array$b(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
 }
-function _array_with_holes$a(arr) {
+function _array_with_holes$9(arr) {
     if (Array.isArray(arr)) return arr;
 }
-function _iterable_to_array_limit$a(arr, i) {
+function _iterable_to_array_limit$9(arr, i) {
     var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
     if (_i == null) return;
     var _arr = [];
@@ -557,19 +557,19 @@ function _iterable_to_array_limit$a(arr, i) {
     }
     return _arr;
 }
-function _non_iterable_rest$a() {
+function _non_iterable_rest$9() {
     throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
-function _sliced_to_array$a(arr, i) {
-    return _array_with_holes$a(arr) || _iterable_to_array_limit$a(arr, i) || _unsupported_iterable_to_array$c(arr, i) || _non_iterable_rest$a();
+function _sliced_to_array$9(arr, i) {
+    return _array_with_holes$9(arr) || _iterable_to_array_limit$9(arr, i) || _unsupported_iterable_to_array$b(arr, i) || _non_iterable_rest$9();
 }
-function _unsupported_iterable_to_array$c(o, minLen) {
+function _unsupported_iterable_to_array$b(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$c(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$b(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$c(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$b(o, minLen);
 }
  var UTIL_PREFER_NO_SIDE_EFFECTS_IN_JSDOC_RULE = {
     meta: {
@@ -663,7 +663,7 @@ function _unsupported_iterable_to_array$c(o, minLen) {
                                     // Remove the orphan line/block comment annotations.
                                     for(var _iterator = orphanLineComments[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
                                         var orphan = _step.value;
-                                        var _orphan_range = _sliced_to_array$a(orphan.range, 2), start = _orphan_range[0], end = _orphan_range[1];
+                                        var _orphan_range = _sliced_to_array$9(orphan.range, 2), start = _orphan_range[0], end = _orphan_range[1];
                                         var removeEnd = end;
                                         while(removeEnd < sourceText.length && (sourceText.charAt(removeEnd) === ' ' || sourceText.charAt(removeEnd) === '\t')){
                                             removeEnd += 1;
@@ -869,15 +869,15 @@ function _templateObject() {
     }
 };
 
-function _array_like_to_array$b(arr, len) {
+function _array_like_to_array$a(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
 }
-function _array_with_holes$9(arr) {
+function _array_with_holes$8(arr) {
     if (Array.isArray(arr)) return arr;
 }
-function _iterable_to_array_limit$9(arr, i) {
+function _iterable_to_array_limit$8(arr, i) {
     var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
     if (_i == null) return;
     var _arr = [];
@@ -901,23 +901,23 @@ function _iterable_to_array_limit$9(arr, i) {
     }
     return _arr;
 }
-function _non_iterable_rest$9() {
+function _non_iterable_rest$8() {
     throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
-function _sliced_to_array$9(arr, i) {
-    return _array_with_holes$9(arr) || _iterable_to_array_limit$9(arr, i) || _unsupported_iterable_to_array$b(arr, i) || _non_iterable_rest$9();
+function _sliced_to_array$8(arr, i) {
+    return _array_with_holes$8(arr) || _iterable_to_array_limit$8(arr, i) || _unsupported_iterable_to_array$a(arr, i) || _non_iterable_rest$8();
 }
-function _type_of(obj) {
+function _type_of$1(obj) {
     "@swc/helpers - typeof";
     return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
 }
-function _unsupported_iterable_to_array$b(o, minLen) {
+function _unsupported_iterable_to_array$a(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$b(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$a(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$b(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$a(o, minLen);
 }
 /**
  * AST node types whose bodies represent a *new* function scope and must be skipped during return-counting.
@@ -967,7 +967,7 @@ function collectFromGuardConsequent(consequent, out) {
     var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
     try {
         for(var _iterator = body.entries()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var _step_value = _sliced_to_array$9(_step.value, 2), i = _step_value[0], stmt = _step_value[1];
+            var _step_value = _sliced_to_array$8(_step.value, 2), i = _step_value[0], stmt = _step_value[1];
             var isLastReturn = i === lastIndex && (stmt === null || stmt === void 0 ? void 0 : stmt.type) === 'ReturnStatement';
             if (!isLastReturn) collectCountedReturns(stmt, out);
         }
@@ -1024,7 +1024,7 @@ function walkChildren(node, out) {
  * @param node - The AST node to traverse.
  * @param out - The accumulator array that receives counted `ReturnStatement` nodes.
  */ function collectCountedReturns(node, out) {
-    if (node === null || (typeof node === "undefined" ? "undefined" : _type_of(node)) !== 'object') return;
+    if (node === null || (typeof node === "undefined" ? "undefined" : _type_of$1(node)) !== 'object') return;
     if (Array.isArray(node)) {
         var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
         try {
@@ -1114,13 +1114,13 @@ function walkChildren(node, out) {
     }
 };
 
-function _array_like_to_array$a(arr, len) {
+function _array_like_to_array$9(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
 }
 function _array_without_holes$3(arr) {
-    if (Array.isArray(arr)) return _array_like_to_array$a(arr);
+    if (Array.isArray(arr)) return _array_like_to_array$9(arr);
 }
 function _iterable_to_array$3(iter) {
     if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
@@ -1129,15 +1129,15 @@ function _non_iterable_spread$3() {
     throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _to_consumable_array$3(arr) {
-    return _array_without_holes$3(arr) || _iterable_to_array$3(arr) || _unsupported_iterable_to_array$a(arr) || _non_iterable_spread$3();
+    return _array_without_holes$3(arr) || _iterable_to_array$3(arr) || _unsupported_iterable_to_array$9(arr) || _non_iterable_spread$3();
 }
-function _unsupported_iterable_to_array$a(o, minLen) {
+function _unsupported_iterable_to_array$9(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$a(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$9(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$a(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$9(o, minLen);
 }
 /**
  * Default name suffixes that mark an interface as config-shaped (its properties should be readonly).
@@ -1858,13 +1858,13 @@ function statementBringsMaybeIntoScope(stmt) {
     }
 };
 
-function _array_like_to_array$9(arr, len) {
+function _array_like_to_array$8(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
 }
 function _array_without_holes$2(arr) {
-    if (Array.isArray(arr)) return _array_like_to_array$9(arr);
+    if (Array.isArray(arr)) return _array_like_to_array$8(arr);
 }
 function _iterable_to_array$2(iter) {
     if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
@@ -1873,15 +1873,19 @@ function _non_iterable_spread$2() {
     throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _to_consumable_array$2(arr) {
-    return _array_without_holes$2(arr) || _iterable_to_array$2(arr) || _unsupported_iterable_to_array$9(arr) || _non_iterable_spread$2();
+    return _array_without_holes$2(arr) || _iterable_to_array$2(arr) || _unsupported_iterable_to_array$8(arr) || _non_iterable_spread$2();
 }
-function _unsupported_iterable_to_array$9(o, minLen) {
+function _type_of(obj) {
+    "@swc/helpers - typeof";
+    return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
+}
+function _unsupported_iterable_to_array$8(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$9(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$8(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$9(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$8(o, minLen);
 }
 /**
  * The required marker line comment that opens the deprecated-aliases section at the bottom of a file.
@@ -2074,30 +2078,104 @@ function _unsupported_iterable_to_array$9(o, minLen) {
     return sourceCode.text.slice(range[0], range[1]);
 }
 /**
- * Returns true when every deprecated statement in `deprecated` appears AFTER every non-deprecated
- * analyzable statement in `analyzable` (i.e., the deprecated section is already at the bottom of
- * the file). This is the condition under which the autofix can simply insert the marker without
- * reordering statements.
+ * Unwraps an `export` statement to the underlying declaration. Returns the node itself when it is
+ * not an export wrapper.
  *
- * @param analyzable - All analyzable top-level statements in source order.
- * @param deprecated - The subset that carry `@deprecated`.
- * @returns True when no non-deprecated statement appears after the first deprecated one.
- */ function allDeprecatedAtBottom(analyzable, deprecated) {
-    var atBottom = true;
-    if (deprecated.length !== 0) {
-        var firstDeprecatedStart = deprecated[0].range[0];
-        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-        try {
-            for(var _iterator = analyzable[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-                var stmt = _step.value;
-                if (stmt.range[0] > firstDeprecatedStart) {
-                    // Statement appears after the first deprecated one. It must itself be deprecated.
-                    var isDeprecated = deprecated.includes(stmt);
-                    if (!isDeprecated) {
-                        atBottom = false;
+ * @param statement - The top-level statement node.
+ * @returns The inner declaration for export wrappers, otherwise the statement itself.
+ */ function unwrapDeclaration(statement) {
+    var declaration = statement;
+    if ((statement.type === 'ExportNamedDeclaration' || statement.type === 'ExportDefaultDeclaration') && statement.declaration != null) {
+        declaration = statement.declaration;
+    }
+    return declaration;
+}
+/**
+ * Recursively collects the binding names introduced by a binding pattern (`Identifier`,
+ * `ObjectPattern`, `ArrayPattern`, including defaults and rest elements).
+ *
+ * @param node - A binding pattern to walk; missing array-pattern holes contribute no names.
+ * @returns The flat list of bound identifier names.
+ */ function collectPatternNames(node) {
+    var names = [];
+    if (node != null) {
+        if (node.type === 'Identifier') {
+            names.push(node.name);
+        } else if (node.type === 'ObjectPattern') {
+            var _node_properties;
+            var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+            try {
+                for(var _iterator = ((_node_properties = node.properties) !== null && _node_properties !== void 0 ? _node_properties : [])[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                    var property = _step.value;
+                    var _names;
+                    (_names = names).push.apply(_names, _to_consumable_array$2(collectPatternNames(property.type === 'RestElement' ? property.argument : property.value)));
+                }
+            } catch (err) {
+                _didIteratorError = true;
+                _iteratorError = err;
+            } finally{
+                try {
+                    if (!_iteratorNormalCompletion && _iterator.return != null) {
+                        _iterator.return();
+                    }
+                } finally{
+                    if (_didIteratorError) {
+                        throw _iteratorError;
+                    }
+                }
+            }
+        } else if (node.type === 'ArrayPattern') {
+            var _node_elements;
+            var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+            try {
+                for(var _iterator1 = ((_node_elements = node.elements) !== null && _node_elements !== void 0 ? _node_elements : [])[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                    var element = _step1.value;
+                    var _names1;
+                    (_names1 = names).push.apply(_names1, _to_consumable_array$2(collectPatternNames((element === null || element === void 0 ? void 0 : element.type) === 'RestElement' ? element.argument : element)));
+                }
+            } catch (err) {
+                _didIteratorError1 = true;
+                _iteratorError1 = err;
+            } finally{
+                try {
+                    if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                        _iterator1.return();
+                    }
+                } finally{
+                    if (_didIteratorError1) {
+                        throw _iteratorError1;
                     }
                 }
             }
+        } else if (node.type === 'AssignmentPattern') {
+            var _names2;
+            (_names2 = names).push.apply(_names2, _to_consumable_array$2(collectPatternNames(node.left)));
+        } else if (node.type === 'RestElement') {
+            var _names3;
+            (_names3 = names).push.apply(_names3, _to_consumable_array$2(collectPatternNames(node.argument)));
+        }
+    }
+    return names;
+}
+/**
+ * Returns the binding names a top-level statement introduces: variable declarator ids, an
+ * import's local specifier names, or a function/class/interface/type/enum declaration id.
+ *
+ * @param statement - The top-level statement node.
+ * @returns The names bound by the statement.
+ */ function getDeclaredBindingNames(statement) {
+    var _declaration_id;
+    var names = [];
+    var declaration = unwrapDeclaration(statement);
+    if (declaration.type === 'VariableDeclaration') {
+        var _declaration_declarations;
+        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+        try {
+            for(var _iterator = ((_declaration_declarations = declaration.declarations) !== null && _declaration_declarations !== void 0 ? _declaration_declarations : [])[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                var declarator = _step.value;
+                var _names;
+                (_names = names).push.apply(_names, _to_consumable_array$2(collectPatternNames(declarator.id)));
+            }
         } catch (err) {
             _didIteratorError = true;
             _iteratorError = err;
@@ -2112,43 +2190,82 @@ function _unsupported_iterable_to_array$9(o, minLen) {
                 }
             }
         }
+    } else if (declaration.type === 'ImportDeclaration') {
+        var _declaration_specifiers;
+        var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+        try {
+            for(var _iterator1 = ((_declaration_specifiers = declaration.specifiers) !== null && _declaration_specifiers !== void 0 ? _declaration_specifiers : [])[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                var specifier = _step1.value;
+                var _specifier_local;
+                if (typeof ((_specifier_local = specifier.local) === null || _specifier_local === void 0 ? void 0 : _specifier_local.name) === 'string') {
+                    names.push(specifier.local.name);
+                }
+            }
+        } catch (err) {
+            _didIteratorError1 = true;
+            _iteratorError1 = err;
+        } finally{
+            try {
+                if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                    _iterator1.return();
+                }
+            } finally{
+                if (_didIteratorError1) {
+                    throw _iteratorError1;
+                }
+            }
+        }
+    } else if (((_declaration_id = declaration.id) === null || _declaration_id === void 0 ? void 0 : _declaration_id.type) === 'Identifier') {
+        names.push(declaration.id.name);
     }
-    return atBottom;
+    return names;
 }
 /**
- * Builds the fix for the marker-only case where every deprecated statement already sits at the
- * bottom of the file: insert the marker line immediately above the first deprecated block.
+ * Returns true for AST-walk keys that must not be descended into: the `parent` back-reference
+ * (which would escape the subtree) and the `loc`/`range` position metadata.
  *
- * @param sourceCode - The ESLint `SourceCode` instance.
- * @param firstDeprecated - The first deprecated statement (the insertion anchor).
- * @returns A fix function that inserts the marker comment.
- */ function buildMarkerOnlyFix(sourceCode, firstDeprecated) {
-    var blockRange = getStatementBlockRange(sourceCode, firstDeprecated);
-    var insertionPoint = blockRange[0];
-    return function(fixer) {
-        return fixer.replaceTextRange([
-            insertionPoint,
-            insertionPoint
-        ], "".concat(COMPAT_MARKER_LINE, "\n"));
-    };
+ * @param key - The property key being considered for traversal.
+ * @returns True when the key should be skipped.
+ */ function isIdentifierWalkSkipKey(key) {
+    return key === 'parent' || key === 'loc' || key === 'range';
 }
 /**
- * Builds the fix for the interleaved case: cut every deprecated block out of the file and re-emit
- * them in source order at EOF, preceded by the marker.
+ * Collects every `Identifier` name reachable from an AST record (a node with a string `type`),
+ * recursing into its child nodes while skipping the keys flagged by {@link isIdentifierWalkSkipKey}.
  *
- * @param sourceCode - The ESLint `SourceCode` instance.
- * @param deprecatedStatements - Deprecated statements in source order.
- * @returns A fix function that removes and re-appends each deprecated block.
- */ function buildInterleavedFix(sourceCode, deprecatedStatements) {
-    var blockRanges = [];
-    var blockTexts = [];
+ * @param record - An AST node, keyed by its properties.
+ * @returns The set of identifier names found within the node.
+ */ function collectIdentifierNamesFromRecord(record) {
+    var names = new Set();
+    if (record.type === 'Identifier' && typeof record.name === 'string') {
+        names.add(record.name);
+    }
     var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
     try {
-        for(var _iterator = deprecatedStatements[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var stmt = _step.value;
-            var range = getStatementBlockRange(sourceCode, stmt);
-            blockRanges.push(range);
-            blockTexts.push(readRange(sourceCode, range));
+        for(var _iterator = Object.keys(record)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var key = _step.value;
+            if (!isIdentifierWalkSkipKey(key)) {
+                var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+                try {
+                    for(var _iterator1 = collectIdentifierNames(record[key])[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                        var name = _step1.value;
+                        names.add(name);
+                    }
+                } catch (err) {
+                    _didIteratorError1 = true;
+                    _iteratorError1 = err;
+                } finally{
+                    try {
+                        if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                            _iterator1.return();
+                        }
+                    } finally{
+                        if (_didIteratorError1) {
+                            throw _iteratorError1;
+                        }
+                    }
+                }
+            }
         }
     } catch (err) {
         _didIteratorError = true;
@@ -2164,132 +2281,271 @@ function _unsupported_iterable_to_array$9(o, minLen) {
             }
         }
     }
-    var sourceText = sourceCode.text;
-    var eof = sourceText.length;
-    var trailingNewline = sourceText.endsWith('\n') ? '' : '\n';
-    // Strip trailing newline from each block to control spacing precisely, then re-add a single
-    // newline between blocks. Final block lands without a trailing newline; an explicit `\n` at
-    // the end keeps EOF tidy.
-    var joinedBlocks = blockTexts.map(function(t) {
-        return t.replace(/\n+$/, '');
-    }).join('\n\n');
-    var appendText = "".concat(trailingNewline, "\n").concat(COMPAT_MARKER_LINE, "\n").concat(joinedBlocks, "\n");
-    return function(fixer) {
-        return _to_consumable_array$2(blockRanges.map(function(r) {
-            return fixer.removeRange(r);
-        })).concat([
-            fixer.insertTextAfterRange([
-                eof,
-                eof
-            ], appendText)
-        ]);
-    };
+    return names;
 }
 /**
- * Reports the `missingCompatMarker` violation, choosing between the marker-only and interleaved
- * fix strategies based on whether the deprecated tail is already at the bottom of the file.
+ * Recursively collects every `Identifier` name reachable from a value, staying within the subtree.
  *
- * @param args - Inputs grouped as a single config object.
- * @param args.context - The ESLint rule context.
- * @param args.sourceCode - The ESLint `SourceCode` instance.
- * @param args.analyzable - All analyzable top-level statements in source order.
- * @param args.deprecatedStatements - The subset that carry `@deprecated`.
- */ function reportMissingMarker(args) {
-    var context = args.context, sourceCode = args.sourceCode, analyzable = args.analyzable, deprecatedStatements = args.deprecatedStatements;
-    var firstDeprecated = deprecatedStatements[0];
-    var fixFn = allDeprecatedAtBottom(analyzable, deprecatedStatements) ? buildMarkerOnlyFix(sourceCode, firstDeprecated) : buildInterleavedFix(sourceCode, deprecatedStatements);
-    context.report({
-        node: firstDeprecated,
-        messageId: 'missingCompatMarker',
-        fix: fixFn
-    });
+ * Used both for the value-alias check (over a declarator `init`) and the reverse-reference safety
+ * net (over a whole statement). Over-collection is acceptable for both callers: it only makes the
+ * safety net more conservative and the alias check more permissive toward genuine aliases.
+ *
+ * @param node - The subtree root to scan (an AST node, an array of nodes, or a leaf value).
+ * @returns The set of identifier names found in the subtree.
+ */ function collectIdentifierNames(node) {
+    var names = new Set();
+    if (Array.isArray(node)) {
+        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+        try {
+            for(var _iterator = node[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                var item = _step.value;
+                var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+                try {
+                    for(var _iterator1 = collectIdentifierNames(item)[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                        var name = _step1.value;
+                        names.add(name);
+                    }
+                } catch (err) {
+                    _didIteratorError1 = true;
+                    _iteratorError1 = err;
+                } finally{
+                    try {
+                        if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                            _iterator1.return();
+                        }
+                    } finally{
+                        if (_didIteratorError1) {
+                            throw _iteratorError1;
+                        }
+                    }
+                }
+            }
+        } catch (err) {
+            _didIteratorError = true;
+            _iteratorError = err;
+        } finally{
+            try {
+                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                    _iterator.return();
+                }
+            } finally{
+                if (_didIteratorError) {
+                    throw _iteratorError;
+                }
+            }
+        }
+    } else if (node != null && (typeof node === "undefined" ? "undefined" : _type_of(node)) === 'object' && typeof node.type === 'string') {
+        names = collectIdentifierNamesFromRecord(node);
+    }
+    return names;
 }
 /**
- * Builds the fix that moves a deprecated block sitting above the marker to immediately after the
- * marker comment.
+ * Builds a map of every top-level binding name in the file to whether its declaration carries an
+ * `@deprecated` tag. A name declared more than once is considered non-deprecated when any of its
+ * declarations is non-deprecated.
  *
  * @param sourceCode - The ESLint `SourceCode` instance.
- * @param stmt - The misplaced deprecated statement.
- * @param marker - Marker comment node (when available) plus its start offset (fallback).
- * @returns A fix function that relocates the block below the marker.
- */ function buildMoveDeprecatedFix(sourceCode, stmt, marker) {
-    var blockRange = getStatementBlockRange(sourceCode, stmt);
-    var blockText = readRange(sourceCode, blockRange);
-    var markerEnd = marker.comment === undefined ? marker.offset : marker.comment.range[1];
-    return function(fixer) {
-        return [
-            // Remove from current location.
-            fixer.removeRange(blockRange),
-            // Insert after the marker comment, preceded by a newline so it lands on a new line.
-            fixer.insertTextAfterRange([
-                markerEnd,
-                markerEnd
-            ], "\n".concat(blockText.replace(/\n$/, '')))
-        ];
-    };
+ * @param body - All top-level program-body statements.
+ * @returns Whether each top-level binding name is declared as `@deprecated`, keyed by that name.
+ */ function buildBindingDeprecationMap(sourceCode, body) {
+    var bindingDeprecation = new Map();
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = body[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var statement = _step.value;
+            var deprecated = statementIsDeprecated(sourceCode, statement);
+            var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+            try {
+                for(var _iterator1 = getDeclaredBindingNames(statement)[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                    var name = _step1.value;
+                    var existing = bindingDeprecation.get(name);
+                    bindingDeprecation.set(name, existing === undefined ? deprecated : existing && deprecated);
+                }
+            } catch (err) {
+                _didIteratorError1 = true;
+                _iteratorError1 = err;
+            } finally{
+                try {
+                    if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                        _iterator1.return();
+                    }
+                } finally{
+                    if (_didIteratorError1) {
+                        throw _iteratorError1;
+                    }
+                }
+            }
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    return bindingDeprecation;
 }
 /**
- * Builds the fix that moves a non-deprecated block sitting below the marker to immediately before
- * the marker comment.
+ * Returns true when a `@deprecated` statement is a runtime *value alias* — a `VariableDeclaration`
+ * whose initializer references a non-deprecated binding declared elsewhere in the file (or an
+ * imported name). Literal-only initializers (`= 'SPED'`, `= 5`, object/array literals with no
+ * variable references) are primary definitions, not aliases, and return false.
  *
  * @param sourceCode - The ESLint `SourceCode` instance.
- * @param stmt - The misplaced non-deprecated statement.
- * @param marker - Marker comment node (when available) plus its start offset (fallback).
- * @returns A fix function that relocates the block above the marker.
- */ function buildMoveNonDeprecatedFix(sourceCode, stmt, marker) {
-    var blockRange = getStatementBlockRange(sourceCode, stmt);
-    var blockText = readRange(sourceCode, blockRange);
-    var markerStart = marker.comment === undefined ? marker.offset : marker.comment.range[0];
-    return function(fixer) {
-        return [
-            fixer.removeRange(blockRange),
-            // Insert just before the marker; keep the block's trailing newline and add one more so a
-            // blank line separates the moved block from the marker.
-            fixer.replaceTextRange([
-                markerStart,
-                markerStart
-            ], "".concat(blockText, "\n"))
-        ];
-    };
+ * @param statement - The top-level statement node.
+ * @param bindingDeprecation - Map of top-level binding name to deprecation flag.
+ * @returns True when the statement is a deprecated value alias.
+ */ function statementIsValueAlias(sourceCode, statement, bindingDeprecation) {
+    var isAlias = false;
+    var declaration = unwrapDeclaration(statement);
+    if (statementIsDeprecated(sourceCode, statement) && declaration.type === 'VariableDeclaration') {
+        var _declaration_declarations;
+        var ownNames = new Set(getDeclaredBindingNames(statement));
+        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+        try {
+            for(var _iterator = ((_declaration_declarations = declaration.declarations) !== null && _declaration_declarations !== void 0 ? _declaration_declarations : [])[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                var declarator = _step.value;
+                var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+                try {
+                    for(var _iterator1 = collectIdentifierNames(declarator.init)[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                        var name = _step1.value;
+                        if (!ownNames.has(name) && bindingDeprecation.get(name) === false) {
+                            isAlias = true;
+                        }
+                    }
+                } catch (err) {
+                    _didIteratorError1 = true;
+                    _iteratorError1 = err;
+                } finally{
+                    try {
+                        if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                            _iterator1.return();
+                        }
+                    } finally{
+                        if (_didIteratorError1) {
+                            throw _iteratorError1;
+                        }
+                    }
+                }
+            }
+        } catch (err) {
+            _didIteratorError = true;
+            _iteratorError = err;
+        } finally{
+            try {
+                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                    _iterator.return();
+                }
+            } finally{
+                if (_didIteratorError) {
+                    throw _iteratorError;
+                }
+            }
+        }
+    }
+    return isAlias;
 }
 /**
- * Reports the first misplaced deprecated block (above the marker) and the first misplaced
- * non-deprecated block (below the marker). At most one of each is reported per pass; ESLint's
- * autofix loop converges across multiple violations.
+ * Safety net for runtime value aliases: returns true when any name bound by `statement` is
+ * referenced by some *other* top-level statement in the file. Relocating such a value below those
+ * references would introduce a use-before-declaration / temporal-dead-zone error, so a referenced
+ * alias must stay in place.
  *
- * @param args - Inputs grouped as a single config object.
- * @param args.context - The ESLint rule context.
- * @param args.sourceCode - The ESLint `SourceCode` instance.
- * @param args.analyzable - All analyzable top-level statements in source order.
- * @param args.markerOffset - The marker comment's start offset.
- */ function reportMisplacedStatements(args) {
-    var context = args.context, sourceCode = args.sourceCode, analyzable = args.analyzable, markerOffset = args.markerOffset;
-    var marker = {
-        comment: findCompatMarkerComment(sourceCode),
-        offset: markerOffset
-    };
-    var reportedAliasAboveMarker = false;
-    var reportedNonDeprecatedBelowMarker = false;
+ * @param names - The names bound by the candidate statement.
+ * @param statement - The candidate statement (excluded from the scan).
+ * @param body - All top-level program-body statements.
+ * @returns True when another statement references one of `names`.
+ */ function isReferencedByOtherStatements(names, statement, body) {
+    var referenced = false;
+    if (names.length !== 0) {
+        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+        try {
+            for(var _iterator = body[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                var other = _step.value;
+                if (other !== statement) {
+                    var otherNames = collectIdentifierNames(other);
+                    var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+                    try {
+                        for(var _iterator1 = names[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                            var name = _step1.value;
+                            if (otherNames.has(name)) {
+                                referenced = true;
+                            }
+                        }
+                    } catch (err) {
+                        _didIteratorError1 = true;
+                        _iteratorError1 = err;
+                    } finally{
+                        try {
+                            if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                                _iterator1.return();
+                            }
+                        } finally{
+                            if (_didIteratorError1) {
+                                throw _iteratorError1;
+                            }
+                        }
+                    }
+                }
+            }
+        } catch (err) {
+            _didIteratorError = true;
+            _iteratorError = err;
+        } finally{
+            try {
+                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                    _iterator.return();
+                }
+            } finally{
+                if (_didIteratorError) {
+                    throw _iteratorError;
+                }
+            }
+        }
+    }
+    return referenced;
+}
+/**
+ * Collects the analyzable statements the rule may relocate to the `// COMPAT: Deprecated aliases`
+ * section.
+ *
+ * A `@deprecated` statement is movable when it is a type-only declaration (`TSTypeAliasDeclaration`
+ * or `TSInterfaceDeclaration`), which is erased at runtime and can never cause a
+ * use-before-declaration error, or a runtime value alias (see {@link statementIsValueAlias}) that
+ * is not referenced by any other statement in the file (see {@link isReferencedByOtherStatements}).
+ *
+ * Primary runtime definitions — literal-valued consts, functions, classes, enums — are never
+ * movable; they stay exactly where they are so the autofix cannot reorder a value below its uses.
+ *
+ * @param sourceCode - The ESLint `SourceCode` instance.
+ * @param body - All top-level program-body statements.
+ * @param analyzable - The analyzable subset of `body` in source order.
+ * @returns The movable statements in source order.
+ */ function computeMovableStatements(sourceCode, body, analyzable) {
+    var bindingDeprecation = buildBindingDeprecationMap(sourceCode, body);
+    var movable = [];
     var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
     try {
         for(var _iterator = analyzable[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var stmt = _step.value;
-            var isAfterMarker = stmt.range[0] > markerOffset;
-            var isDeprecated = statementIsDeprecated(sourceCode, stmt);
-            if (isDeprecated && !isAfterMarker && !reportedAliasAboveMarker) {
-                context.report({
-                    node: stmt,
-                    messageId: 'deprecatedAliasNotAtBottom',
-                    fix: buildMoveDeprecatedFix(sourceCode, stmt, marker)
-                });
-                reportedAliasAboveMarker = true;
-            } else if (!isDeprecated && isAfterMarker && !reportedNonDeprecatedBelowMarker) {
-                context.report({
-                    node: stmt,
-                    messageId: 'nonDeprecatedAfterMarker',
-                    fix: buildMoveNonDeprecatedFix(sourceCode, stmt, marker)
-                });
-                reportedNonDeprecatedBelowMarker = true;
+            var statement = _step.value;
+            if (statementIsDeprecated(sourceCode, statement)) {
+                var declaration = unwrapDeclaration(statement);
+                var isMovable = false;
+                if (declaration.type === 'TSTypeAliasDeclaration' || declaration.type === 'TSInterfaceDeclaration') {
+                    isMovable = true;
+                } else if (statementIsValueAlias(sourceCode, statement, bindingDeprecation)) {
+                    isMovable = !isReferencedByOtherStatements(getDeclaredBindingNames(statement), statement, body);
+                }
+                if (isMovable) {
+                    movable.push(statement);
+                }
             }
         }
     } catch (err) {
@@ -2306,23 +2562,84 @@ function _unsupported_iterable_to_array$9(o, minLen) {
             }
         }
     }
+    return movable;
 }
 /**
- * Collects all analyzable top-level statements that carry an `@deprecated` JSDoc tag, preserving
- * source order.
+ * Returns true when every movable statement in `movable` appears AFTER every non-movable analyzable
+ * statement in `analyzable` (i.e., the deprecated-alias section is already at the bottom of the
+ * file). This is the condition under which the autofix can simply insert the marker without
+ * reordering statements.
  *
- * @param sourceCode - The ESLint `SourceCode` instance.
  * @param analyzable - All analyzable top-level statements in source order.
- * @returns The deprecated subset of `analyzable`.
- */ function collectDeprecatedStatements(sourceCode, analyzable) {
-    var deprecatedStatements = [];
+ * @param movable - The movable subset (relocatable deprecated aliases).
+ * @returns True when no non-movable statement appears after the first movable one.
+ */ function allMovableStatementsAtBottom(analyzable, movable) {
+    var atBottom = true;
+    if (movable.length !== 0) {
+        var firstMovableStart = movable[0].range[0];
+        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+        try {
+            for(var _iterator = analyzable[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                var stmt = _step.value;
+                if (stmt.range[0] > firstMovableStart) {
+                    // Statement appears after the first movable one. It must itself be movable.
+                    var isMovable = movable.includes(stmt);
+                    if (!isMovable) {
+                        atBottom = false;
+                    }
+                }
+            }
+        } catch (err) {
+            _didIteratorError = true;
+            _iteratorError = err;
+        } finally{
+            try {
+                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                    _iterator.return();
+                }
+            } finally{
+                if (_didIteratorError) {
+                    throw _iteratorError;
+                }
+            }
+        }
+    }
+    return atBottom;
+}
+/**
+ * Builds the fix for the marker-only case where every deprecated statement already sits at the
+ * bottom of the file: insert the marker line immediately above the first deprecated block.
+ *
+ * @param sourceCode - The ESLint `SourceCode` instance.
+ * @param firstDeprecated - The first deprecated statement (the insertion anchor).
+ * @returns A fix function that inserts the marker comment.
+ */ function buildMarkerOnlyFix(sourceCode, firstDeprecated) {
+    var blockRange = getStatementBlockRange(sourceCode, firstDeprecated);
+    var insertionPoint = blockRange[0];
+    return function(fixer) {
+        return fixer.replaceTextRange([
+            insertionPoint,
+            insertionPoint
+        ], "".concat(COMPAT_MARKER_LINE, "\n"));
+    };
+}
+/**
+ * Builds the fix for the interleaved case: cut every movable block out of the file and re-emit
+ * them in source order at EOF, preceded by the marker.
+ *
+ * @param sourceCode - The ESLint `SourceCode` instance.
+ * @param movableStatements - Movable deprecated-alias statements in source order.
+ * @returns A fix function that removes and re-appends each movable block.
+ */ function buildInterleavedFix(sourceCode, movableStatements) {
+    var blockRanges = [];
+    var blockTexts = [];
     var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
     try {
-        for(var _iterator = analyzable[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+        for(var _iterator = movableStatements[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
             var stmt = _step.value;
-            if (statementIsDeprecated(sourceCode, stmt)) {
-                deprecatedStatements.push(stmt);
-            }
+            var range = getStatementBlockRange(sourceCode, stmt);
+            blockRanges.push(range);
+            blockTexts.push(readRange(sourceCode, range));
         }
     } catch (err) {
         _didIteratorError = true;
@@ -2338,30 +2655,184 @@ function _unsupported_iterable_to_array$9(o, minLen) {
             }
         }
     }
-    return deprecatedStatements;
+    var sourceText = sourceCode.text;
+    var eof = sourceText.length;
+    var trailingNewline = sourceText.endsWith('\n') ? '' : '\n';
+    // Strip trailing newline from each block to control spacing precisely, then re-add a single
+    // newline between blocks. Final block lands without a trailing newline; an explicit `\n` at
+    // the end keeps EOF tidy.
+    var joinedBlocks = blockTexts.map(function(t) {
+        return t.replace(/\n+$/, '');
+    }).join('\n\n');
+    var appendText = "".concat(trailingNewline, "\n").concat(COMPAT_MARKER_LINE, "\n").concat(joinedBlocks, "\n");
+    return function(fixer) {
+        return _to_consumable_array$2(blockRanges.map(function(r) {
+            return fixer.removeRange(r);
+        })).concat([
+            fixer.insertTextAfterRange([
+                eof,
+                eof
+            ], appendText)
+        ]);
+    };
 }
 /**
- * ESLint rule requiring that exports carrying a `@deprecated` JSDoc tag live at the bottom of the
- * file under a `// COMPAT: Deprecated aliases` line comment, and that no non-deprecated exports
- * follow the marker. The rule mirrors the workspace's "Deprecated Alias Placement" convention so
- * that deprecated aliases stay segregated from current code and are easy to spot for removal.
- *
- * The rule reports at most one violation per concern (missing marker, alias above marker,
- * non-deprecated below marker) to keep editor noise manageable; once the first violation in a
- * category is fixed, re-linting will surface the next one.
+ * Reports the `missingCompatMarker` violation, choosing between the marker-only and interleaved
+ * fix strategies based on whether the movable tail is already at the bottom of the file.
  *
- * Autofix coverage:
- *   - `missingCompatMarker` — inserts `// COMPAT: Deprecated aliases` and consolidates all
- *     deprecated blocks at the bottom of the file. When the deprecated tail is already at the
- *     bottom of the file, only the marker line is inserted (no statements are moved). When
- *     deprecated exports are interleaved with non-deprecated ones, the autofix removes each
- *     deprecated block from its current location and re-emits them in source order at the bottom
- *     of the file under the marker.
- *   - `deprecatedAliasNotAtBottom` — moves the misplaced deprecated block from above the marker to
- *     just after the marker. One block per pass; ESLint's autofix loop converges across multiple
- *     violations.
- *   - `nonDeprecatedAfterMarker` — moves the misplaced non-deprecated block from below the marker
- *     to just before the marker. One block per pass.
+ * @param args - Inputs grouped as a single config object.
+ * @param args.context - The ESLint rule context.
+ * @param args.sourceCode - The ESLint `SourceCode` instance.
+ * @param args.analyzable - All analyzable top-level statements in source order.
+ * @param args.movableStatements - The movable (relocatable deprecated-alias) subset.
+ */ function reportMissingMarker(args) {
+    var context = args.context, sourceCode = args.sourceCode, analyzable = args.analyzable, movableStatements = args.movableStatements;
+    var firstMovable = movableStatements[0];
+    var fixFn = allMovableStatementsAtBottom(analyzable, movableStatements) ? buildMarkerOnlyFix(sourceCode, firstMovable) : buildInterleavedFix(sourceCode, movableStatements);
+    context.report({
+        node: firstMovable,
+        messageId: 'missingCompatMarker',
+        fix: fixFn
+    });
+}
+/**
+ * Builds the fix that moves a deprecated block sitting above the marker to immediately after the
+ * marker comment.
+ *
+ * @param sourceCode - The ESLint `SourceCode` instance.
+ * @param stmt - The misplaced deprecated statement.
+ * @param marker - Marker comment node (when available) plus its start offset (fallback).
+ * @returns A fix function that relocates the block below the marker.
+ */ function buildMoveDeprecatedFix(sourceCode, stmt, marker) {
+    var blockRange = getStatementBlockRange(sourceCode, stmt);
+    var blockText = readRange(sourceCode, blockRange);
+    var markerEnd = marker.comment === undefined ? marker.offset : marker.comment.range[1];
+    return function(fixer) {
+        return [
+            // Remove from current location.
+            fixer.removeRange(blockRange),
+            // Insert after the marker comment, preceded by a newline so it lands on a new line.
+            fixer.insertTextAfterRange([
+                markerEnd,
+                markerEnd
+            ], "\n".concat(blockText.replace(/\n$/, '')))
+        ];
+    };
+}
+/**
+ * Builds the fix that moves a non-deprecated block sitting below the marker to immediately before
+ * the marker comment.
+ *
+ * @param sourceCode - The ESLint `SourceCode` instance.
+ * @param stmt - The misplaced non-deprecated statement.
+ * @param marker - Marker comment node (when available) plus its start offset (fallback).
+ * @returns A fix function that relocates the block above the marker.
+ */ function buildMoveNonDeprecatedFix(sourceCode, stmt, marker) {
+    var blockRange = getStatementBlockRange(sourceCode, stmt);
+    var blockText = readRange(sourceCode, blockRange);
+    var markerStart = marker.comment === undefined ? marker.offset : marker.comment.range[0];
+    return function(fixer) {
+        return [
+            fixer.removeRange(blockRange),
+            // Insert just before the marker; keep the block's trailing newline and add one more so a
+            // blank line separates the moved block from the marker.
+            fixer.replaceTextRange([
+                markerStart,
+                markerStart
+            ], "".concat(blockText, "\n"))
+        ];
+    };
+}
+/**
+ * Reports the first misplaced movable alias (above the marker) and the first misplaced
+ * non-deprecated block (below the marker). At most one of each is reported per pass; ESLint's
+ * autofix loop converges across multiple violations.
+ *
+ * Only movable statements are pulled down below the marker; only statements that are not
+ * `@deprecated` at all are pushed up above it. A deprecated-but-not-movable statement (a primary
+ * definition such as a literal-valued const) sitting below an existing marker is left in place, so
+ * files that already carry a marker are not re-churned.
+ *
+ * @param args - Inputs grouped as a single config object.
+ * @param args.context - The ESLint rule context.
+ * @param args.sourceCode - The ESLint `SourceCode` instance.
+ * @param args.analyzable - All analyzable top-level statements in source order.
+ * @param args.markerOffset - The marker comment's start offset.
+ * @param args.movableSet - The set of movable (relocatable deprecated-alias) statements.
+ */ function reportMisplacedStatements(args) {
+    var context = args.context, sourceCode = args.sourceCode, analyzable = args.analyzable, markerOffset = args.markerOffset, movableSet = args.movableSet;
+    var marker = {
+        comment: findCompatMarkerComment(sourceCode),
+        offset: markerOffset
+    };
+    var reportedAliasAboveMarker = false;
+    var reportedNonDeprecatedBelowMarker = false;
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = analyzable[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var stmt = _step.value;
+            var isAfterMarker = stmt.range[0] > markerOffset;
+            var isMovable = movableSet.has(stmt);
+            var isDeprecated = statementIsDeprecated(sourceCode, stmt);
+            if (isMovable && !isAfterMarker && !reportedAliasAboveMarker) {
+                context.report({
+                    node: stmt,
+                    messageId: 'deprecatedAliasNotAtBottom',
+                    fix: buildMoveDeprecatedFix(sourceCode, stmt, marker)
+                });
+                reportedAliasAboveMarker = true;
+            } else if (!isDeprecated && isAfterMarker && !reportedNonDeprecatedBelowMarker) {
+                context.report({
+                    node: stmt,
+                    messageId: 'nonDeprecatedAfterMarker',
+                    fix: buildMoveNonDeprecatedFix(sourceCode, stmt, marker)
+                });
+                reportedNonDeprecatedBelowMarker = true;
+            }
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+}
+/**
+ * ESLint rule requiring that `@deprecated` *aliases* live at the bottom of the file under a
+ * `// COMPAT: Deprecated aliases` line comment, and that no non-deprecated exports follow the
+ * marker. The rule mirrors the workspace's "Deprecated Alias Placement" convention so that
+ * deprecated aliases stay segregated from current code and are easy to spot for removal.
+ *
+ * Only *relocatable* deprecated statements participate (see {@link computeMovableStatements}):
+ * type-only declarations (always runtime-safe to move) and runtime value aliases — a
+ * `VariableDeclaration` whose initializer references a non-deprecated binding — that are not
+ * referenced elsewhere in the file. Primary runtime definitions (literal-valued consts, functions,
+ * classes, enums) and any value still referenced by other code are left exactly where they are, so
+ * the autofix can never reorder a value below its uses (a use-before-declaration error).
+ *
+ * The rule reports at most one violation per concern (missing marker, alias above marker,
+ * non-deprecated below marker) to keep editor noise manageable; once the first violation in a
+ * category is fixed, re-linting will surface the next one.
+ *
+ * Autofix coverage:
+ *   - `missingCompatMarker` — inserts `// COMPAT: Deprecated aliases` and consolidates all movable
+ *     blocks at the bottom of the file. When the movable tail is already at the bottom of the file,
+ *     only the marker line is inserted (no statements are moved). When movable aliases are
+ *     interleaved with other statements, the autofix removes each movable block from its current
+ *     location and re-emits them in source order at the bottom of the file under the marker.
+ *   - `deprecatedAliasNotAtBottom` — moves the misplaced movable block from above the marker to
+ *     just after the marker. One block per pass; ESLint's autofix loop converges across multiple
+ *     violations.
+ *   - `nonDeprecatedAfterMarker` — moves the misplaced non-deprecated block from below the marker
+ *     to just before the marker. One block per pass.
  *
  * @see `dbx__note__typescript-programming` → Deprecated Alias Placement
  */ var UTIL_REQUIRE_DEPRECATED_ALIAS_PLACEMENT_RULE = {
@@ -2369,12 +2840,12 @@ function _unsupported_iterable_to_array$9(o, minLen) {
         type: 'suggestion',
         fixable: 'code',
         docs: {
-            description: 'Require @deprecated exports to live at the bottom of the file under a // COMPAT: Deprecated aliases marker.',
+            description: 'Require @deprecated aliases to live at the bottom of the file under a // COMPAT: Deprecated aliases marker.',
             recommended: true
         },
         messages: {
-            missingCompatMarker: "File contains @deprecated exports but is missing the '// COMPAT: Deprecated aliases' marker line comment. Add the marker and move all @deprecated exports below it.",
-            deprecatedAliasNotAtBottom: "This @deprecated export should live below the '// COMPAT: Deprecated aliases' marker at the bottom of the file.",
+            missingCompatMarker: "File contains @deprecated aliases but is missing the '// COMPAT: Deprecated aliases' marker line comment. Add the marker and move the @deprecated aliases below it.",
+            deprecatedAliasNotAtBottom: "This @deprecated alias should live below the '// COMPAT: Deprecated aliases' marker at the bottom of the file.",
             nonDeprecatedAfterMarker: "This export is not @deprecated but appears after the '// COMPAT: Deprecated aliases' marker. Move it above the marker."
         },
         schema: []
@@ -2385,8 +2856,8 @@ function _unsupported_iterable_to_array$9(o, minLen) {
             var _programNode_body;
             var body = (_programNode_body = programNode.body) !== null && _programNode_body !== void 0 ? _programNode_body : [];
             var analyzable = body.filter(isAnalyzableExportLike);
-            var deprecatedStatements = collectDeprecatedStatements(sourceCode, analyzable);
-            if (deprecatedStatements.length === 0) {
+            var movableStatements = computeMovableStatements(sourceCode, body, analyzable);
+            if (movableStatements.length === 0) {
                 return;
             }
             var markerOffset = findCompatMarkerOffset(sourceCode);
@@ -2395,7 +2866,7 @@ function _unsupported_iterable_to_array$9(o, minLen) {
                     context: context,
                     sourceCode: sourceCode,
                     analyzable: analyzable,
-                    deprecatedStatements: deprecatedStatements
+                    movableStatements: movableStatements
                 });
                 return;
             }
@@ -2403,7 +2874,8 @@ function _unsupported_iterable_to_array$9(o, minLen) {
                 context: context,
                 sourceCode: sourceCode,
                 analyzable: analyzable,
-                markerOffset: markerOffset
+                markerOffset: markerOffset,
+                movableSet: new Set(movableStatements)
             });
         }
         return {
@@ -2412,15 +2884,15 @@ function _unsupported_iterable_to_array$9(o, minLen) {
     }
 };
 
-function _array_like_to_array$8(arr, len) {
+function _array_like_to_array$7(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
 }
-function _array_with_holes$8(arr) {
+function _array_with_holes$7(arr) {
     if (Array.isArray(arr)) return arr;
 }
-function _iterable_to_array_limit$8(arr, i) {
+function _iterable_to_array_limit$7(arr, i) {
     var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
     if (_i == null) return;
     var _arr = [];
@@ -2444,19 +2916,19 @@ function _iterable_to_array_limit$8(arr, i) {
     }
     return _arr;
 }
-function _non_iterable_rest$8() {
+function _non_iterable_rest$7() {
     throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
-function _sliced_to_array$8(arr, i) {
-    return _array_with_holes$8(arr) || _iterable_to_array_limit$8(arr, i) || _unsupported_iterable_to_array$8(arr, i) || _non_iterable_rest$8();
+function _sliced_to_array$7(arr, i) {
+    return _array_with_holes$7(arr) || _iterable_to_array_limit$7(arr, i) || _unsupported_iterable_to_array$7(arr, i) || _non_iterable_rest$7();
 }
-function _unsupported_iterable_to_array$8(o, minLen) {
+function _unsupported_iterable_to_array$7(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$8(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$7(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$8(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$7(o, minLen);
 }
 var TAG_LINE_REGEX$1 = /^@([A-Za-z_]\w*)\s*(.*)$/;
 var TYPE_ANNOTATION_REGEX = /^\{([^}]*)\}\s*(.*)$/;
@@ -2521,7 +2993,7 @@ var LINE_PREFIX_REGEX = /^(\s*\*?\s?)(.*)$/;
     var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
     try {
         for(var _iterator = lines.entries()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var _step_value = _sliced_to_array$8(_step.value, 2), i = _step_value[0], line = _step_value[1];
+            var _step_value = _sliced_to_array$7(_step.value, 2), i = _step_value[0], line = _step_value[1];
             if (TAG_LINE_REGEX$1.test(line.text)) {
                 firstTagIndex = i;
                 break;
@@ -2757,21 +3229,21 @@ var LINE_PREFIX_REGEX = /^(\s*\*?\s?)(.*)$/;
     };
 }
 
-function _array_like_to_array$7(arr, len) {
+function _array_like_to_array$6(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
 }
-function _array_with_holes$7(arr) {
+function _array_with_holes$6(arr) {
     if (Array.isArray(arr)) return arr;
 }
 function _array_without_holes$1(arr) {
-    if (Array.isArray(arr)) return _array_like_to_array$7(arr);
+    if (Array.isArray(arr)) return _array_like_to_array$6(arr);
 }
 function _iterable_to_array$1(iter) {
     if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
 }
-function _iterable_to_array_limit$7(arr, i) {
+function _iterable_to_array_limit$6(arr, i) {
     var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
     if (_i == null) return;
     var _arr = [];
@@ -2795,25 +3267,25 @@ function _iterable_to_array_limit$7(arr, i) {
     }
     return _arr;
 }
-function _non_iterable_rest$7() {
+function _non_iterable_rest$6() {
     throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _non_iterable_spread$1() {
     throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
-function _sliced_to_array$7(arr, i) {
-    return _array_with_holes$7(arr) || _iterable_to_array_limit$7(arr, i) || _unsupported_iterable_to_array$7(arr, i) || _non_iterable_rest$7();
+function _sliced_to_array$6(arr, i) {
+    return _array_with_holes$6(arr) || _iterable_to_array_limit$6(arr, i) || _unsupported_iterable_to_array$6(arr, i) || _non_iterable_rest$6();
 }
 function _to_consumable_array$1(arr) {
-    return _array_without_holes$1(arr) || _iterable_to_array$1(arr) || _unsupported_iterable_to_array$7(arr) || _non_iterable_spread$1();
+    return _array_without_holes$1(arr) || _iterable_to_array$1(arr) || _unsupported_iterable_to_array$6(arr) || _non_iterable_spread$1();
 }
-function _unsupported_iterable_to_array$7(o, minLen) {
+function _unsupported_iterable_to_array$6(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$7(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$6(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$7(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$6(o, minLen);
 }
 var TAG_LINE_REGEX = /^@([A-Za-z_]\w*)\s*(.*)$/;
 var DEFAULT_WORKSPACE_TAG_PREFIXES = [
@@ -3185,7 +3657,7 @@ var TYPE_RESTATING_PATTERNS = [
     var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
     try {
         for(var _iterator = sections.entries()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var _step_value = _sliced_to_array$7(_step.value, 2), i = _step_value[0], section = _step_value[1];
+            var _step_value = _sliced_to_array$6(_step.value, 2), i = _step_value[0], section = _step_value[1];
             var _allLines;
             if (i > 0) allLines.push('');
             (_allLines = allLines).push.apply(_allLines, _to_consumable_array$1(section));
@@ -3485,7 +3957,7 @@ var LOWER_LETTER_PATTERN = /[a-z]/;
     var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
     try {
         for(var _iterator = indexed.entries()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var _step_value = _sliced_to_array$7(_step.value, 2), i = _step_value[0], element = _step_value[1];
+            var _step_value = _sliced_to_array$6(_step.value, 2), i = _step_value[0], element = _step_value[1];
             if (element.tag.tag === 'param') {
                 paramSlots.push(i);
                 paramEntries.push(element);
@@ -3515,7 +3987,7 @@ var LOWER_LETTER_PATTERN = /[a-z]/;
     var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
     try {
         for(var _iterator1 = paramSlots.entries()[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
-            var _step_value1 = _sliced_to_array$7(_step1.value, 2), i1 = _step_value1[0], paramSlot = _step_value1[1];
+            var _step_value1 = _sliced_to_array$6(_step1.value, 2), i1 = _step_value1[0], paramSlot = _step_value1[1];
             indexed[paramSlot] = paramEntries[i1];
         }
     } catch (err) {
@@ -4305,15 +4777,15 @@ var LOWER_LETTER_PATTERN = /[a-z]/;
     return name;
 }
 
-function _array_like_to_array$6(arr, len) {
+function _array_like_to_array$5(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
 }
-function _array_with_holes$6(arr) {
+function _array_with_holes$5(arr) {
     if (Array.isArray(arr)) return arr;
 }
-function _iterable_to_array_limit$6(arr, i) {
+function _iterable_to_array_limit$5(arr, i) {
     var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
     if (_i == null) return;
     var _arr = [];
@@ -4337,23 +4809,23 @@ function _iterable_to_array_limit$6(arr, i) {
     }
     return _arr;
 }
-function _non_iterable_rest$6() {
+function _non_iterable_rest$5() {
     throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
-function _sliced_to_array$6(arr, i) {
-    return _array_with_holes$6(arr) || _iterable_to_array_limit$6(arr, i) || _unsupported_iterable_to_array$6(arr, i) || _non_iterable_rest$6();
+function _sliced_to_array$5(arr, i) {
+    return _array_with_holes$5(arr) || _iterable_to_array_limit$5(arr, i) || _unsupported_iterable_to_array$5(arr, i) || _non_iterable_rest$5();
 }
-function _unsupported_iterable_to_array$6(o, minLen) {
+function _unsupported_iterable_to_array$5(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$6(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$5(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$6(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$5(o, minLen);
 }
 /**
  * Shared helpers for the `@dbx<Family>` companion-tag ESLint rules. Mirrors the
- * scanner schemas in `packages/dbx-components-mcp/src/scan/*-extract.ts` so
+ * scanner schemas in `packages/dbx-cli/src/lib/mcp-scan/scan/*-extract.ts` so
  * violations surface at lint time instead of at manifest-regeneration time.
  *
  * Each per-family rule supplies a {@link DbxTagFamilySpec} describing which
@@ -4632,7 +5104,7 @@ function emitUnknownCompanions(groups, knownSuffixes, emit) {
     var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
     try {
         for(var _iterator = groups.entries()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var _step_value = _sliced_to_array$6(_step.value, 2), suffix = _step_value[0], instances = _step_value[1];
+            var _step_value = _sliced_to_array$5(_step.value, 2), suffix = _step_value[0], instances = _step_value[1];
             if (knownSuffixes.has(suffix)) continue;
             var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
             try {
@@ -5010,7 +5482,7 @@ function reportUtilAllowedCategory(ctx, familyTags, allowedCategories) {
 ];
 /**
  * Allowed values for `@dbxUtilKind`. Mirrors the enum in
- * `packages/dbx-components-mcp/src/scan/utils-extract.ts`.
+ * `packages/dbx-cli/src/lib/mcp-scan/scan/utils-extract.ts`.
  */ var DEFAULT_ALLOWED_KINDS$2 = [
     'function',
     'class',
@@ -5020,7 +5492,7 @@ function reportUtilAllowedCategory(ctx, familyTags, allowedCategories) {
 /**
  * ESLint rule enforcing that exports tagged `@dbxUtil` carry the registry-required companion tags
  * with valid value formats. Mirrors the scanner schema at
- * `packages/dbx-components-mcp/src/scan/utils-extract.ts` so violations surface at lint time
+ * `packages/dbx-cli/src/lib/mcp-scan/scan/utils-extract.ts` so violations surface at lint time
  * instead of at manifest-regeneration time.
  *
  * Checks:
@@ -5201,7 +5673,7 @@ var DEFAULT_KNOWN_COMPANIONS$8 = [
 ];
 /**
  * ESLint rule enforcing `@dbxPipe` companion tags. Mirrors the scanner schema
- * at `packages/dbx-components-mcp/src/scan/pipes-extract.ts` so violations
+ * at `packages/dbx-cli/src/lib/mcp-scan/scan/pipes-extract.ts` so violations
  * surface at lint time instead of at manifest-regeneration time.
  */ var UTIL_REQUIRE_DBX_PIPE_COMPANION_TAGS_RULE = {
     meta: {
@@ -5429,7 +5901,7 @@ var DEFAULT_KNOWN_COMPANIONS$7 = [
 ];
 /**
  * ESLint rule enforcing `@dbxFilter` companion tags. Mirrors the scanner
- * schema at `packages/dbx-components-mcp/src/scan/filters-extract.ts`.
+ * schema at `packages/dbx-cli/src/lib/mcp-scan/scan/filters-extract.ts`.
  * Applies to classes (filter directives) and exported interfaces (filter
  * patterns); the scanner reads both as filter entries.
  */ var UTIL_REQUIRE_DBX_FILTER_COMPANION_TAGS_RULE = {
@@ -5635,7 +6107,7 @@ var DEFAULT_KNOWN_COMPANIONS$6 = [
 ];
 /**
  * ESLint rule enforcing `@dbxWebComponent` companion tags. Mirrors the scanner
- * schema at `packages/dbx-components-mcp/src/scan/ui-components-extract.ts`.
+ * schema at `packages/dbx-cli/src/lib/mcp-scan/scan/ui-components-extract.ts`.
  */ var UTIL_REQUIRE_DBX_WEB_COMPANION_TAGS_RULE = {
     meta: {
         type: 'suggestion',
@@ -5923,7 +6395,7 @@ var DEFAULT_KNOWN_COMPANIONS$5 = [
 ];
 /**
  * ESLint rule enforcing `@dbxDocsUiExample` companion tags. Mirrors the
- * scanner schema at `packages/dbx-components-mcp/src/scan/dbx-docs-ui-examples-extract.ts`.
+ * scanner schema at `packages/dbx-cli/src/lib/mcp-scan/scan/dbx-docs-ui-examples-extract.ts`.
  */ var UTIL_REQUIRE_DBX_DOCS_UI_EXAMPLE_COMPANION_TAGS_RULE = {
     meta: {
         type: 'suggestion',
@@ -6175,7 +6647,7 @@ var DEFAULT_KNOWN_COMPANIONS$4 = [
 ];
 /**
  * ESLint rule enforcing `@dbxModelSnapshotField` companion tags. Mirrors the
- * scanner schema at `packages/dbx-components-mcp/src/scan/model-snapshot-fields-extract.ts`.
+ * scanner schema at `packages/dbx-cli/src/lib/mcp-scan/scan/model-snapshot-fields-extract.ts`.
  */ var UTIL_REQUIRE_DBX_MODEL_SNAPSHOT_FIELD_COMPANION_TAGS_RULE = {
     meta: {
         type: 'suggestion',
@@ -6346,668 +6818,83 @@ var DEFAULT_KNOWN_COMPANIONS$4 = [
                                 lineIndex: v.lineIndex,
                                 messageId: 'skillRefsNotKebab',
                                 data: {
-                                    value: v.value
-                                },
-                                report: context.report
-                            });
-                            break;
-                        case 'tags-not-lowercase':
-                            {
-                                if (v.suffix !== 'Tags') break;
-                                var fix = buildLowercaseTagsFix({
-                                    commentNode: commentNode,
-                                    parsed: parsed,
-                                    sourceCode: sourceCode,
-                                    tag: v.raw
-                                });
-                                var fixer = fix ? function(fixer2) {
-                                    return fixer2.replaceTextRange([
-                                        fix.startOffset,
-                                        fix.endOffset
-                                    ], fix.replacement);
-                                } : undefined;
-                                reportOnJsdocLine({
-                                    commentNode: commentNode,
-                                    parsed: parsed,
-                                    sourceCode: sourceCode,
-                                    lineIndex: v.lineIndex,
-                                    messageId: 'tagsNotLowercase',
-                                    data: {
-                                        value: v.value
-                                    },
-                                    report: context.report,
-                                    fix: fixer
-                                });
-                                break;
-                            }
-                        case 'unknown':
-                            reportOnJsdocLine({
-                                commentNode: commentNode,
-                                parsed: parsed,
-                                sourceCode: sourceCode,
-                                lineIndex: v.lineIndex,
-                                messageId: 'unknownDbxModelSnapshotFieldTag',
-                                data: {
-                                    name: v.suffix,
-                                    known: knownCompanions.join(', ')
-                                },
-                                report: context.report
-                            });
-                            break;
-                        case 'duplicate':
-                            reportOnJsdocLine({
-                                commentNode: commentNode,
-                                parsed: parsed,
-                                sourceCode: sourceCode,
-                                lineIndex: v.lineIndex,
-                                messageId: 'duplicateCompanionTag',
-                                data: {
-                                    name: v.suffix
-                                },
-                                report: context.report
-                            });
-                            break;
-                    }
-                }
-            });
-        }
-        function visit(node) {
-            var anchor = node.parent && (node.parent.type === 'ExportNamedDeclaration' || node.parent.type === 'ExportDefaultDeclaration') ? node.parent : node;
-            var jsdoc = leadingJsdocFor(sourceCode, anchor);
-            if (jsdoc) checkJsdoc(jsdoc);
-        }
-        return {
-            FunctionDeclaration: function FunctionDeclaration(node) {
-                if (!node.body) return;
-                var jsdoc = leadingJsdocFor(sourceCode, getStatementAnchor(node));
-                if (jsdoc) checkJsdoc(jsdoc);
-            },
-            VariableDeclaration: visit
-        };
-    }
-};
-
-function _array_like_to_array$5(arr, len) {
-    if (len == null || len > arr.length) len = arr.length;
-    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
-    return arr2;
-}
-function _array_with_holes$5(arr) {
-    if (Array.isArray(arr)) return arr;
-}
-function _array_without_holes(arr) {
-    if (Array.isArray(arr)) return _array_like_to_array$5(arr);
-}
-function _iterable_to_array(iter) {
-    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
-}
-function _iterable_to_array_limit$5(arr, i) {
-    var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
-    if (_i == null) return;
-    var _arr = [];
-    var _n = true;
-    var _d = false;
-    var _s, _e;
-    try {
-        for(_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true){
-            _arr.push(_s.value);
-            if (i && _arr.length === i) break;
-        }
-    } catch (err) {
-        _d = true;
-        _e = err;
-    } finally{
-        try {
-            if (!_n && _i["return"] != null) _i["return"]();
-        } finally{
-            if (_d) throw _e;
-        }
-    }
-    return _arr;
-}
-function _non_iterable_rest$5() {
-    throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
-}
-function _non_iterable_spread() {
-    throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
-}
-function _sliced_to_array$5(arr, i) {
-    return _array_with_holes$5(arr) || _iterable_to_array_limit$5(arr, i) || _unsupported_iterable_to_array$5(arr, i) || _non_iterable_rest$5();
-}
-function _to_consumable_array(arr) {
-    return _array_without_holes(arr) || _iterable_to_array(arr) || _unsupported_iterable_to_array$5(arr) || _non_iterable_spread();
-}
-function _unsupported_iterable_to_array$5(o, minLen) {
-    if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$5(o, minLen);
-    var n = Object.prototype.toString.call(o).slice(8, -1);
-    if (n === "Object" && o.constructor) n = o.constructor.name;
-    if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$5(o, minLen);
-}
-var DEFAULT_ALLOWED_ROLES = [
-    'directive',
-    'store'
-];
-var DEFAULT_ALLOWED_STATES = [
-    'IDLE',
-    'DISABLED',
-    'TRIGGERED',
-    'VALUE_READY',
-    'WORKING',
-    'RESOLVED',
-    'REJECTED'
-];
-var DEFAULT_KNOWN_COMPANIONS$3 = [
-    'Slug',
-    'Role',
-    'StateInteraction',
-    'ProducesContext',
-    'ConsumesContext',
-    'SkillRefs',
-    'DisabledKey',
-    'StateEnum',
-    'StateTransitionsFrom',
-    'StateTransitionsTo'
-];
-var PROPERTY_ONLY_COMPANIONS = new Set([
-    'StateTransitionsFrom',
-    'StateTransitionsTo'
-]);
-function reportClassUnknownAndMisplaced(ctx, companions, knownCompanions) {
-    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-    try {
-        for(var _iterator = companions.entries()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var _step_value = _sliced_to_array$5(_step.value, 2), suffix = _step_value[0], instances = _step_value[1];
-            if (!knownCompanions.includes(suffix)) {
-                var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
-                try {
-                    for(var _iterator1 = instances[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
-                        var tag = _step1.value;
-                        reportOnJsdocLine({
-                            commentNode: ctx.commentNode,
-                            parsed: ctx.parsed,
-                            sourceCode: ctx.sourceCode,
-                            lineIndex: tag.startLineIndex,
-                            messageId: 'unknownDbxActionTag',
-                            data: {
-                                name: suffix,
-                                known: knownCompanions.join(', ')
-                            },
-                            report: ctx.report
-                        });
-                    }
-                } catch (err) {
-                    _didIteratorError1 = true;
-                    _iteratorError1 = err;
-                } finally{
-                    try {
-                        if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
-                            _iterator1.return();
-                        }
-                    } finally{
-                        if (_didIteratorError1) {
-                            throw _iteratorError1;
-                        }
-                    }
-                }
-            }
-            if (PROPERTY_ONLY_COMPANIONS.has(suffix)) {
-                var _iteratorNormalCompletion2 = true, _didIteratorError2 = false, _iteratorError2 = undefined;
-                try {
-                    for(var _iterator2 = instances[Symbol.iterator](), _step2; !(_iteratorNormalCompletion2 = (_step2 = _iterator2.next()).done); _iteratorNormalCompletion2 = true){
-                        var tag1 = _step2.value;
-                        reportOnJsdocLine({
-                            commentNode: ctx.commentNode,
-                            parsed: ctx.parsed,
-                            sourceCode: ctx.sourceCode,
-                            lineIndex: tag1.startLineIndex,
-                            messageId: 'stateTagOutsideEnumMember',
-                            data: {
-                                name: suffix
-                            },
-                            report: ctx.report
-                        });
-                    }
-                } catch (err) {
-                    _didIteratorError2 = true;
-                    _iteratorError2 = err;
-                } finally{
-                    try {
-                        if (!_iteratorNormalCompletion2 && _iterator2.return != null) {
-                            _iterator2.return();
-                        }
-                    } finally{
-                        if (_didIteratorError2) {
-                            throw _iteratorError2;
-                        }
-                    }
-                }
-            }
-        }
-    } catch (err) {
-        _didIteratorError = true;
-        _iteratorError = err;
-    } finally{
-        try {
-            if (!_iteratorNormalCompletion && _iterator.return != null) {
-                _iterator.return();
-            }
-        } finally{
-            if (_didIteratorError) {
-                throw _iteratorError;
-            }
-        }
-    }
-}
-function reportClassDuplicates(ctx, companions) {
-    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-    try {
-        for(var _iterator = companions.entries()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var _step_value = _sliced_to_array$5(_step.value, 2), suffix = _step_value[0], instances = _step_value[1];
-            if (instances.length <= 1) continue;
-            for(var i = 1; i < instances.length; i += 1){
-                reportOnJsdocLine({
-                    commentNode: ctx.commentNode,
-                    parsed: ctx.parsed,
-                    sourceCode: ctx.sourceCode,
-                    lineIndex: instances[i].startLineIndex,
-                    messageId: 'duplicateCompanionTag',
-                    data: {
-                        name: suffix
-                    },
-                    report: ctx.report
-                });
-            }
-        }
-    } catch (err) {
-        _didIteratorError = true;
-        _iteratorError = err;
-    } finally{
-        try {
-            if (!_iteratorNormalCompletion && _iterator.return != null) {
-                _iterator.return();
-            }
-        } finally{
-            if (_didIteratorError) {
-                throw _iteratorError;
-            }
-        }
-    }
-}
-function reportClassSlug(ctx, slugTags, triggerLine) {
-    if (slugTags.length === 0) {
-        reportOnJsdocLine({
-            commentNode: ctx.commentNode,
-            parsed: ctx.parsed,
-            sourceCode: ctx.sourceCode,
-            lineIndex: triggerLine,
-            messageId: 'missingSlug',
-            report: ctx.report
-        });
-        return;
-    }
-    var value = slugTags[0].description.trim();
-    if (value.length === 0) {
-        reportOnJsdocLine({
-            commentNode: ctx.commentNode,
-            parsed: ctx.parsed,
-            sourceCode: ctx.sourceCode,
-            lineIndex: slugTags[0].startLineIndex,
-            messageId: 'missingSlug',
-            report: ctx.report
-        });
-    } else if (!KEBAB_SLUG_PATTERN.test(value)) {
-        reportOnJsdocLine({
-            commentNode: ctx.commentNode,
-            parsed: ctx.parsed,
-            sourceCode: ctx.sourceCode,
-            lineIndex: slugTags[0].startLineIndex,
-            messageId: 'invalidSlugFormat',
-            data: {
-                value: value
-            },
-            report: ctx.report
-        });
-    }
-}
-function reportClassRoles(ctx, roleTags, allowedRoles) {
-    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-    try {
-        for(var _iterator = roleTags[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var tag = _step.value;
-            var value = tag.description.trim();
-            if (value.length > 0 && !allowedRoles.includes(value)) {
-                reportOnJsdocLine({
-                    commentNode: ctx.commentNode,
-                    parsed: ctx.parsed,
-                    sourceCode: ctx.sourceCode,
-                    lineIndex: tag.startLineIndex,
-                    messageId: 'invalidRole',
-                    data: {
-                        value: value,
-                        allowed: allowedRoles.join(', ')
-                    },
-                    report: ctx.report
-                });
-            }
-        }
-    } catch (err) {
-        _didIteratorError = true;
-        _iteratorError = err;
-    } finally{
-        try {
-            if (!_iteratorNormalCompletion && _iterator.return != null) {
-                _iterator.return();
-            }
-        } finally{
-            if (_didIteratorError) {
-                throw _iteratorError;
-            }
-        }
-    }
-}
-function reportClassStateInteractions(ctx, stateTags, allowedStates) {
-    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-    try {
-        for(var _iterator = stateTags[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var tag = _step.value;
-            var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
-            try {
-                for(var _iterator1 = splitCommaSeparated(tag.description)[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
-                    var item = _step1.value;
-                    if (!allowedStates.includes(item)) {
-                        reportOnJsdocLine({
-                            commentNode: ctx.commentNode,
-                            parsed: ctx.parsed,
-                            sourceCode: ctx.sourceCode,
-                            lineIndex: tag.startLineIndex,
-                            messageId: 'invalidStateValue',
-                            data: {
-                                value: item,
-                                allowed: allowedStates.join(', ')
-                            },
-                            report: ctx.report
-                        });
-                    }
-                }
-            } catch (err) {
-                _didIteratorError1 = true;
-                _iteratorError1 = err;
-            } finally{
-                try {
-                    if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
-                        _iterator1.return();
-                    }
-                } finally{
-                    if (_didIteratorError1) {
-                        throw _iteratorError1;
-                    }
-                }
-            }
-        }
-    } catch (err) {
-        _didIteratorError = true;
-        _iteratorError = err;
-    } finally{
-        try {
-            if (!_iteratorNormalCompletion && _iterator.return != null) {
-                _iterator.return();
-            }
-        } finally{
-            if (_didIteratorError) {
-                throw _iteratorError;
-            }
-        }
-    }
-}
-function reportClassSkillRefs(ctx, skillRefsTags) {
-    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-    try {
-        for(var _iterator = skillRefsTags[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var tag = _step.value;
-            var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
-            try {
-                for(var _iterator1 = splitCommaSeparated(tag.description)[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
-                    var item = _step1.value;
-                    if (!KEBAB_SLUG_PATTERN.test(item)) {
-                        reportOnJsdocLine({
-                            commentNode: ctx.commentNode,
-                            parsed: ctx.parsed,
-                            sourceCode: ctx.sourceCode,
-                            lineIndex: tag.startLineIndex,
-                            messageId: 'skillRefsNotKebab',
-                            data: {
-                                value: item
-                            },
-                            report: ctx.report
-                        });
-                    }
-                }
-            } catch (err) {
-                _didIteratorError1 = true;
-                _iteratorError1 = err;
-            } finally{
-                try {
-                    if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
-                        _iterator1.return();
-                    }
-                } finally{
-                    if (_didIteratorError1) {
-                        throw _iteratorError1;
-                    }
-                }
-            }
-        }
-    } catch (err) {
-        _didIteratorError = true;
-        _iteratorError = err;
-    } finally{
-        try {
-            if (!_iteratorNormalCompletion && _iterator.return != null) {
-                _iterator.return();
-            }
-        } finally{
-            if (_didIteratorError) {
-                throw _iteratorError;
-            }
-        }
-    }
-}
-/**
- * Splits an `@dbxAction`-family JSDoc into its marker tag and the map of
- * companion tags keyed by their suffix (e.g. `Slug`, `Role`).
- *
- * @param parsed - The parsed JSDoc to inspect.
- * @returns The marker tag (if any) and a map of companion suffix to tag instances.
- */ function collectFamilyTags(parsed) {
-    var markerTag = parsed.tags.find(function(t) {
-        return t.tag === 'dbxAction';
-    });
-    var groups = new Map();
-    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-    try {
-        for(var _iterator = parsed.tags[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var tag = _step.value;
-            var _groups_get;
-            if (!tag.tag.startsWith('dbxAction') || tag.tag === 'dbxAction') continue;
-            var suffix = tag.tag.slice('dbxAction'.length);
-            var list = (_groups_get = groups.get(suffix)) !== null && _groups_get !== void 0 ? _groups_get : [];
-            list.push(tag);
-            groups.set(suffix, list);
-        }
-    } catch (err) {
-        _didIteratorError = true;
-        _iteratorError = err;
-    } finally{
-        try {
-            if (!_iteratorNormalCompletion && _iterator.return != null) {
-                _iterator.return();
-            }
-        } finally{
-            if (_didIteratorError) {
-                throw _iteratorError;
-            }
-        }
-    }
-    return {
-        markerTag: markerTag,
-        companions: groups
-    };
-}
-/**
- * ESLint rule enforcing `@dbxAction` companion tags. Mirrors the scanner
- * schema at `packages/dbx-components-mcp/src/scan/actions-extract.ts`. Class
- * declarations carry the `@dbxAction` marker; enum declarations carry the
- * `@dbxActionStateEnum` marker, and `@dbxActionStateTransitionsFrom/To` are
- * valid on enum-member JSDocs.
- */ var UTIL_REQUIRE_DBX_ACTION_COMPANION_TAGS_RULE = {
-    meta: {
-        type: 'suggestion',
-        fixable: 'code',
-        docs: {
-            description: 'Require the canonical `@dbxAction*` companion tags on `@dbxAction`-tagged classes and `@dbxActionStateEnum`-tagged enums.',
-            recommended: true
-        },
-        messages: {
-            missingSlug: '`@dbxAction`-tagged class is missing the required `@dbxActionSlug <slug>` companion tag.',
-            invalidSlugFormat: '`@dbxActionSlug` value `{{value}}` is not a valid kebab-case slug.',
-            invalidRole: '`@dbxActionRole` value `{{value}}` is not allowed. Use one of: {{allowed}}.',
-            invalidStateValue: '`@dbxActionStateInteraction` value `{{value}}` is not a valid state. Use one of: {{allowed}}.',
-            skillRefsNotKebab: '`@dbxActionSkillRefs` item `{{value}}` is not a kebab-case slug.',
-            stateTagOutsideEnumMember: '`@dbxAction{{name}}` is only valid on enum members of a `@dbxActionStateEnum`-tagged enum.',
-            unknownDbxActionTag: '`@dbxAction{{name}}` is not a recognized companion tag. Known companions: {{known}}.',
-            duplicateCompanionTag: '`@dbxAction{{name}}` is declared more than once.'
-        },
-        schema: [
-            {
-                type: 'object',
-                additionalProperties: false,
-                properties: {
-                    allowedRoles: {
-                        type: 'array',
-                        items: {
-                            type: 'string'
-                        }
-                    },
-                    allowedStates: {
-                        type: 'array',
-                        items: {
-                            type: 'string'
-                        }
-                    },
-                    knownCompanions: {
-                        type: 'array',
-                        items: {
-                            type: 'string'
-                        }
-                    },
-                    requireBareMarker: {
-                        type: 'boolean'
-                    }
-                }
-            }
-        ]
-    },
-    create: function create(context) {
-        var _context_options_, _options_allowedRoles, _options_allowedStates, _options_knownCompanions;
-        var options = (_context_options_ = context.options[0]) !== null && _context_options_ !== void 0 ? _context_options_ : {};
-        var sourceCode = context.sourceCode;
-        var allowedRoles = (_options_allowedRoles = options.allowedRoles) !== null && _options_allowedRoles !== void 0 ? _options_allowedRoles : DEFAULT_ALLOWED_ROLES;
-        var allowedStates = (_options_allowedStates = options.allowedStates) !== null && _options_allowedStates !== void 0 ? _options_allowedStates : DEFAULT_ALLOWED_STATES;
-        var knownCompanions = (_options_knownCompanions = options.knownCompanions) !== null && _options_knownCompanions !== void 0 ? _options_knownCompanions : DEFAULT_KNOWN_COMPANIONS$3;
-        var requireBareMarker = options.requireBareMarker !== false;
-        function checkClassJsdoc(commentNode) {
-            var _ref, _companions_get, _companions_get1, _companions_get2, _companions_get3;
-            var _this, _Array_from_;
-            var parsed = parseJsdocComment(commentNode.value);
-            var _collectFamilyTags = collectFamilyTags(parsed), markerTag = _collectFamilyTags.markerTag, companions = _collectFamilyTags.companions;
-            if (!markerTag && companions.size === 0 || requireBareMarker && !markerTag) return;
-            var ctx = {
-                commentNode: commentNode,
-                parsed: parsed,
-                sourceCode: sourceCode,
-                report: context.report
-            };
-            var triggerLine = (_ref = (_this = markerTag !== null && markerTag !== void 0 ? markerTag : (_Array_from_ = Array.from(companions.values())[0]) === null || _Array_from_ === void 0 ? void 0 : _Array_from_[0]) === null || _this === void 0 ? void 0 : _this.startLineIndex) !== null && _ref !== void 0 ? _ref : 0;
-            reportClassUnknownAndMisplaced(ctx, companions, knownCompanions);
-            reportClassDuplicates(ctx, companions);
-            reportClassSlug(ctx, (_companions_get = companions.get('Slug')) !== null && _companions_get !== void 0 ? _companions_get : [], triggerLine);
-            reportClassRoles(ctx, (_companions_get1 = companions.get('Role')) !== null && _companions_get1 !== void 0 ? _companions_get1 : [], allowedRoles);
-            reportClassStateInteractions(ctx, (_companions_get2 = companions.get('StateInteraction')) !== null && _companions_get2 !== void 0 ? _companions_get2 : [], allowedStates);
-            reportClassSkillRefs(ctx, (_companions_get3 = companions.get('SkillRefs')) !== null && _companions_get3 !== void 0 ? _companions_get3 : []);
-        }
-        function checkEnumMemberJsdoc(commentNode) {
-            var parsed = parseJsdocComment(commentNode.value);
-            var fromTags = parsed.tags.filter(function(t) {
-                return t.tag === 'dbxActionStateTransitionsFrom';
-            });
-            var toTags = parsed.tags.filter(function(t) {
-                return t.tag === 'dbxActionStateTransitionsTo';
-            });
-            var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-            try {
-                for(var _iterator = _to_consumable_array(fromTags).concat(_to_consumable_array(toTags))[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-                    var tag = _step.value;
-                    var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
-                    try {
-                        for(var _iterator1 = splitCommaSeparated(tag.description)[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
-                            var item = _step1.value;
-                            if (!allowedStates.includes(item)) reportOnJsdocLine({
+                                    value: v.value
+                                },
+                                report: context.report
+                            });
+                            break;
+                        case 'tags-not-lowercase':
+                            {
+                                if (v.suffix !== 'Tags') break;
+                                var fix = buildLowercaseTagsFix({
+                                    commentNode: commentNode,
+                                    parsed: parsed,
+                                    sourceCode: sourceCode,
+                                    tag: v.raw
+                                });
+                                var fixer = fix ? function(fixer2) {
+                                    return fixer2.replaceTextRange([
+                                        fix.startOffset,
+                                        fix.endOffset
+                                    ], fix.replacement);
+                                } : undefined;
+                                reportOnJsdocLine({
+                                    commentNode: commentNode,
+                                    parsed: parsed,
+                                    sourceCode: sourceCode,
+                                    lineIndex: v.lineIndex,
+                                    messageId: 'tagsNotLowercase',
+                                    data: {
+                                        value: v.value
+                                    },
+                                    report: context.report,
+                                    fix: fixer
+                                });
+                                break;
+                            }
+                        case 'unknown':
+                            reportOnJsdocLine({
                                 commentNode: commentNode,
                                 parsed: parsed,
                                 sourceCode: sourceCode,
-                                lineIndex: tag.startLineIndex,
-                                messageId: 'invalidStateValue',
+                                lineIndex: v.lineIndex,
+                                messageId: 'unknownDbxModelSnapshotFieldTag',
                                 data: {
-                                    value: item,
-                                    allowed: allowedStates.join(', ')
+                                    name: v.suffix,
+                                    known: knownCompanions.join(', ')
                                 },
                                 report: context.report
                             });
-                        }
-                    } catch (err) {
-                        _didIteratorError1 = true;
-                        _iteratorError1 = err;
-                    } finally{
-                        try {
-                            if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
-                                _iterator1.return();
-                            }
-                        } finally{
-                            if (_didIteratorError1) {
-                                throw _iteratorError1;
-                            }
-                        }
-                    }
-                }
-            } catch (err) {
-                _didIteratorError = true;
-                _iteratorError = err;
-            } finally{
-                try {
-                    if (!_iteratorNormalCompletion && _iterator.return != null) {
-                        _iterator.return();
-                    }
-                } finally{
-                    if (_didIteratorError) {
-                        throw _iteratorError;
+                            break;
+                        case 'duplicate':
+                            reportOnJsdocLine({
+                                commentNode: commentNode,
+                                parsed: parsed,
+                                sourceCode: sourceCode,
+                                lineIndex: v.lineIndex,
+                                messageId: 'duplicateCompanionTag',
+                                data: {
+                                    name: v.suffix
+                                },
+                                report: context.report
+                            });
+                            break;
                     }
                 }
-            }
+            });
         }
-        function visitClass(node) {
+        function visit(node) {
             var anchor = node.parent && (node.parent.type === 'ExportNamedDeclaration' || node.parent.type === 'ExportDefaultDeclaration') ? node.parent : node;
             var jsdoc = leadingJsdocFor(sourceCode, anchor);
-            if (jsdoc) checkClassJsdoc(jsdoc);
-        }
-        function visitEnumMember(node) {
-            var jsdoc = leadingJsdocFor(sourceCode, node);
-            if (jsdoc) checkEnumMemberJsdoc(jsdoc);
+            if (jsdoc) checkJsdoc(jsdoc);
         }
         return {
-            ClassDeclaration: visitClass,
-            TSEnumMember: visitEnumMember
+            FunctionDeclaration: function FunctionDeclaration(node) {
+                if (!node.body) return;
+                var jsdoc = leadingJsdocFor(sourceCode, getStatementAnchor(node));
+                if (jsdoc) checkJsdoc(jsdoc);
+            },
+            VariableDeclaration: visit
         };
     }
 };
@@ -7020,6 +6907,12 @@ function _array_like_to_array$4(arr, len) {
 function _array_with_holes$4(arr) {
     if (Array.isArray(arr)) return arr;
 }
+function _array_without_holes(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array$4(arr);
+}
+function _iterable_to_array(iter) {
+    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
+}
 function _iterable_to_array_limit$4(arr, i) {
     var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
     if (_i == null) return;
@@ -7047,192 +6940,119 @@ function _iterable_to_array_limit$4(arr, i) {
 function _non_iterable_rest$4() {
     throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
+function _non_iterable_spread() {
+    throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
 function _sliced_to_array$4(arr, i) {
     return _array_with_holes$4(arr) || _iterable_to_array_limit$4(arr, i) || _unsupported_iterable_to_array$4(arr, i) || _non_iterable_rest$4();
 }
+function _to_consumable_array(arr) {
+    return _array_without_holes(arr) || _iterable_to_array(arr) || _unsupported_iterable_to_array$4(arr) || _non_iterable_spread();
+}
 function _unsupported_iterable_to_array$4(o, minLen) {
     if (!o) return;
     if (typeof o === "string") return _array_like_to_array$4(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
-    if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$4(o, minLen);
-}
-var FORM_MARKERS = new Set([
-    'dbxFormField',
-    'dbxFormFieldDerivative',
-    'dbxFormFieldTemplate'
-]);
-var COMPOSES_FROM_MARKERS = new Set([
-    'dbxFormFieldDerivative',
-    'dbxFormFieldTemplate'
-]);
-var DEFAULT_ALLOWED_TIERS = [
-    'field-factory',
-    'field-derivative',
-    'composite-builder',
-    'template-builder',
-    'primitive'
-];
-var DEFAULT_ALLOWED_WRAPPER_PATTERNS = [
-    'unwrapped',
-    'material-form-field-wrapped'
-];
-var DEFAULT_ALLOWED_SUFFIXES = [
-    'Row',
-    'Group',
-    'Fields',
-    'Field',
-    'Wrapper',
-    'Layout'
-];
-var DEFAULT_ALLOWED_ARRAY_OUTPUTS = [
-    'yes',
-    'no',
-    'optional'
-];
-var DEFAULT_KNOWN_COMPANIONS$2 = [
-    'Slug',
-    'Tier',
-    'Produces',
-    'ArrayOutput',
-    'WrapperPattern',
-    'NgFormType',
-    'Suffix',
-    'Returns',
-    'ComposesFrom',
-    'ConfigInterface',
-    'PropsInterface',
-    'Generic',
-    'PropName'
-];
-/**
- * Splits a `@dbxFormField` JSDoc into its marker tags and the map of
- * `@dbxForm*` companion tags keyed by their suffix.
- *
- * @param parsed - The parsed JSDoc to inspect.
- * @returns The list of marker tags and the map of companion suffix to tag instances.
- */ function collectFormTags(parsed) {
-    var markers = [];
-    var companions = new Map();
-    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-    try {
-        for(var _iterator = parsed.tags[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var tag = _step.value;
-            if (FORM_MARKERS.has(tag.tag)) {
-                markers.push(tag);
-            } else if (tag.tag.startsWith('dbxForm') && !tag.tag.startsWith('dbxFormField')) {
-                var _companions_get;
-                var suffix = tag.tag.slice('dbxForm'.length);
-                var list = (_companions_get = companions.get(suffix)) !== null && _companions_get !== void 0 ? _companions_get : [];
-                list.push(tag);
-                companions.set(suffix, list);
-            }
-        }
-    } catch (err) {
-        _didIteratorError = true;
-        _iteratorError = err;
-    } finally{
-        try {
-            if (!_iteratorNormalCompletion && _iterator.return != null) {
-                _iterator.return();
-            }
-        } finally{
-            if (_didIteratorError) {
-                throw _iteratorError;
-            }
-        }
-    }
-    return {
-        markers: markers,
-        companions: companions
-    };
-}
-/**
- * Resolves the effective tier for a `@dbxFormField`-family JSDoc by
- * preferring marker-derived tiers (e.g. `@dbxFormFieldDerivative` →
- * `'field-derivative'`) and falling back to the first `@dbxFormTier`.
- *
- * @param markers - The marker tags found on the JSDoc.
- * @param tierTags - Any explicit `@dbxFormTier` tags found on the JSDoc.
- * @returns The resolved tier, or `undefined` when none is present.
- */ function determineTier(markers, tierTags) {
-    // Marker-derived tier takes precedence; `@dbxFormFieldDerivative` → 'field-derivative', `@dbxFormFieldTemplate` → 'template-builder'.
-    // `@dbxFormField` requires an explicit `@dbxFormTier`.
-    var derived;
-    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-    try {
-        for(var _iterator = markers[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var m = _step.value;
-            if (m.tag === 'dbxFormFieldDerivative') derived = 'field-derivative';
-            else if (m.tag === 'dbxFormFieldTemplate') derived = 'template-builder';
-        }
-    } catch (err) {
-        _didIteratorError = true;
-        _iteratorError = err;
-    } finally{
-        try {
-            if (!_iteratorNormalCompletion && _iterator.return != null) {
-                _iterator.return();
-            }
-        } finally{
-            if (_didIteratorError) {
-                throw _iteratorError;
-            }
-        }
-    }
-    if (derived !== undefined) {
-        return derived;
-    }
-    return tierTags.length > 0 ? tierTags[0].description.trim() : undefined;
-}
-function reportFormDuplicateMarkers(ctx, markers) {
-    if (markers.length <= 1) return;
-    for(var i = 1; i < markers.length; i += 1){
-        reportOnJsdocLine({
-            commentNode: ctx.commentNode,
-            parsed: ctx.parsed,
-            sourceCode: ctx.sourceCode,
-            lineIndex: markers[i].startLineIndex,
-            messageId: 'duplicateMarker',
-            report: ctx.report
-        });
-    }
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$4(o, minLen);
 }
-function reportFormUnknownCompanions(ctx, companions, knownCompanions) {
+var DEFAULT_ALLOWED_ROLES = [
+    'directive',
+    'store'
+];
+var DEFAULT_ALLOWED_STATES = [
+    'IDLE',
+    'DISABLED',
+    'TRIGGERED',
+    'VALUE_READY',
+    'WORKING',
+    'RESOLVED',
+    'REJECTED'
+];
+var DEFAULT_KNOWN_COMPANIONS$3 = [
+    'Slug',
+    'Role',
+    'StateInteraction',
+    'ProducesContext',
+    'ConsumesContext',
+    'SkillRefs',
+    'DisabledKey',
+    'StateEnum',
+    'StateTransitionsFrom',
+    'StateTransitionsTo'
+];
+var PROPERTY_ONLY_COMPANIONS = new Set([
+    'StateTransitionsFrom',
+    'StateTransitionsTo'
+]);
+function reportClassUnknownAndMisplaced(ctx, companions, knownCompanions) {
     var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
     try {
         for(var _iterator = companions.entries()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
             var _step_value = _sliced_to_array$4(_step.value, 2), suffix = _step_value[0], instances = _step_value[1];
-            if (knownCompanions.includes(suffix)) continue;
-            var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
-            try {
-                for(var _iterator1 = instances[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
-                    var tag = _step1.value;
-                    reportOnJsdocLine({
-                        commentNode: ctx.commentNode,
-                        parsed: ctx.parsed,
-                        sourceCode: ctx.sourceCode,
-                        lineIndex: tag.startLineIndex,
-                        messageId: 'unknownDbxFormTag',
-                        data: {
-                            name: suffix,
-                            known: knownCompanions.join(', ')
-                        },
-                        report: ctx.report
-                    });
+            if (!knownCompanions.includes(suffix)) {
+                var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+                try {
+                    for(var _iterator1 = instances[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                        var tag = _step1.value;
+                        reportOnJsdocLine({
+                            commentNode: ctx.commentNode,
+                            parsed: ctx.parsed,
+                            sourceCode: ctx.sourceCode,
+                            lineIndex: tag.startLineIndex,
+                            messageId: 'unknownDbxActionTag',
+                            data: {
+                                name: suffix,
+                                known: knownCompanions.join(', ')
+                            },
+                            report: ctx.report
+                        });
+                    }
+                } catch (err) {
+                    _didIteratorError1 = true;
+                    _iteratorError1 = err;
+                } finally{
+                    try {
+                        if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                            _iterator1.return();
+                        }
+                    } finally{
+                        if (_didIteratorError1) {
+                            throw _iteratorError1;
+                        }
+                    }
                 }
-            } catch (err) {
-                _didIteratorError1 = true;
-                _iteratorError1 = err;
-            } finally{
+            }
+            if (PROPERTY_ONLY_COMPANIONS.has(suffix)) {
+                var _iteratorNormalCompletion2 = true, _didIteratorError2 = false, _iteratorError2 = undefined;
                 try {
-                    if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
-                        _iterator1.return();
+                    for(var _iterator2 = instances[Symbol.iterator](), _step2; !(_iteratorNormalCompletion2 = (_step2 = _iterator2.next()).done); _iteratorNormalCompletion2 = true){
+                        var tag1 = _step2.value;
+                        reportOnJsdocLine({
+                            commentNode: ctx.commentNode,
+                            parsed: ctx.parsed,
+                            sourceCode: ctx.sourceCode,
+                            lineIndex: tag1.startLineIndex,
+                            messageId: 'stateTagOutsideEnumMember',
+                            data: {
+                                name: suffix
+                            },
+                            report: ctx.report
+                        });
                     }
+                } catch (err) {
+                    _didIteratorError2 = true;
+                    _iteratorError2 = err;
                 } finally{
-                    if (_didIteratorError1) {
-                        throw _iteratorError1;
+                    try {
+                        if (!_iteratorNormalCompletion2 && _iterator2.return != null) {
+                            _iterator2.return();
+                        }
+                    } finally{
+                        if (_didIteratorError2) {
+                            throw _iteratorError2;
+                        }
                     }
                 }
             }
@@ -7252,7 +7072,7 @@ function reportFormUnknownCompanions(ctx, companions, knownCompanions) {
         }
     }
 }
-function reportFormDuplicateCompanions(ctx, companions) {
+function reportClassDuplicates(ctx, companions) {
     var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
     try {
         for(var _iterator = companions.entries()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
@@ -7284,230 +7104,100 @@ function reportFormDuplicateCompanions(ctx, companions) {
             if (_didIteratorError) {
                 throw _iteratorError;
             }
-        }
-    }
-}
-function reportFormSlug(ctx, slugTags, triggerLine) {
-    if (slugTags.length === 0) {
-        reportOnJsdocLine({
-            commentNode: ctx.commentNode,
-            parsed: ctx.parsed,
-            sourceCode: ctx.sourceCode,
-            lineIndex: triggerLine,
-            messageId: 'missingSlug',
-            report: ctx.report
-        });
-        return;
-    }
-    var value = slugTags[0].description.trim();
-    if (value.length === 0) {
-        reportOnJsdocLine({
-            commentNode: ctx.commentNode,
-            parsed: ctx.parsed,
-            sourceCode: ctx.sourceCode,
-            lineIndex: slugTags[0].startLineIndex,
-            messageId: 'missingSlug',
-            report: ctx.report
-        });
-    } else if (!KEBAB_SLUG_PATTERN.test(value)) {
-        reportOnJsdocLine({
-            commentNode: ctx.commentNode,
-            parsed: ctx.parsed,
-            sourceCode: ctx.sourceCode,
-            lineIndex: slugTags[0].startLineIndex,
-            messageId: 'invalidSlugFormat',
-            data: {
-                value: value
-            },
-            report: ctx.report
-        });
-    }
-}
-function reportFormProduces(ctx, producesTags, triggerLine) {
-    if (producesTags.length === 0 || producesTags[0].description.trim().length === 0) {
-        reportOnJsdocLine({
-            commentNode: ctx.commentNode,
-            parsed: ctx.parsed,
-            sourceCode: ctx.sourceCode,
-            lineIndex: triggerLine,
-            messageId: 'missingProduces',
-            report: ctx.report
-        });
-    }
-}
-function reportFormArrayOutput(input) {
-    var ctx = input.ctx, arrayOutputTags = input.arrayOutputTags, allowedArrayOutputs = input.allowedArrayOutputs, triggerLine = input.triggerLine;
-    if (arrayOutputTags.length === 0 || arrayOutputTags[0].description.trim().length === 0) {
-        reportOnJsdocLine({
-            commentNode: ctx.commentNode,
-            parsed: ctx.parsed,
-            sourceCode: ctx.sourceCode,
-            lineIndex: triggerLine,
-            messageId: 'missingArrayOutput',
-            report: ctx.report
-        });
-        return;
-    }
-    var value = arrayOutputTags[0].description.trim();
-    if (!allowedArrayOutputs.includes(value)) {
-        reportOnJsdocLine({
-            commentNode: ctx.commentNode,
-            parsed: ctx.parsed,
-            sourceCode: ctx.sourceCode,
-            lineIndex: arrayOutputTags[0].startLineIndex,
-            messageId: 'invalidArrayOutput',
-            data: {
-                value: value,
-                allowed: allowedArrayOutputs.join(', ')
-            },
-            report: ctx.report
-        });
-    }
-}
-function reportFormTier(input) {
-    var ctx = input.ctx, markers = input.markers, tierTags = input.tierTags, tier = input.tier, allowedTiers = input.allowedTiers, triggerLine = input.triggerLine;
-    if (!markers.some(function(m) {
-        return m.tag === 'dbxFormField';
-    })) return;
-    if (tier == null) {
-        reportOnJsdocLine({
-            commentNode: ctx.commentNode,
-            parsed: ctx.parsed,
-            sourceCode: ctx.sourceCode,
-            lineIndex: triggerLine,
-            messageId: 'missingTier',
-            report: ctx.report
-        });
-    } else if (!allowedTiers.includes(tier)) {
-        var _ref;
-        var _tierTags_;
-        reportOnJsdocLine({
-            commentNode: ctx.commentNode,
-            parsed: ctx.parsed,
-            sourceCode: ctx.sourceCode,
-            lineIndex: (_ref = (_tierTags_ = tierTags[0]) === null || _tierTags_ === void 0 ? void 0 : _tierTags_.startLineIndex) !== null && _ref !== void 0 ? _ref : triggerLine,
-            messageId: 'invalidTier',
-            data: {
-                value: tier,
-                allowed: allowedTiers.join(', ')
-            },
-            report: ctx.report
-        });
-    }
-}
-function reportFormWrapperPattern(input) {
-    var ctx = input.ctx, wrapperTags = input.wrapperTags, allowedWrapperPatterns = input.allowedWrapperPatterns, triggerLine = input.triggerLine;
-    if (wrapperTags.length === 0 || wrapperTags[0].description.trim().length === 0) {
-        reportOnJsdocLine({
-            commentNode: ctx.commentNode,
-            parsed: ctx.parsed,
-            sourceCode: ctx.sourceCode,
-            lineIndex: triggerLine,
-            messageId: 'missingWrapperPattern',
-            report: ctx.report
-        });
-        return;
-    }
-    var value = wrapperTags[0].description.trim();
-    if (!allowedWrapperPatterns.includes(value)) {
-        reportOnJsdocLine({
-            commentNode: ctx.commentNode,
-            parsed: ctx.parsed,
-            sourceCode: ctx.sourceCode,
-            lineIndex: wrapperTags[0].startLineIndex,
-            messageId: 'invalidWrapperPattern',
-            data: {
-                value: value,
-                allowed: allowedWrapperPatterns.join(', ')
-            },
-            report: ctx.report
-        });
+        }
     }
 }
-function reportFormFieldFactoryTier(input) {
-    var _companions_get, _companions_get1;
-    var ctx = input.ctx, companions = input.companions, allowedWrapperPatterns = input.allowedWrapperPatterns, triggerLine = input.triggerLine;
-    reportFormWrapperPattern({
-        ctx: ctx,
-        wrapperTags: (_companions_get = companions.get('WrapperPattern')) !== null && _companions_get !== void 0 ? _companions_get : [],
-        allowedWrapperPatterns: allowedWrapperPatterns,
-        triggerLine: triggerLine
-    });
-    var ngFormTags = (_companions_get1 = companions.get('NgFormType')) !== null && _companions_get1 !== void 0 ? _companions_get1 : [];
-    if (ngFormTags.length === 0 || ngFormTags[0].description.trim().length === 0) {
+function reportClassSlug(ctx, slugTags, triggerLine) {
+    if (slugTags.length === 0) {
         reportOnJsdocLine({
             commentNode: ctx.commentNode,
             parsed: ctx.parsed,
             sourceCode: ctx.sourceCode,
             lineIndex: triggerLine,
-            messageId: 'missingNgFormType',
+            messageId: 'missingSlug',
             report: ctx.report
         });
+        return;
     }
-}
-function reportFormCompositeBuilderTier(input) {
-    var ctx = input.ctx, suffixTags = input.suffixTags, allowedSuffixes = input.allowedSuffixes, triggerLine = input.triggerLine;
-    if (suffixTags.length === 0 || suffixTags[0].description.trim().length === 0) {
+    var value = slugTags[0].description.trim();
+    if (value.length === 0) {
         reportOnJsdocLine({
             commentNode: ctx.commentNode,
             parsed: ctx.parsed,
             sourceCode: ctx.sourceCode,
-            lineIndex: triggerLine,
-            messageId: 'missingSuffix',
+            lineIndex: slugTags[0].startLineIndex,
+            messageId: 'missingSlug',
             report: ctx.report
         });
-        return;
-    }
-    var value = suffixTags[0].description.trim();
-    if (!allowedSuffixes.includes(value)) {
+    } else if (!KEBAB_SLUG_PATTERN.test(value)) {
         reportOnJsdocLine({
             commentNode: ctx.commentNode,
             parsed: ctx.parsed,
             sourceCode: ctx.sourceCode,
-            lineIndex: suffixTags[0].startLineIndex,
-            messageId: 'invalidSuffix',
+            lineIndex: slugTags[0].startLineIndex,
+            messageId: 'invalidSlugFormat',
             data: {
-                value: value,
-                allowed: allowedSuffixes.join(', ')
+                value: value
             },
             report: ctx.report
         });
     }
 }
-function reportFormDerivativeTier(input) {
-    var ctx = input.ctx, markers = input.markers, composesFromTags = input.composesFromTags, triggerLine = input.triggerLine;
-    var markerCarriesComposes = markers.some(function(m) {
-        return COMPOSES_FROM_MARKERS.has(m.tag) && m.description.trim().length > 0;
-    });
-    if (composesFromTags.length === 0 && !markerCarriesComposes) {
-        reportOnJsdocLine({
-            commentNode: ctx.commentNode,
-            parsed: ctx.parsed,
-            sourceCode: ctx.sourceCode,
-            lineIndex: triggerLine,
-            messageId: 'missingComposesFrom',
-            report: ctx.report
-        });
+function reportClassRoles(ctx, roleTags, allowedRoles) {
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = roleTags[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var tag = _step.value;
+            var value = tag.description.trim();
+            if (value.length > 0 && !allowedRoles.includes(value)) {
+                reportOnJsdocLine({
+                    commentNode: ctx.commentNode,
+                    parsed: ctx.parsed,
+                    sourceCode: ctx.sourceCode,
+                    lineIndex: tag.startLineIndex,
+                    messageId: 'invalidRole',
+                    data: {
+                        value: value,
+                        allowed: allowedRoles.join(', ')
+                    },
+                    report: ctx.report
+                });
+            }
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
     }
 }
-function reportFormComposesFromKebab(ctx, composesFromTags, markers) {
+function reportClassStateInteractions(ctx, stateTags, allowedStates) {
     var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
     try {
-        for(var _iterator = composesFromTags[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+        for(var _iterator = stateTags[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
             var tag = _step.value;
             var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
             try {
                 for(var _iterator1 = splitCommaSeparated(tag.description)[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
                     var item = _step1.value;
-                    if (!KEBAB_SLUG_PATTERN.test(item)) {
+                    if (!allowedStates.includes(item)) {
                         reportOnJsdocLine({
                             commentNode: ctx.commentNode,
                             parsed: ctx.parsed,
                             sourceCode: ctx.sourceCode,
                             lineIndex: tag.startLineIndex,
-                            messageId: 'composesFromNotKebab',
+                            messageId: 'invalidStateValue',
                             data: {
-                                value: item
+                                value: item,
+                                allowed: allowedStates.join(', ')
                             },
                             report: ctx.report
                         });
@@ -7542,114 +7232,137 @@ function reportFormComposesFromKebab(ctx, composesFromTags, markers) {
             }
         }
     }
-    var _iteratorNormalCompletion2 = true, _didIteratorError2 = false, _iteratorError2 = undefined;
+}
+function reportClassSkillRefs(ctx, skillRefsTags) {
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
     try {
-        for(var _iterator2 = markers[Symbol.iterator](), _step2; !(_iteratorNormalCompletion2 = (_step2 = _iterator2.next()).done); _iteratorNormalCompletion2 = true){
-            var m = _step2.value;
-            if (!COMPOSES_FROM_MARKERS.has(m.tag)) continue;
-            var _iteratorNormalCompletion3 = true, _didIteratorError3 = false, _iteratorError3 = undefined;
+        for(var _iterator = skillRefsTags[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var tag = _step.value;
+            var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
             try {
-                for(var _iterator3 = splitCommaSeparated(m.description)[Symbol.iterator](), _step3; !(_iteratorNormalCompletion3 = (_step3 = _iterator3.next()).done); _iteratorNormalCompletion3 = true){
-                    var item1 = _step3.value;
-                    if (!KEBAB_SLUG_PATTERN.test(item1)) {
+                for(var _iterator1 = splitCommaSeparated(tag.description)[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                    var item = _step1.value;
+                    if (!KEBAB_SLUG_PATTERN.test(item)) {
                         reportOnJsdocLine({
                             commentNode: ctx.commentNode,
                             parsed: ctx.parsed,
                             sourceCode: ctx.sourceCode,
-                            lineIndex: m.startLineIndex,
-                            messageId: 'composesFromNotKebab',
+                            lineIndex: tag.startLineIndex,
+                            messageId: 'skillRefsNotKebab',
                             data: {
-                                value: item1
+                                value: item
                             },
                             report: ctx.report
                         });
                     }
                 }
             } catch (err) {
-                _didIteratorError3 = true;
-                _iteratorError3 = err;
+                _didIteratorError1 = true;
+                _iteratorError1 = err;
             } finally{
                 try {
-                    if (!_iteratorNormalCompletion3 && _iterator3.return != null) {
-                        _iterator3.return();
+                    if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                        _iterator1.return();
                     }
                 } finally{
-                    if (_didIteratorError3) {
-                        throw _iteratorError3;
+                    if (_didIteratorError1) {
+                        throw _iteratorError1;
                     }
                 }
             }
         }
     } catch (err) {
-        _didIteratorError2 = true;
-        _iteratorError2 = err;
+        _didIteratorError = true;
+        _iteratorError = err;
     } finally{
         try {
-            if (!_iteratorNormalCompletion2 && _iterator2.return != null) {
-                _iterator2.return();
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
             }
         } finally{
-            if (_didIteratorError2) {
-                throw _iteratorError2;
+            if (_didIteratorError) {
+                throw _iteratorError;
             }
         }
     }
 }
 /**
- * ESLint rule enforcing `@dbxFormField` companion tags. Mirrors the scanner
- * schema at `packages/dbx-components-mcp/src/scan/forge-fields-extract.ts`,
- * including the tier-conditional required-tag matrix.
- */ var UTIL_REQUIRE_DBX_FORM_FIELD_COMPANION_TAGS_RULE = {
+ * Splits an `@dbxAction`-family JSDoc into its marker tag and the map of
+ * companion tags keyed by their suffix (e.g. `Slug`, `Role`).
+ *
+ * @param parsed - The parsed JSDoc to inspect.
+ * @returns The marker tag (if any) and a map of companion suffix to tag instances.
+ */ function collectFamilyTags(parsed) {
+    var markerTag = parsed.tags.find(function(t) {
+        return t.tag === 'dbxAction';
+    });
+    var groups = new Map();
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = parsed.tags[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var tag = _step.value;
+            var _groups_get;
+            if (!tag.tag.startsWith('dbxAction') || tag.tag === 'dbxAction') continue;
+            var suffix = tag.tag.slice('dbxAction'.length);
+            var list = (_groups_get = groups.get(suffix)) !== null && _groups_get !== void 0 ? _groups_get : [];
+            list.push(tag);
+            groups.set(suffix, list);
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    return {
+        markerTag: markerTag,
+        companions: groups
+    };
+}
+/**
+ * ESLint rule enforcing `@dbxAction` companion tags. Mirrors the scanner
+ * schema at `packages/dbx-cli/src/lib/mcp-scan/scan/actions-extract.ts`. Class
+ * declarations carry the `@dbxAction` marker; enum declarations carry the
+ * `@dbxActionStateEnum` marker, and `@dbxActionStateTransitionsFrom/To` are
+ * valid on enum-member JSDocs.
+ */ var UTIL_REQUIRE_DBX_ACTION_COMPANION_TAGS_RULE = {
     meta: {
         type: 'suggestion',
         fixable: 'code',
         docs: {
-            description: 'Require the canonical `@dbxForm*` companion tags on `@dbxFormField`-tagged factories.',
+            description: 'Require the canonical `@dbxAction*` companion tags on `@dbxAction`-tagged classes and `@dbxActionStateEnum`-tagged enums.',
             recommended: true
         },
         messages: {
-            duplicateMarker: '`@dbxFormField` / `@dbxFormFieldDerivative` / `@dbxFormFieldTemplate` are mutually exclusive; only one is allowed.',
-            missingTier: '`@dbxFormField`-tagged factory is missing the required `@dbxFormTier <tier>` companion tag.',
-            invalidTier: '`@dbxFormTier` value `{{value}}` is not allowed. Use one of: {{allowed}}.',
-            missingSlug: '`@dbxFormField`-tagged factory is missing the required `@dbxFormSlug <slug>` companion tag.',
-            invalidSlugFormat: '`@dbxFormSlug` value `{{value}}` is not a valid kebab-case slug.',
-            missingProduces: '`@dbxFormField`-tagged factory is missing the required `@dbxFormProduces <type>` companion tag.',
-            missingArrayOutput: '`@dbxFormField`-tagged factory is missing the required `@dbxFormArrayOutput <yes|no|optional>` companion tag.',
-            invalidArrayOutput: '`@dbxFormArrayOutput` value `{{value}}` is not allowed. Use one of: {{allowed}}.',
-            missingWrapperPattern: 'field-factory tier requires `@dbxFormWrapperPattern <unwrapped|material-form-field-wrapped>`.',
-            invalidWrapperPattern: '`@dbxFormWrapperPattern` value `{{value}}` is not allowed. Use one of: {{allowed}}.',
-            missingNgFormType: 'field-factory tier requires `@dbxFormNgFormType <type>`.',
-            missingSuffix: 'composite-builder tier requires `@dbxFormSuffix <Row|Group|Fields|Field|Wrapper|Layout>`.',
-            invalidSuffix: '`@dbxFormSuffix` value `{{value}}` is not allowed. Use one of: {{allowed}}.',
-            missingComposesFrom: '`@dbxFormFieldDerivative` / `@dbxFormFieldTemplate` require `@dbxFormComposesFrom <slug,...>`.',
-            composesFromNotKebab: '`@dbxFormComposesFrom` item `{{value}}` is not a kebab-case slug.',
-            unknownDbxFormTag: '`@dbxForm{{name}}` is not a recognized companion tag. Known companions: {{known}}.',
-            duplicateCompanionTag: '`@dbxForm{{name}}` is declared more than once.'
+            missingSlug: '`@dbxAction`-tagged class is missing the required `@dbxActionSlug <slug>` companion tag.',
+            invalidSlugFormat: '`@dbxActionSlug` value `{{value}}` is not a valid kebab-case slug.',
+            invalidRole: '`@dbxActionRole` value `{{value}}` is not allowed. Use one of: {{allowed}}.',
+            invalidStateValue: '`@dbxActionStateInteraction` value `{{value}}` is not a valid state. Use one of: {{allowed}}.',
+            skillRefsNotKebab: '`@dbxActionSkillRefs` item `{{value}}` is not a kebab-case slug.',
+            stateTagOutsideEnumMember: '`@dbxAction{{name}}` is only valid on enum members of a `@dbxActionStateEnum`-tagged enum.',
+            unknownDbxActionTag: '`@dbxAction{{name}}` is not a recognized companion tag. Known companions: {{known}}.',
+            duplicateCompanionTag: '`@dbxAction{{name}}` is declared more than once.'
         },
         schema: [
             {
                 type: 'object',
                 additionalProperties: false,
                 properties: {
-                    allowedTiers: {
-                        type: 'array',
-                        items: {
-                            type: 'string'
-                        }
-                    },
-                    allowedWrapperPatterns: {
-                        type: 'array',
-                        items: {
-                            type: 'string'
-                        }
-                    },
-                    allowedSuffixes: {
+                    allowedRoles: {
                         type: 'array',
                         items: {
                             type: 'string'
                         }
                     },
-                    allowedArrayOutputs: {
+                    allowedStates: {
                         type: 'array',
                         items: {
                             type: 'string'
@@ -7669,87 +7382,104 @@ function reportFormComposesFromKebab(ctx, composesFromTags, markers) {
         ]
     },
     create: function create(context) {
-        var _context_options_, _options_allowedTiers, _options_allowedWrapperPatterns, _options_allowedSuffixes, _options_allowedArrayOutputs, _options_knownCompanions;
+        var _context_options_, _options_allowedRoles, _options_allowedStates, _options_knownCompanions;
         var options = (_context_options_ = context.options[0]) !== null && _context_options_ !== void 0 ? _context_options_ : {};
         var sourceCode = context.sourceCode;
-        var allowedTiers = (_options_allowedTiers = options.allowedTiers) !== null && _options_allowedTiers !== void 0 ? _options_allowedTiers : DEFAULT_ALLOWED_TIERS;
-        var allowedWrapperPatterns = (_options_allowedWrapperPatterns = options.allowedWrapperPatterns) !== null && _options_allowedWrapperPatterns !== void 0 ? _options_allowedWrapperPatterns : DEFAULT_ALLOWED_WRAPPER_PATTERNS;
-        var allowedSuffixes = (_options_allowedSuffixes = options.allowedSuffixes) !== null && _options_allowedSuffixes !== void 0 ? _options_allowedSuffixes : DEFAULT_ALLOWED_SUFFIXES;
-        var allowedArrayOutputs = (_options_allowedArrayOutputs = options.allowedArrayOutputs) !== null && _options_allowedArrayOutputs !== void 0 ? _options_allowedArrayOutputs : DEFAULT_ALLOWED_ARRAY_OUTPUTS;
-        var knownCompanions = (_options_knownCompanions = options.knownCompanions) !== null && _options_knownCompanions !== void 0 ? _options_knownCompanions : DEFAULT_KNOWN_COMPANIONS$2;
+        var allowedRoles = (_options_allowedRoles = options.allowedRoles) !== null && _options_allowedRoles !== void 0 ? _options_allowedRoles : DEFAULT_ALLOWED_ROLES;
+        var allowedStates = (_options_allowedStates = options.allowedStates) !== null && _options_allowedStates !== void 0 ? _options_allowedStates : DEFAULT_ALLOWED_STATES;
+        var knownCompanions = (_options_knownCompanions = options.knownCompanions) !== null && _options_knownCompanions !== void 0 ? _options_knownCompanions : DEFAULT_KNOWN_COMPANIONS$3;
         var requireBareMarker = options.requireBareMarker !== false;
-        function checkJsdoc(commentNode) {
-            var _ref, _companions_get, _companions_get1, _companions_get2, _companions_get3, _companions_get4;
-            var _markers_;
+        function checkClassJsdoc(commentNode) {
+            var _ref, _companions_get, _companions_get1, _companions_get2, _companions_get3;
+            var _this, _Array_from_;
             var parsed = parseJsdocComment(commentNode.value);
-            var _collectFormTags = collectFormTags(parsed), markers = _collectFormTags.markers, companions = _collectFormTags.companions;
-            if (markers.length === 0 && companions.size === 0 || requireBareMarker && markers.length === 0) return;
+            var _collectFamilyTags = collectFamilyTags(parsed), markerTag = _collectFamilyTags.markerTag, companions = _collectFamilyTags.companions;
+            if (!markerTag && companions.size === 0 || requireBareMarker && !markerTag) return;
             var ctx = {
                 commentNode: commentNode,
                 parsed: parsed,
                 sourceCode: sourceCode,
                 report: context.report
             };
-            var triggerLine = (_ref = (_markers_ = markers[0]) === null || _markers_ === void 0 ? void 0 : _markers_.startLineIndex) !== null && _ref !== void 0 ? _ref : 0;
-            reportFormDuplicateMarkers(ctx, markers);
-            reportFormUnknownCompanions(ctx, companions, knownCompanions);
-            reportFormDuplicateCompanions(ctx, companions);
-            reportFormSlug(ctx, (_companions_get = companions.get('Slug')) !== null && _companions_get !== void 0 ? _companions_get : [], triggerLine);
-            reportFormProduces(ctx, (_companions_get1 = companions.get('Produces')) !== null && _companions_get1 !== void 0 ? _companions_get1 : [], triggerLine);
-            reportFormArrayOutput({
-                ctx: ctx,
-                arrayOutputTags: (_companions_get2 = companions.get('ArrayOutput')) !== null && _companions_get2 !== void 0 ? _companions_get2 : [],
-                allowedArrayOutputs: allowedArrayOutputs,
-                triggerLine: triggerLine
+            var triggerLine = (_ref = (_this = markerTag !== null && markerTag !== void 0 ? markerTag : (_Array_from_ = Array.from(companions.values())[0]) === null || _Array_from_ === void 0 ? void 0 : _Array_from_[0]) === null || _this === void 0 ? void 0 : _this.startLineIndex) !== null && _ref !== void 0 ? _ref : 0;
+            reportClassUnknownAndMisplaced(ctx, companions, knownCompanions);
+            reportClassDuplicates(ctx, companions);
+            reportClassSlug(ctx, (_companions_get = companions.get('Slug')) !== null && _companions_get !== void 0 ? _companions_get : [], triggerLine);
+            reportClassRoles(ctx, (_companions_get1 = companions.get('Role')) !== null && _companions_get1 !== void 0 ? _companions_get1 : [], allowedRoles);
+            reportClassStateInteractions(ctx, (_companions_get2 = companions.get('StateInteraction')) !== null && _companions_get2 !== void 0 ? _companions_get2 : [], allowedStates);
+            reportClassSkillRefs(ctx, (_companions_get3 = companions.get('SkillRefs')) !== null && _companions_get3 !== void 0 ? _companions_get3 : []);
+        }
+        function checkEnumMemberJsdoc(commentNode) {
+            var parsed = parseJsdocComment(commentNode.value);
+            var fromTags = parsed.tags.filter(function(t) {
+                return t.tag === 'dbxActionStateTransitionsFrom';
             });
-            var tierTags = (_companions_get3 = companions.get('Tier')) !== null && _companions_get3 !== void 0 ? _companions_get3 : [];
-            var tier = determineTier(markers, tierTags);
-            reportFormTier({
-                ctx: ctx,
-                markers: markers,
-                tierTags: tierTags,
-                tier: tier,
-                allowedTiers: allowedTiers,
-                triggerLine: triggerLine
+            var toTags = parsed.tags.filter(function(t) {
+                return t.tag === 'dbxActionStateTransitionsTo';
             });
-            var composesFromTags = (_companions_get4 = companions.get('ComposesFrom')) !== null && _companions_get4 !== void 0 ? _companions_get4 : [];
-            if (tier === 'field-factory') {
-                reportFormFieldFactoryTier({
-                    ctx: ctx,
-                    companions: companions,
-                    allowedWrapperPatterns: allowedWrapperPatterns,
-                    triggerLine: triggerLine
-                });
-            } else if (tier === 'composite-builder') {
-                var _companions_get5;
-                reportFormCompositeBuilderTier({
-                    ctx: ctx,
-                    suffixTags: (_companions_get5 = companions.get('Suffix')) !== null && _companions_get5 !== void 0 ? _companions_get5 : [],
-                    allowedSuffixes: allowedSuffixes,
-                    triggerLine: triggerLine
-                });
-            } else if (tier === 'field-derivative' || tier === 'template-builder') {
-                reportFormDerivativeTier({
-                    ctx: ctx,
-                    markers: markers,
-                    composesFromTags: composesFromTags,
-                    triggerLine: triggerLine
-                });
+            var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+            try {
+                for(var _iterator = _to_consumable_array(fromTags).concat(_to_consumable_array(toTags))[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                    var tag = _step.value;
+                    var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+                    try {
+                        for(var _iterator1 = splitCommaSeparated(tag.description)[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                            var item = _step1.value;
+                            if (!allowedStates.includes(item)) reportOnJsdocLine({
+                                commentNode: commentNode,
+                                parsed: parsed,
+                                sourceCode: sourceCode,
+                                lineIndex: tag.startLineIndex,
+                                messageId: 'invalidStateValue',
+                                data: {
+                                    value: item,
+                                    allowed: allowedStates.join(', ')
+                                },
+                                report: context.report
+                            });
+                        }
+                    } catch (err) {
+                        _didIteratorError1 = true;
+                        _iteratorError1 = err;
+                    } finally{
+                        try {
+                            if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                                _iterator1.return();
+                            }
+                        } finally{
+                            if (_didIteratorError1) {
+                                throw _iteratorError1;
+                            }
+                        }
+                    }
+                }
+            } catch (err) {
+                _didIteratorError = true;
+                _iteratorError = err;
+            } finally{
+                try {
+                    if (!_iteratorNormalCompletion && _iterator.return != null) {
+                        _iterator.return();
+                    }
+                } finally{
+                    if (_didIteratorError) {
+                        throw _iteratorError;
+                    }
+                }
             }
-            reportFormComposesFromKebab(ctx, composesFromTags, markers);
         }
-        function visit(node) {
+        function visitClass(node) {
             var anchor = node.parent && (node.parent.type === 'ExportNamedDeclaration' || node.parent.type === 'ExportDefaultDeclaration') ? node.parent : node;
             var jsdoc = leadingJsdocFor(sourceCode, anchor);
-            if (jsdoc) checkJsdoc(jsdoc);
+            if (jsdoc) checkClassJsdoc(jsdoc);
+        }
+        function visitEnumMember(node) {
+            var jsdoc = leadingJsdocFor(sourceCode, node);
+            if (jsdoc) checkEnumMemberJsdoc(jsdoc);
         }
         return {
-            FunctionDeclaration: function FunctionDeclaration(node) {
-                if (!node.body) return;
-                var jsdoc = leadingJsdocFor(sourceCode, getStatementAnchor(node));
-                if (jsdoc) checkJsdoc(jsdoc);
-            },
-            VariableDeclaration: visit
+            ClassDeclaration: visitClass,
+            TSEnumMember: visitEnumMember
         };
     }
 };
@@ -7800,83 +7530,75 @@ function _unsupported_iterable_to_array$3(o, minLen) {
     if (n === "Map" || n === "Set") return Array.from(n);
     if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$3(o, minLen);
 }
-var MODEL_MARKERS = new Set([
-    'dbxModel',
-    'dbxModelSubObject',
-    'dbxModelOrganizationalGroupRoot',
-    'dbxModelGroup'
+var FORM_MARKERS = new Set([
+    'dbxFormField',
+    'dbxFormFieldDerivative',
+    'dbxFormFieldTemplate'
 ]);
-var EXCLUSIVE_MODEL_MARKERS = new Set([
-    'dbxModel',
-    'dbxModelSubObject',
-    'dbxModelOrganizationalGroupRoot'
+var COMPOSES_FROM_MARKERS = new Set([
+    'dbxFormFieldDerivative',
+    'dbxFormFieldTemplate'
 ]);
-var MODEL_COMPANIONS = [
-    'Archetype',
-    'AggregatesFrom',
-    'CompositeKey'
+var DEFAULT_ALLOWED_TIERS = [
+    'field-factory',
+    'field-derivative',
+    'composite-builder',
+    'template-builder',
+    'primitive'
 ];
-var PROPERTY_COMPANIONS = [
-    'Variable',
-    'VariableSyncFlag'
+var DEFAULT_ALLOWED_WRAPPER_PATTERNS = [
+    'unwrapped',
+    'material-form-field-wrapped'
 ];
-var DEFAULT_ALLOWED_ENCODINGS = [
-    'two-way',
-    'one-way'
+var DEFAULT_ALLOWED_SUFFIXES = [
+    'Row',
+    'Group',
+    'Fields',
+    'Field',
+    'Wrapper',
+    'Layout'
 ];
-var ARCHETYPE_SLUG_PATTERN = /^[a-z][a-z0-9-]*$/;
-var ARCHETYPE_AXIS_PATTERN = /^([A-Za-z_$][A-Za-z0-9_$]*)=([^,]+)$/;
-function reportMutuallyExclusiveMarkers(ctx, markers) {
-    var exclusiveMarkers = markers.filter(function(m) {
-        return EXCLUSIVE_MODEL_MARKERS.has(m.tag);
-    });
-    if (exclusiveMarkers.length <= 1) return;
-    for(var i = 1; i < exclusiveMarkers.length; i += 1){
-        reportOnJsdocLine({
-            commentNode: ctx.commentNode,
-            parsed: ctx.parsed,
-            sourceCode: ctx.sourceCode,
-            lineIndex: exclusiveMarkers[i].startLineIndex,
-            messageId: 'mutuallyExclusiveMarkers',
-            report: ctx.report
-        });
-    }
-}
-function reportPropertyOnlyTags(ctx, companions) {
+var DEFAULT_ALLOWED_ARRAY_OUTPUTS = [
+    'yes',
+    'no',
+    'optional'
+];
+var DEFAULT_KNOWN_COMPANIONS$2 = [
+    'Slug',
+    'Tier',
+    'Produces',
+    'ArrayOutput',
+    'WrapperPattern',
+    'NgFormType',
+    'Suffix',
+    'Returns',
+    'ComposesFrom',
+    'ConfigInterface',
+    'PropsInterface',
+    'Generic',
+    'PropName'
+];
+/**
+ * Splits a `@dbxFormField` JSDoc into its marker tags and the map of
+ * `@dbxForm*` companion tags keyed by their suffix.
+ *
+ * @param parsed - The parsed JSDoc to inspect.
+ * @returns The list of marker tags and the map of companion suffix to tag instances.
+ */ function collectFormTags(parsed) {
+    var markers = [];
+    var companions = new Map();
     var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
     try {
-        for(var _iterator = PROPERTY_COMPANIONS[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var propOnly = _step.value;
-            var _companions_get;
-            var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
-            try {
-                for(var _iterator1 = ((_companions_get = companions.get(propOnly)) !== null && _companions_get !== void 0 ? _companions_get : [])[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
-                    var tag = _step1.value;
-                    reportOnJsdocLine({
-                        commentNode: ctx.commentNode,
-                        parsed: ctx.parsed,
-                        sourceCode: ctx.sourceCode,
-                        lineIndex: tag.startLineIndex,
-                        messageId: 'variableTagOutsideProperty',
-                        data: {
-                            name: propOnly
-                        },
-                        report: ctx.report
-                    });
-                }
-            } catch (err) {
-                _didIteratorError1 = true;
-                _iteratorError1 = err;
-            } finally{
-                try {
-                    if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
-                        _iterator1.return();
-                    }
-                } finally{
-                    if (_didIteratorError1) {
-                        throw _iteratorError1;
-                    }
-                }
+        for(var _iterator = parsed.tags[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var tag = _step.value;
+            if (FORM_MARKERS.has(tag.tag)) {
+                markers.push(tag);
+            } else if (tag.tag.startsWith('dbxForm') && !tag.tag.startsWith('dbxFormField')) {
+                var _companions_get;
+                var suffix = tag.tag.slice('dbxForm'.length);
+                var list = (_companions_get = companions.get(suffix)) !== null && _companions_get !== void 0 ? _companions_get : [];
+                list.push(tag);
+                companions.set(suffix, list);
             }
         }
     } catch (err) {
@@ -7893,13 +7615,67 @@ function reportPropertyOnlyTags(ctx, companions) {
             }
         }
     }
+    return {
+        markers: markers,
+        companions: companions
+    };
+}
+/**
+ * Resolves the effective tier for a `@dbxFormField`-family JSDoc by
+ * preferring marker-derived tiers (e.g. `@dbxFormFieldDerivative` →
+ * `'field-derivative'`) and falling back to the first `@dbxFormTier`.
+ *
+ * @param markers - The marker tags found on the JSDoc.
+ * @param tierTags - Any explicit `@dbxFormTier` tags found on the JSDoc.
+ * @returns The resolved tier, or `undefined` when none is present.
+ */ function determineTier(markers, tierTags) {
+    // Marker-derived tier takes precedence; `@dbxFormFieldDerivative` → 'field-derivative', `@dbxFormFieldTemplate` → 'template-builder'.
+    // `@dbxFormField` requires an explicit `@dbxFormTier`.
+    var derived;
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = markers[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var m = _step.value;
+            if (m.tag === 'dbxFormFieldDerivative') derived = 'field-derivative';
+            else if (m.tag === 'dbxFormFieldTemplate') derived = 'template-builder';
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    if (derived !== undefined) {
+        return derived;
+    }
+    return tierTags.length > 0 ? tierTags[0].description.trim() : undefined;
+}
+function reportFormDuplicateMarkers(ctx, markers) {
+    if (markers.length <= 1) return;
+    for(var i = 1; i < markers.length; i += 1){
+        reportOnJsdocLine({
+            commentNode: ctx.commentNode,
+            parsed: ctx.parsed,
+            sourceCode: ctx.sourceCode,
+            lineIndex: markers[i].startLineIndex,
+            messageId: 'duplicateMarker',
+            report: ctx.report
+        });
+    }
 }
-function reportUnknownModelCompanions(ctx, companions, knownCompanions) {
+function reportFormUnknownCompanions(ctx, companions, knownCompanions) {
     var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
     try {
         for(var _iterator = companions.entries()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
             var _step_value = _sliced_to_array$3(_step.value, 2), suffix = _step_value[0], instances = _step_value[1];
-            if (PROPERTY_COMPANIONS.includes(suffix)) continue;
             if (knownCompanions.includes(suffix)) continue;
             var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
             try {
@@ -7910,7 +7686,7 @@ function reportUnknownModelCompanions(ctx, companions, knownCompanions) {
                         parsed: ctx.parsed,
                         sourceCode: ctx.sourceCode,
                         lineIndex: tag.startLineIndex,
-                        messageId: 'unknownDbxModelTag',
+                        messageId: 'unknownDbxFormTag',
                         data: {
                             name: suffix,
                             known: knownCompanions.join(', ')
@@ -7948,14 +7724,11 @@ function reportUnknownModelCompanions(ctx, companions, knownCompanions) {
         }
     }
 }
-function reportModelDuplicates(ctx, companions, knownCompanions) {
+function reportFormDuplicateCompanions(ctx, companions) {
     var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
     try {
-        for(var _iterator = knownCompanions[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var suffix = _step.value;
-            var _companions_get;
-            if (suffix === 'Archetype') continue; // archetypes are repeatable.
-            var instances = (_companions_get = companions.get(suffix)) !== null && _companions_get !== void 0 ? _companions_get : [];
+        for(var _iterator = companions.entries()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var _step_value = _sliced_to_array$3(_step.value, 2), suffix = _step_value[0], instances = _step_value[1];
             if (instances.length <= 1) continue;
             for(var i = 1; i < instances.length; i += 1){
                 reportOnJsdocLine({
@@ -7986,180 +7759,246 @@ function reportModelDuplicates(ctx, companions, knownCompanions) {
         }
     }
 }
-function reportArchetypeTag(ctx, tag) {
-    var text = tag.description.trim();
-    if (text.length === 0) return;
-    var spaceIdx = text.indexOf(' ');
-    var slug = spaceIdx >= 0 ? text.slice(0, spaceIdx).trim() : text;
-    if (!ARCHETYPE_SLUG_PATTERN.test(slug)) {
+function reportFormSlug(ctx, slugTags, triggerLine) {
+    if (slugTags.length === 0) {
+        reportOnJsdocLine({
+            commentNode: ctx.commentNode,
+            parsed: ctx.parsed,
+            sourceCode: ctx.sourceCode,
+            lineIndex: triggerLine,
+            messageId: 'missingSlug',
+            report: ctx.report
+        });
+        return;
+    }
+    var value = slugTags[0].description.trim();
+    if (value.length === 0) {
+        reportOnJsdocLine({
+            commentNode: ctx.commentNode,
+            parsed: ctx.parsed,
+            sourceCode: ctx.sourceCode,
+            lineIndex: slugTags[0].startLineIndex,
+            messageId: 'missingSlug',
+            report: ctx.report
+        });
+    } else if (!KEBAB_SLUG_PATTERN.test(value)) {
         reportOnJsdocLine({
             commentNode: ctx.commentNode,
             parsed: ctx.parsed,
             sourceCode: ctx.sourceCode,
-            lineIndex: tag.startLineIndex,
-            messageId: 'archetypeBadSlug',
+            lineIndex: slugTags[0].startLineIndex,
+            messageId: 'invalidSlugFormat',
             data: {
-                value: slug
+                value: value
             },
             report: ctx.report
         });
+    }
+}
+function reportFormProduces(ctx, producesTags, triggerLine) {
+    if (producesTags.length === 0 || producesTags[0].description.trim().length === 0) {
+        reportOnJsdocLine({
+            commentNode: ctx.commentNode,
+            parsed: ctx.parsed,
+            sourceCode: ctx.sourceCode,
+            lineIndex: triggerLine,
+            messageId: 'missingProduces',
+            report: ctx.report
+        });
+    }
+}
+function reportFormArrayOutput(input) {
+    var ctx = input.ctx, arrayOutputTags = input.arrayOutputTags, allowedArrayOutputs = input.allowedArrayOutputs, triggerLine = input.triggerLine;
+    if (arrayOutputTags.length === 0 || arrayOutputTags[0].description.trim().length === 0) {
+        reportOnJsdocLine({
+            commentNode: ctx.commentNode,
+            parsed: ctx.parsed,
+            sourceCode: ctx.sourceCode,
+            lineIndex: triggerLine,
+            messageId: 'missingArrayOutput',
+            report: ctx.report
+        });
         return;
     }
-    if (spaceIdx < 0) return;
-    var rest = text.slice(spaceIdx + 1).trim();
-    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-    try {
-        for(var _iterator = rest.split(',')[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var pair = _step.value;
-            var trimmed = pair.trim();
-            if (trimmed.length === 0) continue;
-            if (!ARCHETYPE_AXIS_PATTERN.test(trimmed)) {
-                reportOnJsdocLine({
-                    commentNode: ctx.commentNode,
-                    parsed: ctx.parsed,
-                    sourceCode: ctx.sourceCode,
-                    lineIndex: tag.startLineIndex,
-                    messageId: 'archetypeBadAxisPair',
-                    data: {
-                        value: trimmed
-                    },
-                    report: ctx.report
-                });
-            }
-        }
-    } catch (err) {
-        _didIteratorError = true;
-        _iteratorError = err;
-    } finally{
-        try {
-            if (!_iteratorNormalCompletion && _iterator.return != null) {
-                _iterator.return();
-            }
-        } finally{
-            if (_didIteratorError) {
-                throw _iteratorError;
-            }
-        }
+    var value = arrayOutputTags[0].description.trim();
+    if (!allowedArrayOutputs.includes(value)) {
+        reportOnJsdocLine({
+            commentNode: ctx.commentNode,
+            parsed: ctx.parsed,
+            sourceCode: ctx.sourceCode,
+            lineIndex: arrayOutputTags[0].startLineIndex,
+            messageId: 'invalidArrayOutput',
+            data: {
+                value: value,
+                allowed: allowedArrayOutputs.join(', ')
+            },
+            report: ctx.report
+        });
     }
 }
-function reportCompositeKeyTag(ctx, tag, allowedEncodings) {
-    var text = tag.description.trim();
-    if (text.length === 0) {
+function reportFormTier(input) {
+    var ctx = input.ctx, markers = input.markers, tierTags = input.tierTags, tier = input.tier, allowedTiers = input.allowedTiers, triggerLine = input.triggerLine;
+    if (!markers.some(function(m) {
+        return m.tag === 'dbxFormField';
+    })) return;
+    if (tier == null) {
+        reportOnJsdocLine({
+            commentNode: ctx.commentNode,
+            parsed: ctx.parsed,
+            sourceCode: ctx.sourceCode,
+            lineIndex: triggerLine,
+            messageId: 'missingTier',
+            report: ctx.report
+        });
+    } else if (!allowedTiers.includes(tier)) {
+        var _ref;
+        var _tierTags_;
         reportOnJsdocLine({
             commentNode: ctx.commentNode,
             parsed: ctx.parsed,
             sourceCode: ctx.sourceCode,
-            lineIndex: tag.startLineIndex,
-            messageId: 'compositeKeyMissingFrom',
+            lineIndex: (_ref = (_tierTags_ = tierTags[0]) === null || _tierTags_ === void 0 ? void 0 : _tierTags_.startLineIndex) !== null && _ref !== void 0 ? _ref : triggerLine,
+            messageId: 'invalidTier',
+            data: {
+                value: tier,
+                allowed: allowedTiers.join(', ')
+            },
             report: ctx.report
         });
+    }
+}
+function reportFormWrapperPattern(input) {
+    var ctx = input.ctx, wrapperTags = input.wrapperTags, allowedWrapperPatterns = input.allowedWrapperPatterns, triggerLine = input.triggerLine;
+    if (wrapperTags.length === 0 || wrapperTags[0].description.trim().length === 0) {
         reportOnJsdocLine({
             commentNode: ctx.commentNode,
             parsed: ctx.parsed,
             sourceCode: ctx.sourceCode,
-            lineIndex: tag.startLineIndex,
-            messageId: 'compositeKeyMissingEncoding',
+            lineIndex: triggerLine,
+            messageId: 'missingWrapperPattern',
             report: ctx.report
         });
         return;
     }
-    var hasFrom = false;
-    var encoding;
-    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-    try {
-        for(var _iterator = text.split(/\s+/)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var token = _step.value;
-            var eq = token.indexOf('=');
-            if (eq <= 0) continue;
-            var key = token.slice(0, eq).trim();
-            var value = token.slice(eq + 1).trim();
-            if (key === 'from' && value.length > 0) hasFrom = true;
-            else if (key === 'encoding') encoding = value;
-        }
-    } catch (err) {
-        _didIteratorError = true;
-        _iteratorError = err;
-    } finally{
-        try {
-            if (!_iteratorNormalCompletion && _iterator.return != null) {
-                _iterator.return();
-            }
-        } finally{
-            if (_didIteratorError) {
-                throw _iteratorError;
-            }
-        }
+    var value = wrapperTags[0].description.trim();
+    if (!allowedWrapperPatterns.includes(value)) {
+        reportOnJsdocLine({
+            commentNode: ctx.commentNode,
+            parsed: ctx.parsed,
+            sourceCode: ctx.sourceCode,
+            lineIndex: wrapperTags[0].startLineIndex,
+            messageId: 'invalidWrapperPattern',
+            data: {
+                value: value,
+                allowed: allowedWrapperPatterns.join(', ')
+            },
+            report: ctx.report
+        });
     }
-    if (!hasFrom) {
+}
+function reportFormFieldFactoryTier(input) {
+    var _companions_get, _companions_get1;
+    var ctx = input.ctx, companions = input.companions, allowedWrapperPatterns = input.allowedWrapperPatterns, triggerLine = input.triggerLine;
+    reportFormWrapperPattern({
+        ctx: ctx,
+        wrapperTags: (_companions_get = companions.get('WrapperPattern')) !== null && _companions_get !== void 0 ? _companions_get : [],
+        allowedWrapperPatterns: allowedWrapperPatterns,
+        triggerLine: triggerLine
+    });
+    var ngFormTags = (_companions_get1 = companions.get('NgFormType')) !== null && _companions_get1 !== void 0 ? _companions_get1 : [];
+    if (ngFormTags.length === 0 || ngFormTags[0].description.trim().length === 0) {
         reportOnJsdocLine({
             commentNode: ctx.commentNode,
             parsed: ctx.parsed,
             sourceCode: ctx.sourceCode,
-            lineIndex: tag.startLineIndex,
-            messageId: 'compositeKeyMissingFrom',
+            lineIndex: triggerLine,
+            messageId: 'missingNgFormType',
             report: ctx.report
         });
     }
-    if (encoding == null) {
+}
+function reportFormCompositeBuilderTier(input) {
+    var ctx = input.ctx, suffixTags = input.suffixTags, allowedSuffixes = input.allowedSuffixes, triggerLine = input.triggerLine;
+    if (suffixTags.length === 0 || suffixTags[0].description.trim().length === 0) {
         reportOnJsdocLine({
             commentNode: ctx.commentNode,
             parsed: ctx.parsed,
             sourceCode: ctx.sourceCode,
-            lineIndex: tag.startLineIndex,
-            messageId: 'compositeKeyMissingEncoding',
+            lineIndex: triggerLine,
+            messageId: 'missingSuffix',
             report: ctx.report
         });
-    } else if (!allowedEncodings.includes(encoding)) {
+        return;
+    }
+    var value = suffixTags[0].description.trim();
+    if (!allowedSuffixes.includes(value)) {
         reportOnJsdocLine({
             commentNode: ctx.commentNode,
             parsed: ctx.parsed,
             sourceCode: ctx.sourceCode,
-            lineIndex: tag.startLineIndex,
-            messageId: 'compositeKeyInvalidEncoding',
+            lineIndex: suffixTags[0].startLineIndex,
+            messageId: 'invalidSuffix',
             data: {
-                value: encoding,
-                allowed: allowedEncodings.join(', ')
+                value: value,
+                allowed: allowedSuffixes.join(', ')
             },
             report: ctx.report
         });
     }
 }
-/**
- * Splits an interface JSDoc into the marker tags from `MODEL_MARKERS` and the
- * map of `@dbxModel*` companion tags keyed by suffix. Property-only companions
- * (`Variable`, `VariableSyncFlag`) are still surfaced so the caller can flag them
- * as misplaced when found on an interface JSDoc.
- *
- * @param parsed - The parsed JSDoc to inspect.
- * @returns The list of marker tags and the map of companion suffix to tag instances.
- */ function collectInterfaceTags(parsed) {
-    var markers = [];
-    var companions = new Map();
+function reportFormDerivativeTier(input) {
+    var ctx = input.ctx, markers = input.markers, composesFromTags = input.composesFromTags, triggerLine = input.triggerLine;
+    var markerCarriesComposes = markers.some(function(m) {
+        return COMPOSES_FROM_MARKERS.has(m.tag) && m.description.trim().length > 0;
+    });
+    if (composesFromTags.length === 0 && !markerCarriesComposes) {
+        reportOnJsdocLine({
+            commentNode: ctx.commentNode,
+            parsed: ctx.parsed,
+            sourceCode: ctx.sourceCode,
+            lineIndex: triggerLine,
+            messageId: 'missingComposesFrom',
+            report: ctx.report
+        });
+    }
+}
+function reportFormComposesFromKebab(ctx, composesFromTags, markers) {
     var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
     try {
-        for(var _iterator = parsed.tags[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+        for(var _iterator = composesFromTags[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
             var tag = _step.value;
-            var _companions_get;
-            if (MODEL_MARKERS.has(tag.tag)) {
-                markers.push(tag);
-                continue;
-            }
-            // Property-level tags (Variable / VariableSyncFlag) on an interface JSDoc → misplaced.
-            if (tag.tag === 'dbxModelVariable' || tag.tag === 'dbxModelVariableSyncFlag') {
-                var _companions_get1;
-                var suffix = tag.tag.slice('dbxModel'.length);
-                var list = (_companions_get1 = companions.get(suffix)) !== null && _companions_get1 !== void 0 ? _companions_get1 : [];
-                list.push(tag);
-                companions.set(suffix, list);
-                continue;
+            var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+            try {
+                for(var _iterator1 = splitCommaSeparated(tag.description)[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                    var item = _step1.value;
+                    if (!KEBAB_SLUG_PATTERN.test(item)) {
+                        reportOnJsdocLine({
+                            commentNode: ctx.commentNode,
+                            parsed: ctx.parsed,
+                            sourceCode: ctx.sourceCode,
+                            lineIndex: tag.startLineIndex,
+                            messageId: 'composesFromNotKebab',
+                            data: {
+                                value: item
+                            },
+                            report: ctx.report
+                        });
+                    }
+                }
+            } catch (err) {
+                _didIteratorError1 = true;
+                _iteratorError1 = err;
+            } finally{
+                try {
+                    if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                        _iterator1.return();
+                    }
+                } finally{
+                    if (_didIteratorError1) {
+                        throw _iteratorError1;
+                    }
+                }
             }
-            if (!tag.tag.startsWith('dbxModel')) continue;
-            // Exclude tag prefixes that belong to sibling families (handled by their own rules).
-            if (tag.tag.startsWith('dbxModelSnapshotField') || tag.tag.startsWith('dbxModelFirebaseIndex')) continue;
-            var suffix1 = tag.tag.slice('dbxModel'.length);
-            var list1 = (_companions_get = companions.get(suffix1)) !== null && _companions_get !== void 0 ? _companions_get : [];
-            list1.push(tag);
-            companions.set(suffix1, list1);
         }
     } catch (err) {
         _didIteratorError = true;
@@ -8175,44 +8014,114 @@ function reportCompositeKeyTag(ctx, tag, allowedEncodings) {
             }
         }
     }
-    return {
-        markers: markers,
-        companions: companions
-    };
+    var _iteratorNormalCompletion2 = true, _didIteratorError2 = false, _iteratorError2 = undefined;
+    try {
+        for(var _iterator2 = markers[Symbol.iterator](), _step2; !(_iteratorNormalCompletion2 = (_step2 = _iterator2.next()).done); _iteratorNormalCompletion2 = true){
+            var m = _step2.value;
+            if (!COMPOSES_FROM_MARKERS.has(m.tag)) continue;
+            var _iteratorNormalCompletion3 = true, _didIteratorError3 = false, _iteratorError3 = undefined;
+            try {
+                for(var _iterator3 = splitCommaSeparated(m.description)[Symbol.iterator](), _step3; !(_iteratorNormalCompletion3 = (_step3 = _iterator3.next()).done); _iteratorNormalCompletion3 = true){
+                    var item1 = _step3.value;
+                    if (!KEBAB_SLUG_PATTERN.test(item1)) {
+                        reportOnJsdocLine({
+                            commentNode: ctx.commentNode,
+                            parsed: ctx.parsed,
+                            sourceCode: ctx.sourceCode,
+                            lineIndex: m.startLineIndex,
+                            messageId: 'composesFromNotKebab',
+                            data: {
+                                value: item1
+                            },
+                            report: ctx.report
+                        });
+                    }
+                }
+            } catch (err) {
+                _didIteratorError3 = true;
+                _iteratorError3 = err;
+            } finally{
+                try {
+                    if (!_iteratorNormalCompletion3 && _iterator3.return != null) {
+                        _iterator3.return();
+                    }
+                } finally{
+                    if (_didIteratorError3) {
+                        throw _iteratorError3;
+                    }
+                }
+            }
+        }
+    } catch (err) {
+        _didIteratorError2 = true;
+        _iteratorError2 = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion2 && _iterator2.return != null) {
+                _iterator2.return();
+            }
+        } finally{
+            if (_didIteratorError2) {
+                throw _iteratorError2;
+            }
+        }
+    }
 }
 /**
- * ESLint rule enforcing `@dbxModel` / `@dbxModelSubObject` / `@dbxModelOrganizationalGroupRoot`
- * companion tags. Mirrors the scanner schema at
- * `packages/dbx-components-mcp/src/scan/extract-models/find-interfaces.ts`.
- *
- * Does NOT enforce a Slug / Category / Tags shape because the scanner does
- * not consume those for this family.
- */ var UTIL_REQUIRE_DBX_MODEL_COMPANION_TAGS_RULE = {
+ * ESLint rule enforcing `@dbxFormField` companion tags. Mirrors the scanner
+ * schema at `packages/dbx-cli/src/lib/mcp-scan/scan/forge-fields-extract.ts`,
+ * including the tier-conditional required-tag matrix.
+ */ var UTIL_REQUIRE_DBX_FORM_FIELD_COMPANION_TAGS_RULE = {
     meta: {
         type: 'suggestion',
         fixable: 'code',
         docs: {
-            description: 'Require the canonical `@dbxModel*` companion tags on `@dbxModel`-tagged interfaces.',
+            description: 'Require the canonical `@dbxForm*` companion tags on `@dbxFormField`-tagged factories.',
             recommended: true
         },
         messages: {
-            archetypeBadSlug: '`@dbxModelArchetype` slug `{{value}}` is not a valid kebab-case slug.',
-            archetypeBadAxisPair: '`@dbxModelArchetype` axis pair `{{value}}` is malformed; use `key=value` with non-empty key and value.',
-            aggregatesFromNotPascalCase: '`@dbxModelAggregatesFrom` value `{{value}}` is not a PascalCase identifier.',
-            compositeKeyMissingFrom: '`@dbxModelCompositeKey` is missing required `from=...` segment.',
-            compositeKeyMissingEncoding: '`@dbxModelCompositeKey` is missing required `encoding=<two-way|one-way>` segment.',
-            compositeKeyInvalidEncoding: '`@dbxModelCompositeKey` encoding `{{value}}` is invalid. Use one of: {{allowed}}.',
-            mutuallyExclusiveMarkers: '`@dbxModel`, `@dbxModelSubObject`, and `@dbxModelOrganizationalGroupRoot` are mutually exclusive markers; only one is allowed.',
-            variableTagOutsideProperty: '`@dbxModel{{name}}` is only valid on interface property declarations.',
-            unknownDbxModelTag: '`@dbxModel{{name}}` is not a recognized companion tag. Known companions: {{known}}.',
-            duplicateCompanionTag: '`@dbxModel{{name}}` is declared more than once.'
+            duplicateMarker: '`@dbxFormField` / `@dbxFormFieldDerivative` / `@dbxFormFieldTemplate` are mutually exclusive; only one is allowed.',
+            missingTier: '`@dbxFormField`-tagged factory is missing the required `@dbxFormTier <tier>` companion tag.',
+            invalidTier: '`@dbxFormTier` value `{{value}}` is not allowed. Use one of: {{allowed}}.',
+            missingSlug: '`@dbxFormField`-tagged factory is missing the required `@dbxFormSlug <slug>` companion tag.',
+            invalidSlugFormat: '`@dbxFormSlug` value `{{value}}` is not a valid kebab-case slug.',
+            missingProduces: '`@dbxFormField`-tagged factory is missing the required `@dbxFormProduces <type>` companion tag.',
+            missingArrayOutput: '`@dbxFormField`-tagged factory is missing the required `@dbxFormArrayOutput <yes|no|optional>` companion tag.',
+            invalidArrayOutput: '`@dbxFormArrayOutput` value `{{value}}` is not allowed. Use one of: {{allowed}}.',
+            missingWrapperPattern: 'field-factory tier requires `@dbxFormWrapperPattern <unwrapped|material-form-field-wrapped>`.',
+            invalidWrapperPattern: '`@dbxFormWrapperPattern` value `{{value}}` is not allowed. Use one of: {{allowed}}.',
+            missingNgFormType: 'field-factory tier requires `@dbxFormNgFormType <type>`.',
+            missingSuffix: 'composite-builder tier requires `@dbxFormSuffix <Row|Group|Fields|Field|Wrapper|Layout>`.',
+            invalidSuffix: '`@dbxFormSuffix` value `{{value}}` is not allowed. Use one of: {{allowed}}.',
+            missingComposesFrom: '`@dbxFormFieldDerivative` / `@dbxFormFieldTemplate` require `@dbxFormComposesFrom <slug,...>`.',
+            composesFromNotKebab: '`@dbxFormComposesFrom` item `{{value}}` is not a kebab-case slug.',
+            unknownDbxFormTag: '`@dbxForm{{name}}` is not a recognized companion tag. Known companions: {{known}}.',
+            duplicateCompanionTag: '`@dbxForm{{name}}` is declared more than once.'
         },
         schema: [
             {
                 type: 'object',
                 additionalProperties: false,
                 properties: {
-                    allowedEncodings: {
+                    allowedTiers: {
+                        type: 'array',
+                        items: {
+                            type: 'string'
+                        }
+                    },
+                    allowedWrapperPatterns: {
+                        type: 'array',
+                        items: {
+                            type: 'string'
+                        }
+                    },
+                    allowedSuffixes: {
+                        type: 'array',
+                        items: {
+                            type: 'string'
+                        }
+                    },
+                    allowedArrayOutputs: {
                         type: 'array',
                         items: {
                             type: 'string'
@@ -8232,16 +8141,20 @@ function reportCompositeKeyTag(ctx, tag, allowedEncodings) {
         ]
     },
     create: function create(context) {
-        var _context_options_, _options_allowedEncodings, _options_knownCompanions;
+        var _context_options_, _options_allowedTiers, _options_allowedWrapperPatterns, _options_allowedSuffixes, _options_allowedArrayOutputs, _options_knownCompanions;
         var options = (_context_options_ = context.options[0]) !== null && _context_options_ !== void 0 ? _context_options_ : {};
         var sourceCode = context.sourceCode;
-        var allowedEncodings = (_options_allowedEncodings = options.allowedEncodings) !== null && _options_allowedEncodings !== void 0 ? _options_allowedEncodings : DEFAULT_ALLOWED_ENCODINGS;
-        var knownCompanions = (_options_knownCompanions = options.knownCompanions) !== null && _options_knownCompanions !== void 0 ? _options_knownCompanions : MODEL_COMPANIONS;
+        var allowedTiers = (_options_allowedTiers = options.allowedTiers) !== null && _options_allowedTiers !== void 0 ? _options_allowedTiers : DEFAULT_ALLOWED_TIERS;
+        var allowedWrapperPatterns = (_options_allowedWrapperPatterns = options.allowedWrapperPatterns) !== null && _options_allowedWrapperPatterns !== void 0 ? _options_allowedWrapperPatterns : DEFAULT_ALLOWED_WRAPPER_PATTERNS;
+        var allowedSuffixes = (_options_allowedSuffixes = options.allowedSuffixes) !== null && _options_allowedSuffixes !== void 0 ? _options_allowedSuffixes : DEFAULT_ALLOWED_SUFFIXES;
+        var allowedArrayOutputs = (_options_allowedArrayOutputs = options.allowedArrayOutputs) !== null && _options_allowedArrayOutputs !== void 0 ? _options_allowedArrayOutputs : DEFAULT_ALLOWED_ARRAY_OUTPUTS;
+        var knownCompanions = (_options_knownCompanions = options.knownCompanions) !== null && _options_knownCompanions !== void 0 ? _options_knownCompanions : DEFAULT_KNOWN_COMPANIONS$2;
         var requireBareMarker = options.requireBareMarker !== false;
-        function checkInterfaceJsdoc(commentNode) {
-            var _companions_get, _companions_get1, _companions_get2;
+        function checkJsdoc(commentNode) {
+            var _ref, _companions_get, _companions_get1, _companions_get2, _companions_get3, _companions_get4;
+            var _markers_;
             var parsed = parseJsdocComment(commentNode.value);
-            var _collectInterfaceTags = collectInterfaceTags(parsed), markers = _collectInterfaceTags.markers, companions = _collectInterfaceTags.companions;
+            var _collectFormTags = collectFormTags(parsed), markers = _collectFormTags.markers, companions = _collectFormTags.companions;
             if (markers.length === 0 && companions.size === 0 || requireBareMarker && markers.length === 0) return;
             var ctx = {
                 commentNode: commentNode,
@@ -8249,92 +8162,66 @@ function reportCompositeKeyTag(ctx, tag, allowedEncodings) {
                 sourceCode: sourceCode,
                 report: context.report
             };
-            reportMutuallyExclusiveMarkers(ctx, markers);
-            reportPropertyOnlyTags(ctx, companions);
-            reportUnknownModelCompanions(ctx, companions, knownCompanions);
-            reportModelDuplicates(ctx, companions, knownCompanions);
-            var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-            try {
-                for(var _iterator = ((_companions_get = companions.get('Archetype')) !== null && _companions_get !== void 0 ? _companions_get : [])[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-                    var tag = _step.value;
-                    reportArchetypeTag(ctx, tag);
-                }
-            } catch (err) {
-                _didIteratorError = true;
-                _iteratorError = err;
-            } finally{
-                try {
-                    if (!_iteratorNormalCompletion && _iterator.return != null) {
-                        _iterator.return();
-                    }
-                } finally{
-                    if (_didIteratorError) {
-                        throw _iteratorError;
-                    }
-                }
-            }
-            var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
-            try {
-                for(var _iterator1 = ((_companions_get1 = companions.get('AggregatesFrom')) !== null && _companions_get1 !== void 0 ? _companions_get1 : [])[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
-                    var tag1 = _step1.value;
-                    var _tag_description_trim_split_;
-                    var value = (_tag_description_trim_split_ = tag1.description.trim().split(/\s+/)[0]) !== null && _tag_description_trim_split_ !== void 0 ? _tag_description_trim_split_ : '';
-                    if (value.length > 0 && !PASCAL_IDENTIFIER_PATTERN.test(value)) {
-                        reportOnJsdocLine({
-                            commentNode: commentNode,
-                            parsed: parsed,
-                            sourceCode: sourceCode,
-                            lineIndex: tag1.startLineIndex,
-                            messageId: 'aggregatesFromNotPascalCase',
-                            data: {
-                                value: value
-                            },
-                            report: context.report
-                        });
-                    }
-                }
-            } catch (err) {
-                _didIteratorError1 = true;
-                _iteratorError1 = err;
-            } finally{
-                try {
-                    if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
-                        _iterator1.return();
-                    }
-                } finally{
-                    if (_didIteratorError1) {
-                        throw _iteratorError1;
-                    }
-                }
-            }
-            var _iteratorNormalCompletion2 = true, _didIteratorError2 = false, _iteratorError2 = undefined;
-            try {
-                for(var _iterator2 = ((_companions_get2 = companions.get('CompositeKey')) !== null && _companions_get2 !== void 0 ? _companions_get2 : [])[Symbol.iterator](), _step2; !(_iteratorNormalCompletion2 = (_step2 = _iterator2.next()).done); _iteratorNormalCompletion2 = true){
-                    var tag2 = _step2.value;
-                    reportCompositeKeyTag(ctx, tag2, allowedEncodings);
-                }
-            } catch (err) {
-                _didIteratorError2 = true;
-                _iteratorError2 = err;
-            } finally{
-                try {
-                    if (!_iteratorNormalCompletion2 && _iterator2.return != null) {
-                        _iterator2.return();
-                    }
-                } finally{
-                    if (_didIteratorError2) {
-                        throw _iteratorError2;
-                    }
-                }
+            var triggerLine = (_ref = (_markers_ = markers[0]) === null || _markers_ === void 0 ? void 0 : _markers_.startLineIndex) !== null && _ref !== void 0 ? _ref : 0;
+            reportFormDuplicateMarkers(ctx, markers);
+            reportFormUnknownCompanions(ctx, companions, knownCompanions);
+            reportFormDuplicateCompanions(ctx, companions);
+            reportFormSlug(ctx, (_companions_get = companions.get('Slug')) !== null && _companions_get !== void 0 ? _companions_get : [], triggerLine);
+            reportFormProduces(ctx, (_companions_get1 = companions.get('Produces')) !== null && _companions_get1 !== void 0 ? _companions_get1 : [], triggerLine);
+            reportFormArrayOutput({
+                ctx: ctx,
+                arrayOutputTags: (_companions_get2 = companions.get('ArrayOutput')) !== null && _companions_get2 !== void 0 ? _companions_get2 : [],
+                allowedArrayOutputs: allowedArrayOutputs,
+                triggerLine: triggerLine
+            });
+            var tierTags = (_companions_get3 = companions.get('Tier')) !== null && _companions_get3 !== void 0 ? _companions_get3 : [];
+            var tier = determineTier(markers, tierTags);
+            reportFormTier({
+                ctx: ctx,
+                markers: markers,
+                tierTags: tierTags,
+                tier: tier,
+                allowedTiers: allowedTiers,
+                triggerLine: triggerLine
+            });
+            var composesFromTags = (_companions_get4 = companions.get('ComposesFrom')) !== null && _companions_get4 !== void 0 ? _companions_get4 : [];
+            if (tier === 'field-factory') {
+                reportFormFieldFactoryTier({
+                    ctx: ctx,
+                    companions: companions,
+                    allowedWrapperPatterns: allowedWrapperPatterns,
+                    triggerLine: triggerLine
+                });
+            } else if (tier === 'composite-builder') {
+                var _companions_get5;
+                reportFormCompositeBuilderTier({
+                    ctx: ctx,
+                    suffixTags: (_companions_get5 = companions.get('Suffix')) !== null && _companions_get5 !== void 0 ? _companions_get5 : [],
+                    allowedSuffixes: allowedSuffixes,
+                    triggerLine: triggerLine
+                });
+            } else if (tier === 'field-derivative' || tier === 'template-builder') {
+                reportFormDerivativeTier({
+                    ctx: ctx,
+                    markers: markers,
+                    composesFromTags: composesFromTags,
+                    triggerLine: triggerLine
+                });
             }
+            reportFormComposesFromKebab(ctx, composesFromTags, markers);
         }
-        function visitInterface(node) {
+        function visit(node) {
             var anchor = node.parent && (node.parent.type === 'ExportNamedDeclaration' || node.parent.type === 'ExportDefaultDeclaration') ? node.parent : node;
             var jsdoc = leadingJsdocFor(sourceCode, anchor);
-            if (jsdoc) checkInterfaceJsdoc(jsdoc);
+            if (jsdoc) checkJsdoc(jsdoc);
         }
         return {
-            TSInterfaceDeclaration: visitInterface
+            FunctionDeclaration: function FunctionDeclaration(node) {
+                if (!node.body) return;
+                var jsdoc = leadingJsdocFor(sourceCode, getStatementAnchor(node));
+                if (jsdoc) checkJsdoc(jsdoc);
+            },
+            VariableDeclaration: visit
         };
     }
 };
@@ -8394,7 +8281,7 @@ var DEFAULT_KNOWN_COMPANIONS$1 = [
 ];
 /**
  * ESLint rule enforcing the three `@dbxAuth*` marker families. Mirrors the
- * scanner schema at `packages/dbx-components-mcp/src/scan/auth-extract.ts`.
+ * scanner schema at `packages/dbx-cli/src/lib/mcp-scan/scan/auth-extract.ts`.
  *
  * - `@dbxAuthClaimsApp <slug>` on an interface / type alias.
  * - `@dbxAuthClaim` (bare) on a `PropertySignature` inside an interface.
@@ -9138,6 +9025,29 @@ function collectRuleCompanions(parsed) {
  * Used for cases where the rule's heuristics are wrong or the convention legitimately doesn't
  * apply (e.g. branded singleton instances exported via PascalCase).
  */ var DEFAULT_EXEMPT_JSDOC_TAG$2 = '@dbxAllowConstantName';
+/**
+ * Default set of type annotation identifier names whose `export const X: T = {...}` declarations
+ * are exempt from the rule.
+ *
+ * These are framework-prescribed singleton types whose author-facing convention is camelCase, so
+ * enforcing UPPER_SNAKE_CASE would diverge from upstream documentation and break import sites.
+ *
+ * - `Ng2StateDeclaration` / `StateDeclaration` — UIRouter state config objects.
+ * - `ApplicationConfig` — Angular standalone bootstrap config.
+ * - `Routes` / `Route` — Angular Router config arrays/entries.
+ * - `ModelFirebaseCrudFunctionConfigMap` — @dereekb/firebase CRUD function declaration map exported per model group.
+ * - `FirebaseFunctionTypeConfigMap` — @dereekb/firebase function-type configuration map exported per model group.
+ */ var DEFAULT_EXEMPT_TYPE_ANNOTATIONS = [
+    'Ng2StateDeclaration',
+    'StateDeclaration',
+    'ApplicationConfig',
+    'Routes',
+    'Route',
+    'ModelFirebaseCrudFunctionConfigMap',
+    'FirebaseFunctionTypeConfigMap',
+    'DevelopmentFirebaseFunctionConfigMap',
+    'SystemStateStoredDataConverterMap'
+];
 /**
  * camelCase pattern accepted for function-typed constants.
  */ var CAMEL_CASE = /^[a-z][a-zA-Z0-9]*$/;
@@ -9200,6 +9110,40 @@ function collectRuleCompanions(parsed) {
     }
     return exempt;
 }
+/**
+ * Returns the identifier text of a declarator's type annotation when the annotation is a simple
+ * `TSTypeReference` to a named type.
+ *
+ * For `TSQualifiedName` (e.g. `Ng.Routes`) the leftmost segment is returned, which is the form
+ * users would typically allowlist (the imported namespace).
+ *
+ * Returns `undefined` for shapes the allowlist can't meaningfully match: missing annotation,
+ * `TSFunctionType`, `TSTypeLiteral`, intersections/unions, etc.
+ *
+ * @param declarator - The VariableDeclarator AST node.
+ * @returns The identifier name of the type annotation, or `undefined` when the annotation has no
+ *   single matchable identifier.
+ */ function getTypeAnnotationIdentifierName(declarator) {
+    var _declarator_id_typeAnnotation, _declarator_id;
+    var typeAnnotation = (_declarator_id = declarator.id) === null || _declarator_id === void 0 ? void 0 : (_declarator_id_typeAnnotation = _declarator_id.typeAnnotation) === null || _declarator_id_typeAnnotation === void 0 ? void 0 : _declarator_id_typeAnnotation.typeAnnotation;
+    var result;
+    if ((typeAnnotation === null || typeAnnotation === void 0 ? void 0 : typeAnnotation.type) === 'TSTypeReference') {
+        var typeName = typeAnnotation.typeName;
+        if ((typeName === null || typeName === void 0 ? void 0 : typeName.type) === 'Identifier') {
+            result = typeName.name;
+        } else if ((typeName === null || typeName === void 0 ? void 0 : typeName.type) === 'TSQualifiedName') {
+            var _leftmost_left, _leftmost_left1;
+            var leftmost = typeName;
+            while(((_leftmost_left = leftmost.left) === null || _leftmost_left === void 0 ? void 0 : _leftmost_left.type) === 'TSQualifiedName'){
+                leftmost = leftmost.left;
+            }
+            if (((_leftmost_left1 = leftmost.left) === null || _leftmost_left1 === void 0 ? void 0 : _leftmost_left1.type) === 'Identifier') {
+                result = leftmost.left.name;
+            }
+        }
+    }
+    return result;
+}
 /**
  * Classifies a const variable declarator as function-typed, value-typed, or ambiguous, using only
  * syntactic signals. Ambiguous cases are skipped by the rule to avoid false positives.
@@ -9251,6 +9195,12 @@ function collectRuleCompanions(parsed) {
  * Use the exempt JSDoc tag (default `@dbxAllowConstantName`) to silence the rule on a specific
  * declaration when the heuristics get it wrong.
  *
+ * Framework-prescribed singleton types (UIRouter's `Ng2StateDeclaration`, Angular's
+ * `ApplicationConfig`, `Routes`, etc.) are exempt by default via the `exemptTypeAnnotations` option:
+ * any `export const X: T = {...}` whose type annotation is a `TSTypeReference` to one of those
+ * names is skipped regardless of casing. Pass `exemptTypeAnnotations: []` to opt out of the
+ * defaults, or pass a non-empty array to replace the default allowlist with a project-specific set.
+ *
  * Not auto-fixable: renaming an exported binding has cross-file impact that an autofix can't safely
  * propagate.
  *
@@ -9274,6 +9224,13 @@ function collectRuleCompanions(parsed) {
                     exemptJsdocTag: {
                         type: 'string',
                         description: 'JSDoc tag that opts a const declaration out of the rule.'
+                    },
+                    exemptTypeAnnotations: {
+                        type: 'array',
+                        items: {
+                            type: 'string'
+                        },
+                        description: 'Type annotation identifier names whose `export const X: T = {...}` declarations are exempt. Pass an empty array to opt out of the defaults; pass a non-empty array to replace the defaults.'
                     }
                 },
                 additionalProperties: false
@@ -9281,9 +9238,10 @@ function collectRuleCompanions(parsed) {
         ]
     },
     create: function create(context) {
-        var _context_options_, _options_exemptJsdocTag;
+        var _context_options_, _options_exemptJsdocTag, _options_exemptTypeAnnotations;
         var options = (_context_options_ = context.options[0]) !== null && _context_options_ !== void 0 ? _context_options_ : {};
         var exemptTag = (_options_exemptJsdocTag = options.exemptJsdocTag) !== null && _options_exemptJsdocTag !== void 0 ? _options_exemptJsdocTag : DEFAULT_EXEMPT_JSDOC_TAG$2;
+        var exemptTypeAnnotations = new Set((_options_exemptTypeAnnotations = options.exemptTypeAnnotations) !== null && _options_exemptTypeAnnotations !== void 0 ? _options_exemptTypeAnnotations : DEFAULT_EXEMPT_TYPE_ANNOTATIONS);
         var sourceCode = context.sourceCode;
         function checkExportNamedDeclaration(node) {
             var _decl_declarations;
@@ -9306,6 +9264,10 @@ function collectRuleCompanions(parsed) {
                     if (name.startsWith('_')) {
                         continue;
                     }
+                    var typeAnnotationName = getTypeAnnotationIdentifierName(declarator);
+                    if (typeAnnotationName !== undefined && exemptTypeAnnotations.has(typeAnnotationName)) {
+                        continue;
+                    }
                     var kind = classifyConstant(declarator);
                     if (kind === 'function') {
                         if (!CAMEL_CASE.test(name) && !UPPER_SNAKE_CASE$1.test(name)) {
@@ -9910,7 +9872,6 @@ function _unsupported_iterable_to_array(o, minLen) {
         'require-dbx-model-snapshot-field-companion-tags': UTIL_REQUIRE_DBX_MODEL_SNAPSHOT_FIELD_COMPANION_TAGS_RULE,
         'require-dbx-action-companion-tags': UTIL_REQUIRE_DBX_ACTION_COMPANION_TAGS_RULE,
         'require-dbx-form-field-companion-tags': UTIL_REQUIRE_DBX_FORM_FIELD_COMPANION_TAGS_RULE,
-        'require-dbx-model-companion-tags': UTIL_REQUIRE_DBX_MODEL_COMPANION_TAGS_RULE,
         'require-dbx-auth-companion-tags': UTIL_REQUIRE_DBX_AUTH_COMPANION_TAGS_RULE,
         'require-dbx-rule-companion-tags': UTIL_REQUIRE_DBX_RULE_COMPANION_TAGS_RULE,
         'require-constant-naming': UTIL_REQUIRE_CONSTANT_NAMING_RULE,
@@ -9926,4 +9887,4 @@ function _unsupported_iterable_to_array(o, minLen) {
  * @dbxAllowConstantName
  */ var utilESLintPlugin = UTIL_ESLINT_PLUGIN;
 
-export { UTIL_ESLINT_PLUGIN, UTIL_NO_INLINE_TYPE_IMPORT_RULE, UTIL_NO_SISTER_RE_EXPORT_RULE, UTIL_PREFER_CANONICAL_JSDOC_RULE, UTIL_PREFER_CONFIG_OBJECT_HARD_RULE, UTIL_PREFER_CONFIG_OBJECT_RULE, UTIL_PREFER_MAYBE_TYPE_RULE, UTIL_PREFER_NO_SIDE_EFFECTS_IN_JSDOC_RULE, UTIL_REQUIRE_CONSTANT_NAMING_RULE, UTIL_REQUIRE_DBX_ACTION_COMPANION_TAGS_RULE, UTIL_REQUIRE_DBX_AUTH_COMPANION_TAGS_RULE, UTIL_REQUIRE_DBX_DOCS_UI_EXAMPLE_COMPANION_TAGS_RULE, UTIL_REQUIRE_DBX_FILTER_COMPANION_TAGS_RULE, UTIL_REQUIRE_DBX_FORM_FIELD_COMPANION_TAGS_RULE, UTIL_REQUIRE_DBX_MODEL_COMPANION_TAGS_RULE, UTIL_REQUIRE_DBX_MODEL_SNAPSHOT_FIELD_COMPANION_TAGS_RULE, UTIL_REQUIRE_DBX_PIPE_COMPANION_TAGS_RULE, UTIL_REQUIRE_DBX_RULE_COMPANION_TAGS_RULE, UTIL_REQUIRE_DBX_UTIL_COMPANION_TAGS_RULE, UTIL_REQUIRE_DBX_WEB_COMPANION_TAGS_RULE, UTIL_REQUIRE_DEFAULT_PREFIX_NAMING_RULE, UTIL_REQUIRE_DEPRECATED_ALIAS_PLACEMENT_RULE, UTIL_REQUIRE_EXPORTED_JSDOC_EXAMPLE_RULE, UTIL_REQUIRE_NO_SIDE_EFFECTS_RULE, UTIL_REQUIRE_READONLY_CONFIG_PARAMS_RULE, UTIL_REQUIRE_SINGLE_RETURN_RULE, utilESLintPlugin };
+export { UTIL_ESLINT_PLUGIN, UTIL_NO_INLINE_TYPE_IMPORT_RULE, UTIL_NO_SISTER_RE_EXPORT_RULE, UTIL_PREFER_CANONICAL_JSDOC_RULE, UTIL_PREFER_CONFIG_OBJECT_HARD_RULE, UTIL_PREFER_CONFIG_OBJECT_RULE, UTIL_PREFER_MAYBE_TYPE_RULE, UTIL_PREFER_NO_SIDE_EFFECTS_IN_JSDOC_RULE, UTIL_REQUIRE_CONSTANT_NAMING_RULE, UTIL_REQUIRE_DBX_ACTION_COMPANION_TAGS_RULE, UTIL_REQUIRE_DBX_AUTH_COMPANION_TAGS_RULE, UTIL_REQUIRE_DBX_DOCS_UI_EXAMPLE_COMPANION_TAGS_RULE, UTIL_REQUIRE_DBX_FILTER_COMPANION_TAGS_RULE, UTIL_REQUIRE_DBX_FORM_FIELD_COMPANION_TAGS_RULE, UTIL_REQUIRE_DBX_MODEL_SNAPSHOT_FIELD_COMPANION_TAGS_RULE, UTIL_REQUIRE_DBX_PIPE_COMPANION_TAGS_RULE, UTIL_REQUIRE_DBX_RULE_COMPANION_TAGS_RULE, UTIL_REQUIRE_DBX_UTIL_COMPANION_TAGS_RULE, UTIL_REQUIRE_DBX_WEB_COMPANION_TAGS_RULE, UTIL_REQUIRE_DEFAULT_PREFIX_NAMING_RULE, UTIL_REQUIRE_DEPRECATED_ALIAS_PLACEMENT_RULE, UTIL_REQUIRE_EXPORTED_JSDOC_EXAMPLE_RULE, UTIL_REQUIRE_NO_SIDE_EFFECTS_RULE, UTIL_REQUIRE_READONLY_CONFIG_PARAMS_RULE, UTIL_REQUIRE_SINGLE_RETURN_RULE, buildLowercaseTagsFix, checkDbxTagFamily, findFamilyTags, getStatementAnchor, leadingJsdocFor, parseBooleanTagValue, parseJsdocComment, reportOnJsdocLine, utilESLintPlugin };