@markuplint/rules 3.0.0-alpha.2 → 3.0.0-alpha.27

package/README.md

@@ -1,58 +1,24 @@
 # @markuplint/rules
 
 [![npm version](https://badge.fury.io/js/%40markuplint%2Frules.svg)](https://www.npmjs.com/package/@markuplint/rules)
-[![Build Status](https://travis-ci.org/markuplint/markuplint.svg?branch=main)](https://travis-ci.org/markuplint/markuplint)
-[![Coverage Status](https://coveralls.io/repos/github/markuplint/markuplint/badge.svg?branch=main)](https://coveralls.io/github/markuplint/markuplint?branch=main)
 
-## Rules
+**Built-in rules**
 
-### Conformance checking
+## Documentation
 
-- [`attr-duplication`](./src/attr-duplication)
-- [`character-reference`](./src/character-reference)
-- [`deprecated-attr`](./src/deprecated-attr)
-- [`deprecated-element`](./src/deprecated-element)
-- [`disallowed-element`](./src/disallowed-element)
-- [`doctype`](./src/doctype)
-- [`id-duplication`](./src/id-duplication)
-- [`ineffective-attr`](./src/ineffective-attr)
-- [`invalid-attr`](./src/invalid-attr)
-- [`permitted-contents`](./src/permitted-contents)
-- [`required-attr`](./src/required-attr)
-- [`required-element`](./src/required-element)
-
-### Accessibility
-
-- [`landmark-roles`](./src/landmark-roles)
-- [`no-refer-to-non-existent-id`](./src/no-refer-to-non-existent-id)
-- [`required-h1`](./src/required-h1)
-- [`use-list`](./src/use-list)
-- [`wai-aria`](./src/wai-aria)
-
-### Naming Convention
-
-- [`class-naming`](./src/class-naming)
-
-### Maintainability
-
-- [`no-hard-code-id`](./src/no-hard-code-id)
-- [`no-use-event-handler-attr`](./src/no-use-event-handler-attr)
-
-### Style
-
-- [`attr-value-quotes`](./src/attr-value-quotes)
-- [`case-sensitive-attr-name`](./src/case-sensitive-attr-name)
-- [`case-sensitive-tag-name`](./src/case-sensitive-tag-name)
-- [`end-tag`](./src/end-tag)
-- [`no-boolean-attr-value`](./src/no-boolean-attr-value)
-- [`no-default-value`](./src/no-default-value)
+- [Rules](https://markuplint.dev/rules/)
 
 ## Install
 
-Generally, you **don't have to install** this package because markuplint dependents it by default.
+[`markuplint`](https://www.npmjs.com/package/markuplint) package includes this package.
 
-```sh
+<details>
+<summary>If you are installing purposely, how below:</summary>
+
+```shell
 $ npm install -D @markuplint/rules
 
 $ yarn add -D @markuplint/rules
 ```
+
+</details>

package/lib/attr-check.d.ts

@@ -1,11 +1,11 @@
 import type { Translator } from '@markuplint/i18n';
 import type { Attribute as AttrSpec, AttributeType } from '@markuplint/ml-spec';
-declare type Invalid = {
+type Invalid = {
     invalidType: 'non-existent' | 'invalid-value';
     message: string;
     loc?: Loc;
 };
-declare type Loc = {
+type Loc = {
     raw: string;
     line: number;
     col: number;

package/lib/attr-value-quotes/index.d.ts

@@ -1,6 +1,6 @@
-export declare type Type = 'double' | 'single';
-export declare type Quote = '"' | "'";
-export declare type QuoteMap = {
+export type Type = 'double' | 'single';
+export type Quote = '"' | "'";
+export type QuoteMap = {
     [P in Type]: Quote;
 };
 declare const _default: import("@markuplint/ml-core").RuleSeed<Type, null>;

package/lib/case-sensitive-attr-name/index.d.ts

@@ -1,3 +1,3 @@
-export declare type Value = 'lower' | 'upper';
+export type Value = 'lower' | 'upper';
 declare const _default: import("@markuplint/ml-core").RuleSeed<Value, null>;
 export default _default;

package/lib/case-sensitive-tag-name/index.d.ts

@@ -1,3 +1,3 @@
-export declare type Value = 'lower' | 'upper';
+export type Value = 'lower' | 'upper';
 declare const _default: import("@markuplint/ml-core").RuleSeed<Value, null>;
 export default _default;

package/lib/class-naming/index.d.ts

@@ -1,3 +1,3 @@
-export declare type Value = string | string[] | null;
+export type Value = string | string[] | null;
 declare const _default: import("@markuplint/ml-core").RuleSeed<Value, null>;
 export default _default;

package/lib/class-naming/index.js

@@ -10,7 +10,7 @@ exports.default = (0, ml_core_1.createRule)({
             if (!el.rule.value) {
                 return;
             }
-            const classPatterns = Array.isArray(el.rule.value) ? el.rule.value : [el.rule.value];
+            const classPatterns = (Array.isArray(el.rule.value) ? el.rule.value : [el.rule.value]).filter(className => className && typeof className === 'string');
             const attrs = el.getAttributeToken('class');
             for (const attr of attrs) {
                 if (attr.isDynamicValue) {

package/lib/debug.d.ts

@@ -1,3 +1,3 @@
 import debug from 'debug';
-export declare type Log = debug.Debugger;
+export type Log = debug.Debugger;
 export declare const log: debug.Debugger;

package/lib/doctype/index.d.ts

@@ -1,4 +1,4 @@
-declare type Option = {
+type Option = {
     denyObsoleteType: boolean;
 };
 declare const _default: import("@markuplint/ml-core").RuleSeed<"always", Option>;

package/lib/doctype/index.js

@@ -23,7 +23,7 @@ exports.default = (0, ml_core_1.createRule)({
         if ((doctype.name.toLowerCase() === 'html' && doctype.publicId) || doctype.systemId) {
             report({
                 scope: doctype,
-                message: t('Never {0} {1}', 'declarate', 'obsolete doctype'),
+                message: t('Never {0} {1}', 'declare', 'obsolete doctype'),
             });
         }
     },

package/lib/end-tag/index.js

@@ -1,22 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const ml_core_1 = require("@markuplint/ml-core");
-const voidElements = [
-    'area',
-    'base',
-    'br',
-    'col',
-    'embed',
-    'hr',
-    'img',
-    'input',
-    'link',
-    'meta',
-    'param',
-    'source',
-    'track',
-    'wbr',
-];
+const ml_spec_1 = require("@markuplint/ml-spec");
 exports.default = (0, ml_core_1.createRule)({
     defaultSeverity: 'warning',
     async verify({ document, report, t }) {
@@ -28,7 +13,7 @@ exports.default = (0, ml_core_1.createRule)({
             if (el.isOmitted) {
                 return;
             }
-            if (voidElements.some(vE => vE === el.localName)) {
+            if ((0, ml_spec_1.isVoidElement)(el)) {
                 return;
             }
             if (el.closeTag != null) {

package/lib/helpers.d.ts

@@ -1,7 +1,7 @@
 import type { Log } from './debug';
 import type { Translator } from '@markuplint/i18n';
 import type { Element, RuleConfigValue, Document } from '@markuplint/ml-core';
-import type { ARIAVersion, Attribute, MLMLSpec } from '@markuplint/ml-spec';
+import type { Attribute } from '@markuplint/ml-spec';
 export declare function attrMatches<T extends RuleConfigValue, R>(node: Element<T, R>, condition: Attribute['condition']): boolean;
 export declare function match(needle: string, pattern: string): boolean;
 /**
@@ -30,35 +30,6 @@ export declare function isValidAttr(t: Translator, name: string, value: string,
     } | undefined;
 };
 export declare function toNormalizedValue(value: string, spec: Attribute): string;
-/**
- *
- * @see https://www.w3.org/TR/wai-aria-1.2/#propcharacteristic_value
- *
- * @param type
- * @param value
- * @param tokenEnum
- */
-export declare function checkAriaValue(type: string, value: string, tokenEnum: string[]): boolean;
-export declare function checkAria(specs: Readonly<MLMLSpec>, attrName: string, currentValue: string, version: ARIAVersion, role?: string): {
-    currentValue: string;
-    isValid: boolean;
-} | {
-    currentValue: string;
-    isValid: boolean;
-    name: string;
-    type: "property" | "state";
-    deprecated?: true | undefined;
-    isGlobal?: true | undefined;
-    value: import("@markuplint/ml-spec").ARIAAttributeValue;
-    conditionalValue?: {
-        role: string[];
-        value: import("@markuplint/ml-spec").ARIAAttributeValue;
-    }[] | undefined;
-    enum: string[];
-    defaultValue?: string | undefined;
-    equivalentHtmlAttrs?: import("@markuplint/ml-spec").EquivalentHtmlAttr[] | undefined;
-    valueDescriptions?: Record<string, string> | undefined;
-};
 export declare function accnameMayBeMutable(el: Element<any, any>, document: Document<any, any>): boolean;
 export declare function getOwnedLabel<V extends RuleConfigValue, O>(el: Element<V, O>, document: Document<V, O>): Element<V, O> | null;
 export declare function decodeCharRef(characterReference: string): string;
@@ -69,7 +40,7 @@ export declare class Collection<T> {
     add(...items: (T | null | undefined)[]): void;
     toArray(): readonly T[];
 }
-declare type Writeable<T> = {
+type Writeable<T> = {
     -readonly [P in keyof T]: T[P];
 };
 export declare function deepCopy<T>(value: T): Writeable<T>;

package/lib/helpers.js

@@ -1,9 +1,8 @@
 "use strict";
 var _Collection_items;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.deepCopy = exports.Collection = exports.decodeCharRef = exports.getOwnedLabel = exports.accnameMayBeMutable = exports.checkAria = exports.checkAriaValue = exports.toNormalizedValue = exports.isValidAttr = exports.rePCENChar = exports.match = exports.attrMatches = void 0;
+exports.deepCopy = exports.Collection = exports.decodeCharRef = exports.getOwnedLabel = exports.accnameMayBeMutable = exports.toNormalizedValue = exports.isValidAttr = exports.rePCENChar = exports.match = exports.attrMatches = void 0;
 const tslib_1 = require("tslib");
-const ml_core_1 = require("@markuplint/ml-core");
 // @ts-ignore
 const structured_clone_1 = tslib_1.__importDefault(require("@ungap/structured-clone"));
 const html_entities_1 = require("html-entities");
@@ -107,75 +106,6 @@ function toNormalizedValue(value, spec) {
     return normalized;
 }
 exports.toNormalizedValue = toNormalizedValue;
-/**
- *
- * @see https://www.w3.org/TR/wai-aria-1.2/#propcharacteristic_value
- *
- * @param type
- * @param value
- * @param tokenEnum
- */
-function checkAriaValue(type, value, tokenEnum) {
-    switch (type) {
-        case 'token': {
-            return tokenEnum.includes(value);
-        }
-        case 'token list': {
-            const list = value.split(/\s+/g).map(s => s.trim());
-            return list.every(token => tokenEnum.includes(token));
-        }
-        case 'string':
-        case 'ID reference':
-        case 'ID reference list': {
-            return true;
-        }
-        case 'true/false': {
-            return ['true', 'false'].includes(value);
-        }
-        case 'tristate': {
-            return ['mixed', 'true', 'false', 'undefined'].includes(value);
-        }
-        case 'true/false/undefined': {
-            return ['true', 'false', 'undefined'].includes(value);
-        }
-        case 'integer': {
-            return parseInt(value).toString() === value;
-        }
-        case 'number': {
-            return parseFloat(value).toString() === value;
-        }
-    }
-    // For skipping checking
-    return true;
-}
-exports.checkAriaValue = checkAriaValue;
-function checkAria(specs, attrName, currentValue, version, role) {
-    const ariaAttrs = (0, ml_core_1.ariaSpecs)(specs, version).props;
-    const aria = ariaAttrs.find(a => a.name === attrName);
-    if (!aria) {
-        return {
-            currentValue,
-            // For skipping checking
-            isValid: true,
-        };
-    }
-    let valueType = aria.value;
-    if (role && aria.conditionalValue) {
-        for (const cond of aria.conditionalValue) {
-            if (cond.role.includes(role)) {
-                valueType = cond.value;
-                break;
-            }
-        }
-    }
-    const isValid = checkAriaValue(valueType, currentValue, aria.enum);
-    return {
-        ...aria,
-        currentValue,
-        isValid,
-    };
-}
-exports.checkAria = checkAria;
 function accnameMayBeMutable(el, document) {
     if (el.hasMutableAttributes() || el.hasMutableChildren(true)) {
         return true;

package/lib/index.d.ts

@@ -1,59 +1,3 @@
-declare const _default: {
-    'attr-duplication': import("packages/@markuplint/ml-core/lib").RuleSeed<import("packages/@markuplint/ml-config/src").RuleConfigValue, null>;
-    'attr-value-quotes': import("packages/@markuplint/ml-core/lib").RuleSeed<import("./attr-value-quotes").Type, null>;
-    'case-sensitive-attr-name': import("packages/@markuplint/ml-core/lib").RuleSeed<import("./case-sensitive-attr-name").Value, null>;
-    'case-sensitive-tag-name': import("packages/@markuplint/ml-core/lib").RuleSeed<import("./case-sensitive-tag-name").Value, null>;
-    'character-reference': import("packages/@markuplint/ml-core/lib").RuleSeed<import("packages/@markuplint/ml-config/src").RuleConfigValue, null>;
-    'class-naming': import("packages/@markuplint/ml-core/lib").RuleSeed<import("./class-naming").Value, null>;
-    'deprecated-attr': import("packages/@markuplint/ml-core/lib").RuleSeed<import("packages/@markuplint/ml-config/src").RuleConfigValue, null>;
-    'deprecated-element': import("packages/@markuplint/ml-core/lib").RuleSeed<import("packages/@markuplint/ml-config/src").RuleConfigValue, null>;
-    'disallowed-element': import("packages/@markuplint/ml-core/lib").RuleSeed<string[], null>;
-    doctype: import("packages/@markuplint/ml-core/lib").RuleSeed<"always", {
-        denyObsoleteType: boolean;
-    }>;
-    'end-tag': import("packages/@markuplint/ml-core/lib").RuleSeed<boolean, null>;
-    'id-duplication': import("packages/@markuplint/ml-core/lib").RuleSeed<import("packages/@markuplint/ml-config/src").RuleConfigValue, null>;
-    'ineffective-attr': import("packages/@markuplint/ml-core/lib").RuleSeed<import("packages/@markuplint/ml-config/src").RuleConfigValue, null>;
-    'invalid-attr': import("packages/@markuplint/ml-core/lib").RuleSeed<boolean, {
-        attrs?: Record<string, {
-            enum: [string, ...string[]];
-        } | {
-            pattern: string;
-        } | {
-            type: import("packages/@markuplint/ml-spec/lib").AttributeType;
-        } | {
-            disallowed: true;
-        }> | undefined;
-        ignoreAttrNamePrefix?: string | string[] | undefined;
-    }>;
-    'landmark-roles': import("packages/@markuplint/ml-core/lib").RuleSeed<boolean, {
-        ignoreRoles: (("banner" | "main" | "complementary" | "contentinfo") | "form" | "navigation" | "region")[];
-        labelEachArea: boolean;
-    }>;
-    'no-boolean-attr-value': import("packages/@markuplint/ml-core/lib").RuleSeed<import("packages/@markuplint/ml-config/src").RuleConfigValue, null>;
-    'no-default-value': import("packages/@markuplint/ml-core/lib").RuleSeed<import("packages/@markuplint/ml-config/src").RuleConfigValue, null>;
-    'no-hard-code-id': import("packages/@markuplint/ml-core/lib").RuleSeed<import("packages/@markuplint/ml-config/src").RuleConfigValue, null>;
-    'no-refer-to-non-existent-id': import("packages/@markuplint/ml-core/lib").RuleSeed<import("packages/@markuplint/ml-config/src").RuleConfigValue, {
-        ariaVersion: import("packages/@markuplint/ml-spec/lib").ARIAVersion;
-    }>;
-    'no-use-event-handler-attr': import("packages/@markuplint/ml-core/lib").RuleSeed<boolean, {
-        ignore?: string | string[] | undefined;
-    }>;
-    'permitted-contents': import("packages/@markuplint/ml-core/lib").RuleSeed<import("./permitted-contents/types").TagRule[], import("./permitted-contents/types").Options>;
-    'require-accessible-name': import("packages/@markuplint/ml-core/lib").RuleSeed<boolean, {
-        ariaVersion: import("packages/@markuplint/ml-spec/lib").ARIAVersion;
-    }>;
-    'required-attr': import("packages/@markuplint/ml-core/lib").RuleSeed<string | (string | {
-        name: string;
-        value: string | string[];
-    })[], null>;
-    'required-element': import("packages/@markuplint/ml-core/lib").RuleSeed<string[], {
-        ignoreHasMutableContents: boolean;
-    }>;
-    'required-h1': import("packages/@markuplint/ml-core/lib").RuleSeed<boolean, import("./required-h1").Options>;
-    'use-list': import("packages/@markuplint/ml-core/lib").RuleSeed<string[], {
-        spaceNeededBullets?: string[] | undefined;
-    }>;
-    'wai-aria': import("packages/@markuplint/ml-core/lib").RuleSeed<boolean, import("./wai-aria/types").Options>;
-};
+import type { AnyRuleSeed } from '@markuplint/ml-core';
+declare const _default: Record<string, AnyRuleSeed>;
 export default _default;

package/lib/index.js

@@ -15,9 +15,11 @@ const end_tag_1 = tslib_1.__importDefault(require("./end-tag"));
 const id_duplication_1 = tslib_1.__importDefault(require("./id-duplication"));
 const ineffective_attr_1 = tslib_1.__importDefault(require("./ineffective-attr"));
 const invalid_attr_1 = tslib_1.__importDefault(require("./invalid-attr"));
+const label_has_control_1 = tslib_1.__importDefault(require("./label-has-control"));
 const landmark_roles_1 = tslib_1.__importDefault(require("./landmark-roles"));
 const no_boolean_attr_value_1 = tslib_1.__importDefault(require("./no-boolean-attr-value"));
 const no_default_value_1 = tslib_1.__importDefault(require("./no-default-value"));
+const no_empty_palpable_content_1 = tslib_1.__importDefault(require("./no-empty-palpable-content"));
 const no_hard_code_id_1 = tslib_1.__importDefault(require("./no-hard-code-id"));
 const no_refer_to_non_existent_id_1 = tslib_1.__importDefault(require("./no-refer-to-non-existent-id"));
 const no_use_event_handler_attr_1 = tslib_1.__importDefault(require("./no-use-event-handler-attr"));
@@ -43,9 +45,11 @@ exports.default = {
     'id-duplication': id_duplication_1.default,
     'ineffective-attr': ineffective_attr_1.default,
     'invalid-attr': invalid_attr_1.default,
+    'label-has-control': label_has_control_1.default,
     'landmark-roles': landmark_roles_1.default,
     'no-boolean-attr-value': no_boolean_attr_value_1.default,
     'no-default-value': no_default_value_1.default,
+    'no-empty-palpable-content': no_empty_palpable_content_1.default,
     'no-hard-code-id': no_hard_code_id_1.default,
     'no-refer-to-non-existent-id': no_refer_to_non_existent_id_1.default,
     'no-use-event-handler-attr': no_use_event_handler_attr_1.default,

package/lib/invalid-attr/index.d.ts

@@ -1,9 +1,10 @@
 import type { AttributeType } from '@markuplint/ml-spec';
-declare type Option = {
+type Option = {
     attrs?: Record<string, Rule>;
     ignoreAttrNamePrefix?: string | string[];
+    allowToAddPropertiesForPretender?: boolean;
 };
-declare type Rule = {
+type Rule = {
     enum: [string, ...string[]];
 } | {
     pattern: string;

package/lib/invalid-attr/index.js

@@ -9,7 +9,9 @@ exports.default = (0, ml_core_1.createRule)({
     defaultOptions: {},
     async verify({ document, report, t }) {
         await document.walkOn('Attr', attr => {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+            // Default
+            const allowToAddPropertiesForPretender = (_a = attr.rule.options.allowToAddPropertiesForPretender) !== null && _a !== void 0 ? _a : true;
             if (attr.isDirective) {
                 return;
             }
@@ -31,16 +33,16 @@ exports.default = (0, ml_core_1.createRule)({
             }
             const valueNode = attr.valueNode;
             const value = attr.value;
-            if (attr.rule.option.ignoreAttrNamePrefix) {
-                const ignoreAttrNamePrefixes = Array.isArray(attr.rule.option.ignoreAttrNamePrefix)
-                    ? attr.rule.option.ignoreAttrNamePrefix
-                    : [attr.rule.option.ignoreAttrNamePrefix];
+            if (attr.rule.options.ignoreAttrNamePrefix) {
+                const ignoreAttrNamePrefixes = Array.isArray(attr.rule.options.ignoreAttrNamePrefix)
+                    ? attr.rule.options.ignoreAttrNamePrefix
+                    : [attr.rule.options.ignoreAttrNamePrefix];
                 if (ignoreAttrNamePrefixes.some(prefix => name.indexOf(prefix) === 0)) {
                     return;
                 }
             }
             let invalid = false;
-            const customRule = attr.rule.option.attrs ? attr.rule.option.attrs[name] : null;
+            const customRule = attr.rule.options.attrs ? attr.rule.options.attrs[name] : null;
             if (customRule) {
                 if ('enum' in customRule) {
                     invalid = (0, attr_check_1.attrCheck)(t, name.toLowerCase(), value, true, {
@@ -82,15 +84,18 @@ exports.default = (0, ml_core_1.createRule)({
                         report({
                             scope: attr,
                             message: invalid.message,
-                            line: ((_a = valueNode === null || valueNode === void 0 ? void 0 : valueNode.startLine) !== null && _a !== void 0 ? _a : 0) + ((_c = (_b = invalid.loc) === null || _b === void 0 ? void 0 : _b.line) !== null && _c !== void 0 ? _c : 0),
-                            col: ((_d = invalid.loc) === null || _d === void 0 ? void 0 : _d.line)
-                                ? ((_e = invalid.loc) === null || _e === void 0 ? void 0 : _e.col) + 1
-                                : ((_f = valueNode === null || valueNode === void 0 ? void 0 : valueNode.startCol) !== null && _f !== void 0 ? _f : 0) + ((_h = (_g = invalid.loc) === null || _g === void 0 ? void 0 : _g.col) !== null && _h !== void 0 ? _h : 0),
-                            raw: (_k = (_j = invalid.loc) === null || _j === void 0 ? void 0 : _j.raw) !== null && _k !== void 0 ? _k : value,
+                            line: ((_b = valueNode === null || valueNode === void 0 ? void 0 : valueNode.startLine) !== null && _b !== void 0 ? _b : 0) + ((_d = (_c = invalid.loc) === null || _c === void 0 ? void 0 : _c.line) !== null && _d !== void 0 ? _d : 0),
+                            col: ((_e = invalid.loc) === null || _e === void 0 ? void 0 : _e.line)
+                                ? ((_f = invalid.loc) === null || _f === void 0 ? void 0 : _f.col) + 1
+                                : ((_g = valueNode === null || valueNode === void 0 ? void 0 : valueNode.startCol) !== null && _g !== void 0 ? _g : 0) + ((_j = (_h = invalid.loc) === null || _h === void 0 ? void 0 : _h.col) !== null && _j !== void 0 ? _j : 0),
+                            raw: (_l = (_k = invalid.loc) === null || _k === void 0 ? void 0 : _k.raw) !== null && _l !== void 0 ? _l : value,
                         });
                         break;
                     }
                     case 'non-existent': {
+                        if (allowToAddPropertiesForPretender && ((_m = attr.ownerElement.pretenderContext) === null || _m === void 0 ? void 0 : _m.type) === 'origin') {
+                            return;
+                        }
                         const spec = (0, ml_core_1.getSpec)(attr.ownerElement, document.specs.specs);
                         if (spec === null || spec === void 0 ? void 0 : spec.possibleToAddProperties) {
                             return;

package/lib/label-has-control/index.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("@markuplint/ml-core").RuleSeed<import("@markuplint/ml-core").RuleConfigValue, null>;
+export default _default;

package/lib/label-has-control/index.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const ml_core_1 = require("@markuplint/ml-core");
+const controlSelector = ["input:not([type='hidden' i])", 'select', 'textarea'].join(',');
+exports.default = (0, ml_core_1.createRule)({
+    defaultSeverity: 'warning',
+    async verify({ document, report, t }) {
+        await document.walkOn('Element', el => {
+            if (el.localName !== 'label') {
+                return;
+            }
+            if (el.children.length === 0 && !el.hasAttribute('for')) {
+                report({
+                    scope: el,
+                    message: t('{0} should associate with {1}', t('The "{0*}" {1}', 'label', 'element'), t('a {0}', 'control')),
+                });
+            }
+            const controls = el.querySelectorAll(controlSelector);
+            const secondControl = controls[1];
+            if (secondControl) {
+                report({
+                    scope: secondControl,
+                    message: t('{0} associates only {1}', t('The "{0*}" {1}', 'label', 'element'), t('first {0}', 'control')),
+                });
+            }
+        });
+    },
+});

package/lib/landmark-roles/index.d.ts

@@ -1,8 +1,8 @@
-declare type Options = {
+type Options = {
     ignoreRoles: Roles[];
     labelEachArea: boolean;
 };
-declare type TopLevelRoles = 'banner' | 'main' | 'complementary' | 'contentinfo';
-declare type Roles = TopLevelRoles | 'form' | 'navigation' | 'region';
+type TopLevelRoles = 'banner' | 'main' | 'complementary' | 'contentinfo';
+type Roles = TopLevelRoles | 'form' | 'navigation' | 'region';
 declare const _default: import("@markuplint/ml-core").RuleSeed<boolean, Options>;
 export default _default;

package/lib/landmark-roles/index.js

@@ -72,7 +72,7 @@ exports.default = (0, ml_core_1.createRule)({
                 if (el.rule.disabled) {
                     continue;
                 }
-                if ((_a = el.rule.option.ignoreRoles) === null || _a === void 0 ? void 0 : _a.includes(role)) {
+                if ((_a = el.rule.options.ignoreRoles) === null || _a === void 0 ? void 0 : _a.includes(role)) {
                     continue;
                 }
                 if (el.isDescendantByUUIDList(uuidList)) {
@@ -93,7 +93,7 @@ exports.default = (0, ml_core_1.createRule)({
                 if (el.rule.disabled) {
                     continue;
                 }
-                if (!el.rule.option.labelEachArea) {
+                if (!el.rule.options.labelEachArea) {
                     continue;
                 }
                 if (!hasLabel(el)) {

package/lib/no-empty-palpable-content/index.d.ts

@@ -0,0 +1,6 @@
+type Options = {
+    extendsExposableElements?: boolean;
+    ignoreIfAriaBusy?: boolean;
+};
+declare const _default: import("@markuplint/ml-core").RuleSeed<boolean, Options>;
+export default _default;

package/lib/no-empty-palpable-content/index.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const ml_core_1 = require("@markuplint/ml-core");
+const ml_spec_1 = require("@markuplint/ml-spec");
+exports.default = (0, ml_core_1.createRule)({
+    defaultSeverity: 'warning',
+    defaultOptions: {
+        extendsExposableElements: true,
+        ignoreIfAriaBusy: true,
+    },
+    async verify({ document, report, t }) {
+        await document.walkOn('Element', el => {
+            if (!(0, ml_spec_1.isPalpableElement)(el, el.ownerMLDocument.specs, {
+                extendsSvg: false,
+                extendsExposableElements: el.rule.options.extendsExposableElements,
+            })) {
+                return;
+            }
+            if ((0, ml_spec_1.isNothingContentModel)(el)) {
+                return;
+            }
+            if (el.rule.options.ignoreIfAriaBusy && el.getAttribute('aria-busy') === 'true') {
+                return;
+            }
+            const isEmpty = Array.from(el.childNodes).every(node => node.is(node.TEXT_NODE) && node.isWhitespace());
+            if (isEmpty) {
+                report({
+                    scope: el,
+                    message: t('{0} should not {1}', t('the {0}', 'element'), 'empty'),
+                });
+            }
+        });
+    },
+});

package/lib/no-refer-to-non-existent-id/index.js

@@ -69,7 +69,7 @@ exports.default = (0, ml_core_1.createRule)({
                     }
                 }
             }
-            const { props } = (0, ml_core_1.ariaSpecs)(document.specs, attr.rule.option.ariaVersion);
+            const { props } = (0, ml_core_1.ariaSpecs)(document.specs, attr.rule.options.ariaVersion);
             const aria = props.find(prop => prop.name === name);
             if (aria) {
                 if (aria.value === 'ID reference' && !idList.has(value)) {

package/lib/no-use-event-handler-attr/index.d.ts

@@ -1,4 +1,4 @@
-declare type Options = {
+type Options = {
     ignore?: string | string[];
 };
 declare const _default: import("@markuplint/ml-core").RuleSeed<boolean, Options>;

package/lib/no-use-event-handler-attr/index.js

@@ -10,10 +10,10 @@ exports.default = (0, ml_core_1.createRule)({
             if (attr.ownerElement.elementType !== 'html') {
                 return;
             }
-            const ignoreList = Array.isArray(attr.rule.option.ignore)
-                ? attr.rule.option.ignore
-                : attr.rule.option.ignore
-                    ? [attr.rule.option.ignore]
+            const ignoreList = Array.isArray(attr.rule.options.ignore)
+                ? attr.rule.options.ignore
+                : attr.rule.options.ignore
+                    ? [attr.rule.options.ignore]
                     : [];
             const name = attr.name;
             for (const ignore of ignoreList) {