@markuplint/ml-core 3.4.0 → 3.6.0

package/lib/ml-dom/node/document-fragment.d.ts

@@ -1,8 +1,8 @@
 import type { DocumentFragmentNodeType } from './types';
 import type { MLASTAbstractNode } from '@markuplint/ml-ast';
-import type { RuleConfigValue } from '@markuplint/ml-config';
+import type { PlainData, RuleConfigValue } from '@markuplint/ml-config';
 import { MLParentNode } from './parent-node';
-export declare class MLDocumentFragment<T extends RuleConfigValue, O = null>
+export declare class MLDocumentFragment<T extends RuleConfigValue, O extends PlainData = undefined>
 	extends MLParentNode<T, O, MLASTAbstractNode>
 	implements DocumentFragment
 {

package/lib/ml-dom/node/document-type.d.ts

@@ -2,9 +2,9 @@ import type { MLDocument } from './document';
 import type { MLElement } from './element';
 import type { DocumentTypeNodeType } from './types';
 import type { MLASTDoctype } from '@markuplint/ml-ast';
-import type { RuleConfigValue } from '@markuplint/ml-config';
+import type { PlainData, RuleConfigValue } from '@markuplint/ml-config';
 import { MLNode } from './node';
-export declare class MLDocumentType<T extends RuleConfigValue, O = null>
+export declare class MLDocumentType<T extends RuleConfigValue, O extends PlainData = undefined>
 	extends MLNode<T, O, MLASTDoctype>
 	implements DocumentType
 {

package/lib/ml-dom/node/document-type.js

@@ -4,7 +4,11 @@ exports.MLDocumentType = void 0;
 const child_node_methods_1 = require("../manipulations/child-node-methods");
 const node_1 = require("./node");
 class MLDocumentType extends node_1.MLNode {
-    constructor(astNode, document) {
+    constructor(
+    // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+    astNode, 
+    // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+    document) {
         super(astNode, document);
         this.name = astNode.name;
         this.publicId = astNode.publicId;
@@ -27,13 +31,17 @@ class MLDocumentType extends node_1.MLNode {
     /**
      * @implements DOM API: `CharacterData`
      */
-    after(...nodes) {
+    after(
+    // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+    ...nodes) {
         (0, child_node_methods_1.after)(this, ...nodes);
     }
     /**
      * @implements DOM API: `CharacterData`
      */
-    before(...nodes) {
+    before(
+    // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+    ...nodes) {
         (0, child_node_methods_1.before)(this, ...nodes);
     }
     /**
@@ -45,7 +53,9 @@ class MLDocumentType extends node_1.MLNode {
     /**
      * @implements DOM API: `CharacterData`
      */
-    replaceWith(...nodes) {
+    replaceWith(
+    // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+    ...nodes) {
         (0, child_node_methods_1.replaceWith)(this, ...nodes);
     }
 }

package/lib/ml-dom/node/document.d.ts

@@ -7,13 +7,17 @@ import type { MLText } from './text';
 import type { DocumentNodeType } from './types';
 import type { MLRule } from '../../ml-rule';
 import type Ruleset from '../../ruleset';
+import type { MLSchema } from '../../types';
 import type { Walker } from '../helper/walkers';
 import type { MLToken } from '../token/token';
 import type { EndTagType, MLASTDocument } from '@markuplint/ml-ast';
-import type { Pretender, RuleConfigValue } from '@markuplint/ml-config';
-import type { ExtendedSpec, MLMLSpec } from '@markuplint/ml-spec';
+import type { PlainData, Pretender, RuleConfigValue } from '@markuplint/ml-config';
+import type { MLMLSpec } from '@markuplint/ml-spec';
 import { MLParentNode } from './parent-node';
-export declare class MLDocument<T extends RuleConfigValue, O = null> extends MLParentNode<T, O> implements Document {
+export declare class MLDocument<T extends RuleConfigValue, O extends PlainData = undefined>
+	extends MLParentNode<T, O>
+	implements Document
+{
 	#private;
 	/**
 	 * Detect value as a true if its attribute is booleanish value and omitted.
@@ -31,7 +35,7 @@ export declare class MLDocument<T extends RuleConfigValue, O = null> extends MLP
 	/**
 	 *
 	 */
-	currentRule: MLRule<T, O> | null;
+	currentRule: Readonly<MLRule<T, O>> | null;
 	/**
 	 * This is defined by the parser.
 	 *
@@ -53,7 +57,7 @@ export declare class MLDocument<T extends RuleConfigValue, O = null> extends MLP
 	/**
 	 *
 	 */
-	readonly specs: Readonly<MLMLSpec>;
+	readonly specs: MLMLSpec;
 	/**
 	 *
 	 * @param ast node list of markuplint AST
@@ -62,12 +66,12 @@ export declare class MLDocument<T extends RuleConfigValue, O = null> extends MLP
 	constructor(
 		ast: MLASTDocument,
 		ruleset: Ruleset,
-		schemas: readonly [MLMLSpec, ...ExtendedSpec[]],
+		schemas: MLSchema,
 		options?: {
-			filename?: string;
-			endTag?: 'xml' | 'omittable' | 'never';
-			booleanish?: boolean;
-			pretenders?: Pretender[];
+			readonly filename?: string;
+			readonly endTag?: 'xml' | 'omittable' | 'never';
+			readonly booleanish?: boolean;
+			readonly pretenders?: readonly Pretender[];
 		},
 	);
 	/**
@@ -488,7 +492,7 @@ export declare class MLDocument<T extends RuleConfigValue, O = null> extends MLP
 	 * @unsupported
 	 * @implements DOM API: `Document`
 	 */
-	get oncopy(): ((this: DocumentAndElementEventHandlers, ev: ClipboardEvent) => any) | null;
+	get oncopy(): ((this: GlobalEventHandlers, ev: ClipboardEvent) => any) | null;
 	/**
 	 * **IT THROWS AN ERROR WHEN CALLING THIS.**
 	 *
@@ -504,7 +508,7 @@ export declare class MLDocument<T extends RuleConfigValue, O = null> extends MLP
 	 * @unsupported
 	 * @implements DOM API: `Document`
 	 */
-	get oncut(): ((this: DocumentAndElementEventHandlers, ev: ClipboardEvent) => any) | null;
+	get oncut(): ((this: GlobalEventHandlers, ev: ClipboardEvent) => any) | null;
 	/**
 	 * **IT THROWS AN ERROR WHEN CALLING THIS.**
 	 *
@@ -784,7 +788,7 @@ export declare class MLDocument<T extends RuleConfigValue, O = null> extends MLP
 	 * @unsupported
 	 * @implements DOM API: `Document`
 	 */
-	get onpaste(): ((this: DocumentAndElementEventHandlers, ev: ClipboardEvent) => any) | null;
+	get onpaste(): ((this: GlobalEventHandlers, ev: ClipboardEvent) => any) | null;
 	/**
 	 * **IT THROWS AN ERROR WHEN CALLING THIS.**
 	 *
@@ -1581,7 +1585,7 @@ export declare class MLDocument<T extends RuleConfigValue, O = null> extends MLP
 	/**
 	 * @implements `@markuplint/ml-core` API: `MLDocument`
 	 */
-	setRule(rule: MLRule<T, O> | null): void;
+	setRule(rule: Readonly<MLRule<T, O>> | null): void;
 	/**
 	 * @implements `@markuplint/ml-core` API: `MLDocument`
 	 */
@@ -1600,14 +1604,14 @@ export declare class MLDocument<T extends RuleConfigValue, O = null> extends MLP
 	 * @unsupported
 	 * @implements DOM API: `Document`
 	 */
-	write(...text: string[]): void;
+	write(...text: readonly string[]): void;
 	/**
 	 * **IT THROWS AN ERROR WHEN CALLING THIS.**
 	 *
 	 * @unsupported
 	 * @implements DOM API: `Document`
 	 */
-	writeln(...text: string[]): void;
+	writeln(...text: readonly string[]): void;
 	private _pretending;
 	private _ruleMapping;
 }

package/lib/ml-dom/node/document.js

@@ -23,8 +23,10 @@ class MLDocument extends parent_node_1.MLParentNode {
      * @param ast node list of markuplint AST
      * @param ruleset ruleset object
      */
-    constructor(ast, ruleset, schemas, options) {
-        var _a;
+    constructor(
+    // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+    ast, ruleset, schemas, options) {
+        var _a, _b;
         // @ts-ignore
         super(ast, null);
         /**
@@ -38,8 +40,8 @@ class MLDocument extends parent_node_1.MLParentNode {
         _MLDocument_tokenList.set(this, null);
         this.isFragment = ast.isFragment;
         this.specs = (0, ml_spec_1.schemaToSpec)(schemas);
-        this.booleanish = (options === null || options === void 0 ? void 0 : options.booleanish) || false;
-        this.endTag = (_a = options === null || options === void 0 ? void 0 : options.endTag) !== null && _a !== void 0 ? _a : 'omittable';
+        this.booleanish = (_a = options === null || options === void 0 ? void 0 : options.booleanish) !== null && _a !== void 0 ? _a : false;
+        this.endTag = (_b = options === null || options === void 0 ? void 0 : options.endTag) !== null && _b !== void 0 ? _b : 'omittable';
         tslib_1.__classPrivateFieldSet(this, _MLDocument_filename, options === null || options === void 0 ? void 0 : options.filename, "f");
         // console.log(ast.nodeList.map((n, i) => `${i}: ${n.uuid} "${n.raw.trim()}"(${n.type})`));
         this.nodeList = Object.freeze(ast.nodeList
@@ -204,7 +206,9 @@ class MLDocument extends parent_node_1.MLParentNode {
      */
     get defaultView() {
         return {
-            getComputedStyle(_el) {
+            getComputedStyle(
+            // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+            _el) {
                 return {
                     getPropertyValue(_propName) {
                         return {};
@@ -1665,7 +1669,9 @@ class MLDocument extends parent_node_1.MLParentNode {
      * @unsupported
      * @implements DOM API: `Document`
      */
-    createExpression(expression, resolver) {
+    createExpression(expression, 
+    // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+    resolver) {
         throw new unexpected_call_error_1.default('Not supported "createExpression" method');
     }
     /**
@@ -1674,7 +1680,9 @@ class MLDocument extends parent_node_1.MLParentNode {
      * @unsupported
      * @implements DOM API: `Document`
      */
-    createNSResolver(nodeResolver) {
+    createNSResolver(
+    // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+    nodeResolver) {
         throw new unexpected_call_error_1.default('Not supported "createNSResolver" method');
     }
     /**
@@ -1683,7 +1691,11 @@ class MLDocument extends parent_node_1.MLParentNode {
      * @unsupported
      * @implements DOM API: `Document`
      */
-    createNodeIterator(root, whatToShow, filter) {
+    createNodeIterator(
+    // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+    root, whatToShow, 
+    // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+    filter) {
         throw new unexpected_call_error_1.default('Not supported "createNodeIterator" method');
     }
     /**
@@ -1719,7 +1731,11 @@ class MLDocument extends parent_node_1.MLParentNode {
      * @unsupported
      * @implements DOM API: `Document`
      */
-    createTreeWalker(root, whatToShow, filter) {
+    createTreeWalker(
+    // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+    root, whatToShow, 
+    // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+    filter) {
         throw new unexpected_call_error_1.default('Not supported "createTreeWalker" method');
     }
     /**
@@ -1752,7 +1768,13 @@ class MLDocument extends parent_node_1.MLParentNode {
      * @unsupported
      * @implements DOM API: `Document`
      */
-    evaluate(expression, contextNode, resolver, type, result) {
+    evaluate(expression, 
+    // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+    contextNode, 
+    // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+    resolver, type, 
+    // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+    result) {
         throw new unexpected_call_error_1.default('Not supported "evaluate" method');
     }
     /**
@@ -2096,13 +2118,14 @@ class MLDocument extends parent_node_1.MLParentNode {
             const selectorTarget = node.is(node.ELEMENT_NODE) ? node : null;
             // node specs and special rules for node by selector
             ruleset.nodeRules.forEach(nodeRule => {
+                var _a, _b;
                 if (!nodeRule.rules) {
                     return;
                 }
                 if (!selectorTarget) {
                     return;
                 }
-                const selector = nodeRule.selector || nodeRule.regexSelector;
+                const selector = (_a = nodeRule.selector) !== null && _a !== void 0 ? _a : nodeRule.regexSelector;
                 const matches = (0, selector_1.matchSelector)(selectorTarget, selector);
                 if (!matches.matched) {
                     return;
@@ -2116,12 +2139,12 @@ class MLDocument extends parent_node_1.MLParentNode {
                     if (rule == null) {
                         continue;
                     }
-                    const convertedRule = (0, ml_config_1.exchangeValueOnRule)(rule, matches.data || {});
+                    const convertedRule = (0, ml_config_1.exchangeValueOnRule)(rule, (_b = matches.data) !== null && _b !== void 0 ? _b : {});
                     if (convertedRule === undefined) {
                         continue;
                     }
                     const globalRule = ruleset.rules[ruleName];
-                    const mergedRule = globalRule ? (0, ml_config_1.mergeRule)(globalRule, convertedRule) : convertedRule;
+                    const mergedRule = globalRule != null ? (0, ml_config_1.mergeRule)(globalRule, convertedRule) : convertedRule;
                     ruleLog('↑ nodeRule (%s): %O', ruleName, mergedRule);
                     ruleMapper.set(node, ruleName, {
                         from: 'nodeRules',
@@ -2131,19 +2154,20 @@ class MLDocument extends parent_node_1.MLParentNode {
                 }
             });
             // overwrite rule to child node
-            if (selectorTarget && ruleset.childNodeRules.length) {
+            if (selectorTarget && ruleset.childNodeRules.length > 0) {
                 const descendants = [];
                 const children = Array.from(selectorTarget.childNodes);
                 (0, walkers_1.syncWalk)(children, childNode => {
                     descendants.push(childNode);
                 });
-                ruleset.childNodeRules.forEach((nodeRule, i) => {
+                ruleset.childNodeRules.forEach(nodeRule => {
+                    var _a;
                     if (!nodeRule.rules) {
                         return;
                     }
                     const nodeRuleRules = nodeRule.rules;
-                    const selector = nodeRule.selector || nodeRule.regexSelector;
-                    if (!selector) {
+                    const selector = (_a = nodeRule.selector) !== null && _a !== void 0 ? _a : nodeRule.regexSelector;
+                    if (selector == null) {
                         return;
                     }
                     const matches = (0, selector_1.matchSelector)(selectorTarget, selector);
@@ -2155,16 +2179,17 @@ class MLDocument extends parent_node_1.MLParentNode {
                     }
                     const targetDescendants = nodeRule.inheritance ? descendants : children;
                     Object.keys(nodeRuleRules).forEach(ruleName => {
+                        var _a;
                         const rule = nodeRuleRules[ruleName];
                         if (rule == null) {
                             return;
                         }
-                        const convertedRule = (0, ml_config_1.exchangeValueOnRule)(rule, matches.data || {});
+                        const convertedRule = (0, ml_config_1.exchangeValueOnRule)(rule, (_a = matches.data) !== null && _a !== void 0 ? _a : {});
                         if (convertedRule === undefined) {
                             return;
                         }
                         const globalRule = ruleset.rules[ruleName];
-                        const mergedRule = globalRule ? (0, ml_config_1.mergeRule)(globalRule, convertedRule) : convertedRule;
+                        const mergedRule = globalRule != null ? (0, ml_config_1.mergeRule)(globalRule, convertedRule) : convertedRule;
                         ruleLog('↑ childNodeRule (%s): %O', ruleName, mergedRule);
                         targetDescendants.forEach(descendant => {
                             ruleMapper.set(descendant, ruleName, {

package/lib/ml-dom/node/dom-token-list.d.ts

@@ -11,7 +11,7 @@ export declare class MLDomTokenList extends Array<string> implements DOMTokenLis
 	#private;
 	constructor(tokens: string, ownerAttrs: MLAttr<any, any>[]);
 	get value(): string;
-	add(...tokens: string[]): void;
+	add(...tokens: readonly string[]): void;
 	/**
 	 * @implements `@markuplint/ml-core` API: `MLDomTokenList`
 	 */
@@ -23,7 +23,7 @@ export declare class MLDomTokenList extends Array<string> implements DOMTokenLis
 	 * @implements `@markuplint/ml-core` API: `MLDomTokenList`
 	 */
 	pick(token: string): Scope | null;
-	remove(...tokens: string[]): void;
+	remove(...tokens: readonly string[]): void;
 	replace(token: string, newToken: string): boolean;
 	supports(token: string): boolean;
 	toString(): string;

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

@@ -6,7 +6,9 @@ const tslib_1 = require("tslib");
 const parser_utils_1 = require("@markuplint/parser-utils");
 const unexpected_call_error_1 = tslib_1.__importDefault(require("./unexpected-call-error"));
 class MLDomTokenList extends Array {
-    constructor(tokens, ownerAttrs) {
+    constructor(tokens, 
+    // eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+    ownerAttrs) {
         const list = tokens
             .split(/\s+/)
             .map(t => t.trim())
@@ -43,7 +45,7 @@ class MLDomTokenList extends Array {
         let offset = 0;
         const tokens = Array.from(this);
         const locs = [];
-        while (tokens.length) {
+        while (tokens.length > 0) {
             const token = tokens.shift();
             if (!token) {
                 break;

package/lib/ml-dom/node/element.d.ts

@@ -3,13 +3,13 @@ import type { MLNamedNodeMap } from './named-node-map';
 import type { MLText } from './text';
 import type { ElementNodeType, PretenderContext } from './types';
 import type { ElementType, MLASTElement, NamespaceURI } from '@markuplint/ml-ast';
-import type { Pretender, RuleConfigValue, RuleInfo } from '@markuplint/ml-config';
+import type { PlainData, Pretender, RuleConfigValue, RuleInfo } from '@markuplint/ml-config';
 import type { ARIAVersion } from '@markuplint/ml-spec';
 import { MLToken } from '../token/token';
 import { MLAttr } from './attr';
 import { MLDomTokenList } from './dom-token-list';
 import { MLParentNode } from './parent-node';
-export declare class MLElement<T extends RuleConfigValue, O = null>
+export declare class MLElement<T extends RuleConfigValue, O extends PlainData = undefined>
 	extends MLParentNode<T, O, MLASTElement>
 	implements Element, HTMLOrSVGElement, HTMLElement
 {
@@ -742,7 +742,7 @@ export declare class MLElement<T extends RuleConfigValue, O = null>
 	 * @unsupported
 	 * @implements DOM API: `Element`
 	 */
-	get oncopy(): ((this: DocumentAndElementEventHandlers, ev: ClipboardEvent) => any) | null;
+	get oncopy(): ((this: GlobalEventHandlers, ev: ClipboardEvent) => any) | null;
 	/**
 	 * **IT THROWS AN ERROR WHEN CALLING THIS.**
 	 *
@@ -758,7 +758,7 @@ export declare class MLElement<T extends RuleConfigValue, O = null>
 	 * @unsupported
 	 * @implements DOM API: `Element`
 	 */
-	get oncut(): ((this: DocumentAndElementEventHandlers, ev: ClipboardEvent) => any) | null;
+	get oncut(): ((this: GlobalEventHandlers, ev: ClipboardEvent) => any) | null;
 	/**
 	 * **IT THROWS AN ERROR WHEN CALLING THIS.**
 	 *
@@ -1038,7 +1038,7 @@ export declare class MLElement<T extends RuleConfigValue, O = null>
 	 * @unsupported
 	 * @implements DOM API: `Element`
 	 */
-	get onpaste(): ((this: DocumentAndElementEventHandlers, ev: ClipboardEvent) => any) | null;
+	get onpaste(): ((this: GlobalEventHandlers, ev: ClipboardEvent) => any) | null;
 	/**
 	 * **IT THROWS AN ERROR WHEN CALLING THIS.**
 	 *
@@ -1554,6 +1554,14 @@ export declare class MLElement<T extends RuleConfigValue, O = null>
 	 * @implements DOM API: `Element`
 	 */
 	blur(): void;
+	/**
+	 * **IT THROWS AN ERROR WHEN CALLING THIS.**
+	 *
+	 * @deprecated
+	 * @unsupported
+	 * @implements DOM API: `Element`
+	 */
+	checkVisibility(options?: CheckVisibilityOptions): boolean;
 	/**
 	 * **IT THROWS AN ERROR WHEN CALLING THIS.**
 	 *
@@ -1737,7 +1745,7 @@ export declare class MLElement<T extends RuleConfigValue, O = null>
 	/**
 	 * @implements `@markuplint/ml-core` API: `MLElement`
 	 */
-	isDescendantByUUIDList(uuidList: string[]): boolean;
+	isDescendantByUUIDList(uuidList: readonly string[]): boolean;
 	/**
 	 * @implements `@markuplint/ml-core` API: `MLElement`
 	 */
@@ -1750,7 +1758,7 @@ export declare class MLElement<T extends RuleConfigValue, O = null>
 	/**
 	 * Pretenders Initialization
 	 */
-	pretending(pretenders: Pretender[]): void;
+	pretending(pretenders: readonly Pretender[]): void;
 	/**
 	 * **IT THROWS AN ERROR WHEN CALLING THIS.**
 	 *