@markuplint/ml-core 4.13.3 → 5.0.0-alpha.0

package/lib/ml-dom/token/token.js

@@ -1,15 +1,4 @@
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _MLToken_endCol, _MLToken_endLine, _MLToken_endOffset, _MLToken_fixed, _MLToken_raw, _MLToken_startCol, _MLToken_startLine, _MLToken_startOffset;
+import { getEndCol, getEndLine } from '@markuplint/parser-utils/location';
 /**
  * Represents a single token in the markuplint AST.
  * Wraps an AST token with positional information (line, column, offset)
@@ -18,30 +7,26 @@ var _MLToken_endCol, _MLToken_endLine, _MLToken_endOffset, _MLToken_fixed, _MLTo
  * @template A - The AST token type this token wraps
  */
 export class MLToken {
+    #fixed;
+    #raw;
+    /**
+     * The unique identifier for this token.
+     */
+    uuid;
+    /**
+     * The underlying AST token that this token wraps.
+     */
+    _astToken;
     /**
      * Creates a new MLToken instance from an AST token.
      *
      * @param astToken - The AST token to wrap
      */
     constructor(astToken) {
-        _MLToken_endCol.set(this, void 0);
-        _MLToken_endLine.set(this, void 0);
-        _MLToken_endOffset.set(this, void 0);
-        _MLToken_fixed.set(this, void 0);
-        _MLToken_raw.set(this, void 0);
-        _MLToken_startCol.set(this, void 0);
-        _MLToken_startLine.set(this, void 0);
-        _MLToken_startOffset.set(this, void 0);
         this._astToken = astToken;
-        __classPrivateFieldSet(this, _MLToken_raw, astToken.raw, "f");
-        __classPrivateFieldSet(this, _MLToken_fixed, astToken.raw, "f");
+        this.#raw = astToken.raw;
+        this.#fixed = astToken.raw;
         this.uuid = astToken.uuid;
-        __classPrivateFieldSet(this, _MLToken_startLine, astToken.startLine, "f");
-        __classPrivateFieldSet(this, _MLToken_endLine, astToken.endLine, "f");
-        __classPrivateFieldSet(this, _MLToken_startCol, astToken.startCol, "f");
-        __classPrivateFieldSet(this, _MLToken_endCol, astToken.endCol, "f");
-        __classPrivateFieldSet(this, _MLToken_startOffset, astToken.startOffset, "f");
-        __classPrivateFieldSet(this, _MLToken_endOffset, astToken.endOffset, "f");
     }
     /**
      * The ending column number (1-based) of this token in the source.
@@ -49,7 +34,7 @@ export class MLToken {
      * @implements `@markuplint/ml-core` API: `MLDOMToken`
      */
     get endCol() {
-        return __classPrivateFieldGet(this, _MLToken_endCol, "f");
+        return getEndCol(this.fixed, this.startCol);
     }
     /**
      * The ending line number (1-based) of this token in the source.
@@ -57,7 +42,7 @@ export class MLToken {
      * @implements `@markuplint/ml-core` API: `MLDOMToken`
      */
     get endLine() {
-        return __classPrivateFieldGet(this, _MLToken_endLine, "f");
+        return getEndLine(this.fixed, this.startLine);
     }
     /**
      * The ending character offset (0-based) of this token in the source.
@@ -65,7 +50,7 @@ export class MLToken {
      * @implements `@markuplint/ml-core` API: `MLDOMToken`
      */
     get endOffset() {
-        return __classPrivateFieldGet(this, _MLToken_endOffset, "f");
+        return this.startOffset + this.fixed.length;
     }
     /**
      * The fixed (potentially modified) string content of this token.
@@ -73,7 +58,7 @@ export class MLToken {
      * @implements `@markuplint/ml-core` API: `MLDOMToken`
      */
     get fixed() {
-        return __classPrivateFieldGet(this, _MLToken_fixed, "f");
+        return this.#fixed;
     }
     /**
      * The original raw string content of this token from the source.
@@ -81,7 +66,7 @@ export class MLToken {
      * @implements `@markuplint/ml-core` API: `MLDOMToken`
      */
     get raw() {
-        return __classPrivateFieldGet(this, _MLToken_raw, "f");
+        return this.#raw;
     }
     /**
      * The starting column number (1-based) of this token in the source.
@@ -89,7 +74,7 @@ export class MLToken {
      * @implements `@markuplint/ml-core` API: `MLDOMToken`
      */
     get startCol() {
-        return __classPrivateFieldGet(this, _MLToken_startCol, "f");
+        return this._astToken.col;
     }
     /**
      * The starting line number (1-based) of this token in the source.
@@ -97,7 +82,7 @@ export class MLToken {
      * @implements `@markuplint/ml-core` API: `MLDOMToken`
      */
     get startLine() {
-        return __classPrivateFieldGet(this, _MLToken_startLine, "f");
+        return this._astToken.line;
     }
     /**
      * The starting character offset (0-based) of this token in the source.
@@ -105,7 +90,7 @@ export class MLToken {
      * @implements `@markuplint/ml-core` API: `MLDOMToken`
      */
     get startOffset() {
-        return __classPrivateFieldGet(this, _MLToken_startOffset, "f");
+        return this._astToken.offset;
     }
     /**
      * Replaces the fixed content of this token with the given string,
@@ -115,7 +100,7 @@ export class MLToken {
      * @param raw - The new string content to set as the fixed value
      */
     fix(raw) {
-        __classPrivateFieldSet(this, _MLToken_fixed, raw, "f");
+        this.#fixed = raw;
     }
     /**
      * Returns the string representation of this token.
@@ -125,7 +110,6 @@ export class MLToken {
      * @returns The string content of this token
      */
     toString(fixed = false) {
-        return fixed ? __classPrivateFieldGet(this, _MLToken_fixed, "f") : __classPrivateFieldGet(this, _MLToken_raw, "f");
+        return fixed ? this.#fixed : this.#raw;
     }
 }
-_MLToken_endCol = new WeakMap(), _MLToken_endLine = new WeakMap(), _MLToken_endOffset = new WeakMap(), _MLToken_fixed = new WeakMap(), _MLToken_raw = new WeakMap(), _MLToken_startCol = new WeakMap(), _MLToken_startLine = new WeakMap(), _MLToken_startOffset = new WeakMap();

package/lib/ml-rule/create-rule.d.ts

@@ -4,9 +4,16 @@ import type { PlainData, RuleConfigValue } from '@markuplint/ml-config';
  * Factory function for creating a type-safe rule seed.
  * Returns the seed object as-is; primarily used for type inference.
  *
+ * When `T` is `boolean` (or includes `boolean`), `defaultValue` is optional because
+ * the runtime default is `true`. For all other value types, `defaultValue` is required
+ * so that the rule always has a well-typed default.
+ *
+ * @see https://github.com/markuplint/markuplint/issues/808
  * @template T - The type of the rule's configuration value
  * @template O - The type of the rule's options
  * @param seed - The rule seed definition containing verify/fix functions and defaults
  * @returns The same seed object, now fully typed
  */
-export declare function createRule<T extends RuleConfigValue, O extends PlainData = undefined>(seed: Readonly<RuleSeed<T, O>>): Readonly<RuleSeed<T, O>>;
+export declare function createRule<T extends RuleConfigValue, O extends PlainData = undefined>(seed: Readonly<RuleSeed<T, O>> & (boolean extends T ? {} : {
+    readonly defaultValue: T;
+})): Readonly<RuleSeed<T, O>>;

package/lib/ml-rule/create-rule.js

@@ -1,12 +1,3 @@
-/**
- * Factory function for creating a type-safe rule seed.
- * Returns the seed object as-is; primarily used for type inference.
- *
- * @template T - The type of the rule's configuration value
- * @template O - The type of the rule's options
- * @param seed - The rule seed definition containing verify/fix functions and defaults
- * @returns The same seed object, now fully typed
- */
 export function createRule(seed) {
     return seed;
 }

package/lib/ml-rule/ml-rule-context.js

@@ -1,21 +1,18 @@
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _MLRuleContext_reports;
 import { translator } from '@markuplint/i18n';
 export class MLRuleContext {
+    document;
+    locale;
+    #reports = [];
+    translate;
     constructor(
     // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
     document, locale) {
-        _MLRuleContext_reports.set(this, []);
         this.document = document;
         this.translate = translator(locale);
         this.locale = locale.locale;
     }
     get reports() {
-        return __classPrivateFieldGet(this, _MLRuleContext_reports, "f").map(report => ({
+        return this.#reports.map(report => ({
             ...report,
             message: finish(report.message, this.locale),
         }));
@@ -41,12 +38,11 @@ export class MLRuleContext {
         this._push(report);
     }
     _push(report) {
-        if (!__classPrivateFieldGet(this, _MLRuleContext_reports, "f").some(r => is(r, report))) {
-            __classPrivateFieldGet(this, _MLRuleContext_reports, "f").push(report);
+        if (!this.#reports.some(r => is(r, report))) {
+            this.#reports.push(report);
         }
     }
 }
-_MLRuleContext_reports = new WeakMap();
 function finish(message, locale = 'en') {
     switch (locale) {
         case 'en': {

package/lib/ml-rule/ml-rule.d.ts

@@ -2,7 +2,7 @@ import type { RuleSeed } from './types.js';
 import type { MLDocument } from '../ml-dom/node/document.js';
 import type { Ruleset } from '../ruleset/index.js';
 import type { LocaleSet } from '@markuplint/i18n';
-import type { GlobalRuleInfo, PlainData, Rule, RuleConfigValue, RuleInfo, Severity, Violation } from '@markuplint/ml-config';
+import type { GlobalRuleInfo, SpecConformance, PlainData, Rule, RuleConfigValue, RuleInfo, Severity, Violation } from '@markuplint/ml-config';
 /**
  * Represents a single markuplint rule that can verify documents and report violations.
  *
@@ -11,13 +11,45 @@ import type { GlobalRuleInfo, PlainData, Rule, RuleConfigValue, RuleInfo, Severi
  */
 export declare class MLRule<T extends RuleConfigValue, O extends PlainData = undefined> {
     #private;
+    /**
+     * For virtual rules, the name of the base rule whose verify/fix logic is reused.
+     * When set, violations report this as `ruleId` for backwards compatibility.
+     */
+    readonly baseRuleId?: string;
     readonly defaultOptions: O;
     readonly defaultSeverity: Severity;
     readonly defaultValue: T;
+    /**
+     * For multi-entry named nodeRules, the group name shared by all derived virtual rules.
+     * Allows `rules["groupName"]: false` to disable all rules in the group.
+     */
+    readonly groupName?: string;
     readonly name: string;
+    /**
+     * The spec conformance classification of this rule, based on RFC 2119 keyword strength.
+     * Set on virtual rules derived from named nodeRules in presets.
+     */
+    readonly specConformance?: SpecConformance;
     constructor(o: Readonly<RuleSeed<T, O>> & {
         readonly name: string;
+        readonly baseRuleId?: string;
+        readonly specConformance?: SpecConformance;
+        readonly groupName?: string;
     });
+    /**
+     * Creates a virtual rule that reuses this rule's verify/fix logic
+     * under a different name (alias). Used by named nodeRules to produce
+     * independent rule instances that can be individually configured.
+     *
+     * @param aliasName - The alias name (must contain `/`)
+     * @param options - Override options for the virtual rule
+     * @returns A new MLRule instance sharing the same verify/fix logic
+     */
+    createAlias(aliasName: string, options?: {
+        readonly defaultSeverity?: Severity;
+        readonly specConformance?: SpecConformance;
+        readonly groupName?: string;
+    }): MLRule<T, O>;
     /**
      * The following getter is unused internally,
      * only for extending from 3rd party library

package/lib/ml-rule/ml-rule.js

@@ -1,15 +1,3 @@
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _MLRule_f, _MLRule_v;
 import { deleteUndefProp } from '@markuplint/ml-config';
 // @ts-ignore
 import { isPlainObject } from 'is-plain-object';
@@ -21,30 +9,76 @@ import { MLRuleContext } from './ml-rule-context.js';
  * @template O - The type of the rule's options
  */
 export class MLRule {
+    /**
+     * For virtual rules, the name of the base rule whose verify/fix logic is reused.
+     * When set, violations report this as `ruleId` for backwards compatibility.
+     */
+    baseRuleId;
+    defaultOptions;
+    defaultSeverity;
+    defaultValue;
+    #f;
+    /**
+     * For multi-entry named nodeRules, the group name shared by all derived virtual rules.
+     * Allows `rules["groupName"]: false` to disable all rules in the group.
+     */
+    groupName;
+    name;
+    /**
+     * The spec conformance classification of this rule, based on RFC 2119 keyword strength.
+     * Set on virtual rules derived from named nodeRules in presets.
+     */
+    specConformance;
+    #v;
     constructor(o) {
-        _MLRule_f.set(this, void 0);
-        _MLRule_v.set(this, void 0);
         this.name = o.name;
+        this.baseRuleId = o.baseRuleId;
+        this.groupName = o.groupName;
+        this.specConformance = o.specConformance;
         this.defaultSeverity = o.defaultSeverity ?? 'error';
-        // TODO: https://github.com/markuplint/markuplint/issues/808
+        // When T is boolean, defaultValue is optional and the runtime default is `true`.
+        // For non-boolean T, the type system now enforces that defaultValue is provided.
+        // See: https://github.com/markuplint/markuplint/issues/808
         this.defaultValue = (o.defaultValue === undefined ? true : o.defaultValue);
         this.defaultOptions = o.defaultOptions;
-        __classPrivateFieldSet(this, _MLRule_v, o.verify, "f");
-        __classPrivateFieldSet(this, _MLRule_f, o.fix, "f");
+        this.#v = o.verify;
+        this.#f = o.fix;
+    }
+    /**
+     * Creates a virtual rule that reuses this rule's verify/fix logic
+     * under a different name (alias). Used by named nodeRules to produce
+     * independent rule instances that can be individually configured.
+     *
+     * @param aliasName - The alias name (must contain `/`)
+     * @param options - Override options for the virtual rule
+     * @returns A new MLRule instance sharing the same verify/fix logic
+     */
+    createAlias(aliasName, options) {
+        return new MLRule({
+            name: aliasName,
+            baseRuleId: this.name,
+            groupName: options?.groupName,
+            specConformance: options?.specConformance,
+            defaultSeverity: options?.defaultSeverity ?? this.defaultSeverity,
+            defaultValue: this.defaultValue,
+            defaultOptions: this.defaultOptions,
+            verify: this.#v,
+            fix: this.#f,
+        });
     }
     /**
      * The following getter is unused internally,
      * only for extending from 3rd party library
      */
     get f() {
-        return __classPrivateFieldGet(this, _MLRule_f, "f");
+        return this.#f;
     }
     /**
      * The following getter is unused internally,
      * only for extending from 3rd party library
      */
     get v() {
-        return __classPrivateFieldGet(this, _MLRule_v, "f");
+        return this.#v;
     }
     /**
      * Resolves the full rule information from a ruleset, including node-level
@@ -115,10 +149,13 @@ export class MLRule {
         document.setRule(this);
         const context = new MLRuleContext(document, locale);
         const providableContext = context.provide();
-        await __classPrivateFieldGet(this, _MLRule_v, "f").call(this, providableContext);
-        if (__classPrivateFieldGet(this, _MLRule_f, "f") && fix) {
-            await __classPrivateFieldGet(this, _MLRule_f, "f").call(this, providableContext);
+        await this.#v(providableContext);
+        if (this.#f && fix) {
+            await this.#f(providableContext);
         }
+        const ruleId = this.baseRuleId ?? this.name;
+        // Only include name and specConformance for virtual rules (named nodeRules)
+        const aliasName = this.baseRuleId ? this.name : undefined;
         const violation = context.reports.map(report => {
             if ('scope' in report) {
                 let line = report.scope.startLine;
@@ -135,7 +172,9 @@ export class MLRule {
                     line,
                     col,
                     raw,
-                    ruleId: this.name,
+                    ruleId,
+                    name: aliasName,
+                    specConformance: this.specConformance,
                     reason: report.scope.rule.reason ?? document.rule.reason,
                 };
                 deleteUndefProp(violation);
@@ -147,7 +186,9 @@ export class MLRule {
                 line: report.line,
                 col: report.col,
                 raw: report.raw,
-                ruleId: this.name,
+                ruleId,
+                name: aliasName,
+                specConformance: this.specConformance,
                 reason: document.rule.reason,
             };
             deleteUndefProp(violation);
@@ -162,7 +203,6 @@ export class MLRule {
         return info;
     }
 }
-_MLRule_f = new WeakMap(), _MLRule_v = new WeakMap();
 function isRuleConfig(data) {
     return isPlainObject(data);
 }

package/lib/ruleset/index.js

@@ -3,6 +3,12 @@
  * rule overrides extracted from a markuplint {@link Config}.
  */
 export class Ruleset {
+    /** Rule overrides that apply to child nodes matching specific selectors */
+    childNodeRules;
+    /** Rule overrides that apply to nodes matching specific selectors */
+    nodeRules;
+    /** The global rule definitions */
+    rules;
     /**
      * @param config - The markuplint configuration to extract rules from
      */

package/lib/test/index.js

@@ -1,3 +1,4 @@
+import { ARIA_RECOMMENDED_VERSION } from '@markuplint/ml-spec';
 import { parser } from '@markuplint/html-parser';
 import spec from '@markuplint/html-spec';
 import { convertRuleset } from '../convert-ruleset.js';
@@ -18,7 +19,9 @@ export function createTestDocument(sourceCode, options) {
             : options.parser.parse(sourceCode, options.config?.parserOptions)
         : parser.parse(sourceCode, options?.config?.parserOptions);
     const ruleset = convertRuleset(options?.config);
-    const document = new MLDocument(ast, ruleset, [options?.specs ?? {}, {}]);
+    const document = new MLDocument(ast, ruleset, [options?.specs ?? {}, {}], {
+        ariaVersion: ARIA_RECOMMENDED_VERSION,
+    });
     return document;
 }
 /**

package/lib/types.d.ts

@@ -2,7 +2,7 @@ import type { AnyMLRule } from './ml-rule/index.js';
 import type { Ruleset } from './ruleset/index.js';
 import type { LocaleSet } from '@markuplint/i18n';
 import type { MLParser, ParserOptions } from '@markuplint/ml-ast';
-import type { Pretender, SeverityOptions } from '@markuplint/ml-config';
+import type { Pretender, RuleCommonSettings, SeverityOptions } from '@markuplint/ml-config';
 import type { ExtendedSpec, MLMLSpec } from '@markuplint/ml-spec';
 /**
  * A tuple of the base HTML/ARIA specification and zero or more
@@ -19,6 +19,7 @@ export type MLFabric = {
     readonly rules: readonly Readonly<AnyMLRule>[];
     readonly locale: LocaleSet;
     readonly schemas: MLSchema;
+    readonly ruleCommonSettings: RuleCommonSettings;
     readonly parserOptions: ParserOptions;
     readonly severity: SeverityOptions;
     readonly pretenders: readonly Pretender[];

package/lib/violation-collector.js

@@ -1,29 +1,17 @@
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _ViolationCollector_violations, _ViolationCollector_maxCount, _ViolationCollector_locked;
 /**
  * Collects and manages lint violations across multiple files.
  * Supports a maximum violation count to stop collecting early.
  */
 export class ViolationCollector {
+    #violations = [];
+    #maxCount = 0;
+    #locked = false;
     /**
      * @param maxCount - Maximum number of violations to collect; 0 means unlimited
      */
     constructor(maxCount = 0) {
-        _ViolationCollector_violations.set(this, []);
-        _ViolationCollector_maxCount.set(this, 0);
-        _ViolationCollector_locked.set(this, false);
-        __classPrivateFieldSet(this, _ViolationCollector_maxCount, maxCount, "f");
-        __classPrivateFieldSet(this, _ViolationCollector_locked, false, "f");
+        this.#maxCount = maxCount;
+        this.#locked = false;
     }
     /**
      * Adds violations associated with a specific file path.
@@ -34,23 +22,23 @@ export class ViolationCollector {
      * @returns The current total number of collected violations
      */
     pushWithFile(filePath, ...violations) {
-        if (__classPrivateFieldGet(this, _ViolationCollector_locked, "f")) {
-            return __classPrivateFieldGet(this, _ViolationCollector_violations, "f").length;
+        if (this.#locked) {
+            return this.#violations.length;
         }
         for (const violation of violations) {
-            __classPrivateFieldGet(this, _ViolationCollector_violations, "f").push({ ...violation, filePath });
-            if (__classPrivateFieldGet(this, _ViolationCollector_maxCount, "f") > 0 && __classPrivateFieldGet(this, _ViolationCollector_violations, "f").length >= __classPrivateFieldGet(this, _ViolationCollector_maxCount, "f")) {
-                __classPrivateFieldSet(this, _ViolationCollector_locked, true, "f");
+            this.#violations.push({ ...violation, filePath });
+            if (this.#maxCount > 0 && this.#violations.length >= this.#maxCount) {
+                this.#locked = true;
                 break;
             }
         }
-        return __classPrivateFieldGet(this, _ViolationCollector_violations, "f").length;
+        return this.#violations.length;
     }
     /**
      * The total number of collected violations.
      */
     get length() {
-        return __classPrivateFieldGet(this, _ViolationCollector_violations, "f").length;
+        return this.#violations.length;
     }
     /**
      * Whether the collector has reached its maximum count and will no longer accept violations.
@@ -58,7 +46,7 @@ export class ViolationCollector {
      * @returns `true` if the collector is locked
      */
     isLocked() {
-        return __classPrivateFieldGet(this, _ViolationCollector_locked, "f");
+        return this.#locked;
     }
     /**
      * Returns a copy of all collected violations as an array.
@@ -66,7 +54,7 @@ export class ViolationCollector {
      * @returns An array of violations with their associated file paths
      */
     toArray() {
-        return [...__classPrivateFieldGet(this, _ViolationCollector_violations, "f")];
+        return [...this.#violations];
     }
     /**
      * Groups collected violations by their file path.
@@ -75,7 +63,7 @@ export class ViolationCollector {
      */
     groupByFile() {
         const grouped = new Map();
-        for (const violation of __classPrivateFieldGet(this, _ViolationCollector_violations, "f")) {
+        for (const violation of this.#violations) {
             const { filePath, ...violationWithoutPath } = violation;
             if (!grouped.has(filePath)) {
                 grouped.set(filePath, []);
@@ -85,4 +73,3 @@ export class ViolationCollector {
         return grouped;
     }
 }
-_ViolationCollector_violations = new WeakMap(), _ViolationCollector_maxCount = new WeakMap(), _ViolationCollector_locked = new WeakMap();

package/lib/virtual-rule.d.ts

@@ -0,0 +1,72 @@
+import type { AnyMLRule } from './ml-rule/index.js';
+import type { Rules, SpecConformance } from '@markuplint/ml-config';
+/**
+ * Common shape of a nodeRule/childNodeRule entry that supports naming.
+ */
+type NameableNodeRule = {
+    readonly name?: string;
+    readonly specConformance?: SpecConformance;
+    readonly rules?: {
+        readonly [ruleName: string]: unknown;
+    };
+};
+/**
+ * Result of expanding named nodeRules into virtual rules.
+ */
+export type ExpandResult<T> = {
+    /** Virtual MLRule instances created from named nodeRules */
+    readonly virtualRules: readonly AnyMLRule[];
+    /** NodeRules array with named entries transformed (rules key changed to alias name) */
+    readonly transformedNodeRules: readonly T[];
+    /** Validation errors encountered during expansion */
+    readonly errors: readonly Error[];
+};
+/**
+ * Expands named nodeRules (or childNodeRules) into virtual MLRule instances.
+ *
+ * Named entries (those with a `name` property containing `/`) are converted into
+ * independent virtual rules that reuse the base rule's verify/fix logic but run
+ * under their own alias name. This enables per-check control:
+ * - Each virtual rule can be independently enabled/disabled via `rules["alias/name"]: false`
+ * - Violations report both the base `ruleId` and the alias `name`
+ *
+ * **false entry separation**: When a named nodeRule has `rules` entries set to `false`,
+ * those entries are separated into unnamed nodeRules. This preserves their semantics
+ * as base-rule specificity overrides (disabling the base rule on matching nodes)
+ * rather than creating virtual rules that would only disable themselves.
+ *
+ * **Multi-entry support**: When a named nodeRule has 2+ non-false entries, each
+ * entry gets its own virtual rule with a derived name (`name/baseRuleName`).
+ * A `groupName` is set so the entire group can be disabled via `rules["groupName"]: false`.
+ *
+ * Unnamed nodeRules pass through unchanged.
+ *
+ * @param nodeRules - The nodeRules (or childNodeRules) array from the config
+ * @param existingRules - All registered MLRule instances (for base rule lookup)
+ * @returns Virtual rules, transformed nodeRules, and any validation errors
+ */
+export declare function expandNamedNodeRules<T extends NameableNodeRule>(nodeRules: readonly T[], existingRules: readonly Readonly<AnyMLRule>[]): ExpandResult<T>;
+/**
+ * Result of expanding named rule groups in the `rules` section.
+ */
+export type ExpandNamedRulesResult = {
+    /** Virtual MLRule instances created from named rule groups */
+    readonly virtualRules: readonly AnyMLRule[];
+    /** Rules dict with named groups expanded into their virtual rule entries */
+    readonly resolvedRules: Rules;
+    /** Validation errors encountered during expansion */
+    readonly errors: readonly Error[];
+};
+/**
+ * Expands named rule groups in the `rules` section into virtual MLRule instances.
+ *
+ * Named rule groups (keys containing `/` whose values are {@link NamedRuleGroup} objects)
+ * are converted into independent virtual rules, similar to how `expandNamedNodeRules`
+ * handles named nodeRules. This enables per-check control at the global rules level.
+ *
+ * @param rules - The rules dict from the config
+ * @param existingRules - All registered MLRule instances (for base rule lookup)
+ * @returns Virtual rules, resolved rules dict, and any validation errors
+ */
+export declare function expandNamedRules(rules: Rules, existingRules: readonly Readonly<AnyMLRule>[]): ExpandNamedRulesResult;
+export {};