@markuplint/rules 3.0.0-canary.3 → 3.0.0-dev.177

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

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

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

@@ -10,16 +10,24 @@ exports.default = (0, ml_core_1.createRule)({
     },
     async verify({ document, report, t }) {
         await document.walkOn('Element', el => {
+            /**
+             * Exception
+             *
+             * - The `textarea` element is possibly empty because a user inputs it.
+             */
+            if (el.localName === 'textarea') {
+                return;
+            }
             if (!(0, ml_spec_1.isPalpableElement)(el, el.ownerMLDocument.specs, {
                 extendsSvg: false,
-                extendsExposableElements: el.rule.option.extendsExposableElements,
+                extendsExposableElements: el.rule.options.extendsExposableElements,
             })) {
                 return;
             }
-            if ((0, ml_spec_1.isVoidElement)(el)) {
+            if ((0, ml_spec_1.isNothingContentModel)(el)) {
                 return;
             }
-            if (el.rule.option.ignoreIfAriaBusy && el.getAttribute('aria-busy') === 'true') {
+            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());

package/lib/no-hard-code-id/index.d.ts

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

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

@@ -1,5 +1,10 @@
-import type { ARIAVersion } from '@markuplint/ml-spec';
-declare const _default: import("@markuplint/ml-core").RuleSeed<import("@markuplint/ml-core").RuleConfigValue, {
-    ariaVersion: ARIAVersion;
-}>;
+declare const _default: Readonly<
+	import('@markuplint/ml-core').RuleSeed<
+		import('@markuplint/ml-core').RuleConfigValue,
+		{
+			ariaVersion: '1.1' | '1.2' | '1.3';
+			fragmentRefersNameAttr: boolean;
+		}
+	>
+>;
 export default _default;

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

@@ -1,27 +1,50 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const ml_core_1 = require("@markuplint/ml-core");
+const ml_spec_1 = require("@markuplint/ml-spec");
+const shared_1 = require("@markuplint/shared");
+const HYPERLINK_SELECTOR = 'a[href], area[href]';
 exports.default = (0, ml_core_1.createRule)({
     defaultOptions: {
-        ariaVersion: '1.2',
+        ariaVersion: ml_spec_1.ARIA_RECOMMENDED_VERSION,
+        fragmentRefersNameAttr: false,
     },
     async verify({ document, report, t }) {
         const idList = new Set();
+        const nameList = new Set();
         let hasDynamicId = false;
-        await document.walkOn('Attr', attr => {
-            if (attr.name.toLowerCase() !== 'id') {
+        let hasDynamicName = false;
+        const isMutable = document.nodeList.some(node => node.is(node.MARKUPLINT_PREPROCESSOR_BLOCK));
+        if (isMutable) {
+            return;
+        }
+        document.querySelectorAll('[id]').forEach(el => {
+            const attr = el.getAttributeNode('id');
+            if (!attr) {
                 return;
             }
             if (attr.isDynamicValue) {
                 hasDynamicId = true;
             }
             if (attr.valueType !== 'code') {
-                idList.add(attr.value);
+                idList.add((0, shared_1.decodeEntities)(attr.value));
             }
         });
         if (hasDynamicId) {
             return;
         }
+        document.querySelectorAll('[name]').forEach(el => {
+            const attr = el.getAttributeNode('name');
+            if (!attr) {
+                return;
+            }
+            if (attr.isDynamicValue) {
+                hasDynamicName = true;
+            }
+            if (attr.valueType !== 'code') {
+                nameList.add((0, shared_1.decodeEntities)(attr.value));
+            }
+        });
         await document.walkOn('Attr', attr => {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
             const attrSpec = (0, ml_core_1.getAttrSpecs)(attr.ownerElement, document.specs);
@@ -69,7 +92,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)) {
@@ -100,5 +123,42 @@ exports.default = (0, ml_core_1.createRule)({
                 }
             }
         });
+        /**
+         * @see https://html.spec.whatwg.org/multipage/browsing-the-web.html#scrolling-to-a-fragment
+         */
+        await document.walkOn('Element', el => {
+            var _a, _b, _c, _d;
+            if (el.rule.options.fragmentRefersNameAttr && hasDynamicName) {
+                return;
+            }
+            if (!el.matches(HYPERLINK_SELECTOR)) {
+                return;
+            }
+            const href = el.getAttributeNode('href');
+            if (!href) {
+                return;
+            }
+            const rawFragment = (_a = href.value.match(/^#(.+)/)) === null || _a === void 0 ? void 0 : _a[1];
+            if (rawFragment == null) {
+                return;
+            }
+            const decodedFragment = (0, shared_1.decodeHref)(rawFragment);
+            // > 2. If fragment is the empty string, then return the special value top of the document.
+            // >
+            // > 9. If decodedFragment is an ASCII case-insensitive match for the string top, then return the top of the document.
+            if (decodedFragment === '' || /^top$/i.test(decodedFragment)) {
+                return;
+            }
+            if (!idList.has(decodedFragment) &&
+                (el.rule.options.fragmentRefersNameAttr ? !nameList.has(decodedFragment) : true)) {
+                report({
+                    scope: href,
+                    line: (_b = href.valueNode) === null || _b === void 0 ? void 0 : _b.startLine,
+                    col: (_c = href.valueNode) === null || _c === void 0 ? void 0 : _c.startCol,
+                    raw: (_d = href.valueNode) === null || _d === void 0 ? void 0 : _d.raw,
+                    message: t('Missing {0}', t('"{0*}" ID', decodedFragment)),
+                });
+            }
+        });
     },
 });

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

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

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) {

package/lib/permitted-contents/choice.d.ts

@@ -1,3 +1,10 @@
 import type { ChildNode, Options, Result, Specs } from './types';
 import type { PermittedContentChoice } from '@markuplint/ml-spec';
-export declare function choice(pattern: PermittedContentChoice, elements: ChildNode[], specs: Specs, options: Options, depth: number): Result;
+import type { ReadonlyDeep } from 'type-fest';
+export declare function choice(
+	pattern: ReadonlyDeep<PermittedContentChoice>,
+	elements: readonly ChildNode[],
+	specs: Specs,
+	options: Options,
+	depth: number,
+): Result;

package/lib/permitted-contents/choice.js

@@ -1,14 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.choice = void 0;
+const debug_1 = require("./debug");
 const order_1 = require("./order");
 const utils_1 = require("./utils");
-function choice(pattern, elements, specs, options, depth) {
+const indexes = new WeakMap();
+function choice(pattern, 
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+elements, specs, options, depth) {
+    const choiceLog = debug_1.cmLog.extend(`choice#${depth}`);
     const collection = new utils_1.Collection(elements);
     const unmatchedResults = [];
+    let i = 0;
     for (const some of pattern.choice) {
+        choiceLog('Patterns[%s]: %s', i, (0, utils_1.modelLog)(some, ''));
         const result = (0, order_1.order)(some, collection.unmatched, specs, options, depth + 1);
         if (result.type === 'UNEXPECTED_EXTRA_NODE' || result.type === 'MATCHED' || result.type === 'MATCHED_ZERO') {
+            choiceLog('Results[%s]: %s', i, choiceLogString(pattern.choice, i));
             collection.addMatched(result.matched);
             return {
                 type: result.type,
@@ -20,11 +28,27 @@ function choice(pattern, elements, specs, options, depth) {
             };
         }
         unmatchedResults.push(result);
+        indexes.set(result, i);
+        i++;
     }
-    const barelyMatchedResult = unmatchedResults.sort((a, b) => b.matched.length - a.matched.length)[0];
+    const barelyMatchedResult = unmatchedResults.sort((a, b) => {
+        var _c, _d, _e, _f;
+        const computed1 = b.matched.length - a.matched.length;
+        if (computed1 !== 0) {
+            return computed1;
+        }
+        const _a = (_d = (_c = a.hint.missing) === null || _c === void 0 ? void 0 : _c.barelyMatchedElements) !== null && _d !== void 0 ? _d : 0;
+        const _b = (_f = (_e = b.hint.missing) === null || _e === void 0 ? void 0 : _e.barelyMatchedElements) !== null && _f !== void 0 ? _f : 0;
+        const computed2 = _b - _a;
+        return computed2;
+    })[0];
     if (!barelyMatchedResult) {
         throw new Error('Unreachable code');
     }
+    const index = indexes.get(barelyMatchedResult);
+    if (index != null) {
+        choiceLog('Results[%s]: %s', index, choiceLogString(pattern.choice, index, true));
+    }
     return {
         type: barelyMatchedResult.type,
         matched: collection.matched,
@@ -35,3 +59,14 @@ function choice(pattern, elements, specs, options, depth) {
     };
 }
 exports.choice = choice;
+function choiceLogString(choice, index, barely = false) {
+    const colorFn = barely ? debug_1.bgBlue : debug_1.bgGreen;
+    return choice
+        .map((pattern, i) => {
+        if (i === index) {
+            return colorFn((0, utils_1.modelLog)(pattern, ''));
+        }
+        return (0, utils_1.modelLog)(pattern, '');
+    })
+        .join(', ');
+}

package/lib/permitted-contents/complex-branch.d.ts

@@ -1,5 +1,6 @@
 import type { ChildNode, Options, Result, Specs } from './types';
 import type { PermittedContentPattern } from '@markuplint/ml-spec';
+import type { ReadonlyDeep } from 'type-fest';
 /**
  * Check content condition
  *
@@ -10,4 +11,10 @@ import type { PermittedContentPattern } from '@markuplint/ml-spec';
  * @param depth
  * @returns
  */
-export declare function complexBranch(pattern: PermittedContentPattern, elements: ChildNode[], specs: Specs, options: Options, depth: number): Result;
+export declare function complexBranch(
+	pattern: ReadonlyDeep<PermittedContentPattern>,
+	elements: readonly ChildNode[],
+	specs: Specs,
+	options: Options,
+	depth: number,
+): Result;

package/lib/permitted-contents/complex-branch.js

@@ -15,12 +15,14 @@ const utils_1 = require("./utils");
  * @param depth
  * @returns
  */
-function complexBranch(pattern, elements, specs, options, depth) {
+function complexBranch(pattern, 
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+elements, specs, options, depth) {
     if ((0, utils_1.isChoice)(pattern)) {
         return (0, choice_1.choice)(pattern, elements, specs, options, depth);
     }
     if ((0, utils_1.isTransparent)(pattern)) {
-        return (0, transparent_1.transparent)(elements, specs, options, depth);
+        return (0, transparent_1.transparent)(elements);
     }
     return (0, count_pattern_1.countPattern)(pattern, elements, specs, options, depth);
 }

package/lib/permitted-contents/content-model.d.ts

@@ -1,2 +1,2 @@
 import type { ContentModelResult, Element, Options, TagRule } from './types';
-export declare function contentModel(el: Element, rules: TagRule[], options: Options): ContentModelResult[];
+export declare function contentModel(el: Element, rules: readonly TagRule[], options: Options): ContentModelResult[];

package/lib/permitted-contents/content-model.js

@@ -3,7 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.contentModel = void 0;
 const ml_spec_1 = require("@markuplint/ml-spec");
 const start_1 = require("./start");
-function contentModel(el, rules, options) {
+function contentModel(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, rules, options) {
     const model = createModel(el, rules);
     if (model == null) {
         return [
@@ -19,14 +21,16 @@ function contentModel(el, rules, options) {
     return result;
 }
 exports.contentModel = contentModel;
-function createModel(el, rules) {
+function createModel(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+el, rules) {
     const specs = cachedSpecs(el.ownerMLDocument.specs, rules);
     const model = (0, ml_spec_1.getContentModel)(el, specs.specs);
     return model;
 }
 const caches = new Map();
 function cachedSpecs(specs, rules) {
-    if (!rules.length) {
+    if (rules.length === 0) {
         return specs;
     }
     const key = JSON.stringify(rules);

package/lib/permitted-contents/count-pattern.d.ts

@@ -1,5 +1,11 @@
 import type { ChildNode, Options, Result, Specs } from './types';
-import type { PermittedContentOneOrMore, PermittedContentOptional, PermittedContentRequire, PermittedContentZeroOrMore } from '@markuplint/ml-spec';
+import type {
+	PermittedContentOneOrMore,
+	PermittedContentOptional,
+	PermittedContentRequire,
+	PermittedContentZeroOrMore,
+} from '@markuplint/ml-spec';
+import type { ReadonlyDeep } from 'type-fest';
 /**
  * Check count
  *
@@ -10,4 +16,14 @@ import type { PermittedContentOneOrMore, PermittedContentOptional, PermittedCont
  * @param depth
  * @returns
  */
-export declare function countPattern(pattern: PermittedContentOneOrMore | PermittedContentOptional | PermittedContentRequire | PermittedContentZeroOrMore, elements: readonly ChildNode[], specs: Specs, options: Options, depth: number): Result;
+export declare function countPattern(
+	pattern:
+		| ReadonlyDeep<PermittedContentOneOrMore>
+		| ReadonlyDeep<PermittedContentOptional>
+		| ReadonlyDeep<PermittedContentRequire>
+		| ReadonlyDeep<PermittedContentZeroOrMore>,
+	elements: readonly ChildNode[],
+	specs: Specs,
+	options: Options,
+	depth: number,
+): Result;

package/lib/permitted-contents/count-pattern.js

@@ -14,95 +14,75 @@ const utils_1 = require("./utils");
  * @param depth
  * @returns
  */
-function countPattern(pattern, elements, specs, options, depth) {
-    var _a, _b, _c, _d, _e;
+function countPattern(pattern, 
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+elements, specs, options, depth) {
     const ptLog = debug_1.cmLog.extend(`countPattern#${depth}`);
     const collection = new utils_1.Collection(elements);
-    let min;
-    let max;
-    let model;
-    let type;
-    let _type;
-    if ((0, utils_1.isRequire)(pattern)) {
-        min = (_a = pattern.min) !== null && _a !== void 0 ? _a : 1;
-        max = Math.max((_b = pattern.max) !== null && _b !== void 0 ? _b : 1, min);
-        model = pattern.require;
-        type = 'MISSING_NODE_REQUIRED';
-        _type = 'require';
-    }
-    else if ((0, utils_1.isOptional)(pattern)) {
-        min = 0;
-        max = Math.max((_c = pattern.max) !== null && _c !== void 0 ? _c : 1, 1);
-        model = pattern.optional;
-        _type = 'optional';
-    }
-    else if ((0, utils_1.isOneOrMore)(pattern)) {
-        min = 1;
-        max = Math.max((_d = pattern.max) !== null && _d !== void 0 ? _d : Infinity, 1);
-        model = pattern.oneOrMore;
-        type = 'MISSING_NODE_ONE_OR_MORE';
-        _type = 'one or more';
-    }
-    else if ((0, utils_1.isZeroOrMore)(pattern)) {
-        min = 0;
-        max = Math.max((_e = pattern.max) !== null && _e !== void 0 ? _e : Infinity, 1);
-        model = pattern.zeroOrMore;
-        _type = 'zero or more';
-    }
-    else {
-        throw new Error('Unreachable code');
-    }
-    ptLog('%s: %o', _type, model);
+    const { model, min, max, repeat, missingType } = (0, utils_1.normalizeModel)(pattern);
+    ptLog('Model:\n  RegEx: %s\n  Schema: %o', (0, utils_1.modelLog)(model, repeat), pattern);
     let prevResult = null;
+    let barelyResult = null;
+    let loopCount = 0;
     // eslint-disable-next-line no-constant-condition
     while (true) {
-        ptLog('%s', collection);
+        loopCount++;
+        ptLog('Check#%s: %s', loopCount, collection);
         const result = (0, recursive_branch_1.recursiveBranch)(model, collection.unmatched, specs, options, depth);
         const added = collection.addMatched(result.matched);
+        const { matchedCount } = collection;
         if (result.type === 'UNMATCHED_SELECTOR_BUT_MAY_EMPTY') {
-            ptLog('MATCHED_ZERO: %s', result.query);
-            return {
+            ptLog('MATCHED_ZERO:\n  model: %s\n  max: %s\n  collection: %s\n  matched element: %s', (0, utils_1.modelLog)(model, repeat), max, collection, matchedCount);
+            return compereResult({
                 type: 'MATCHED_ZERO',
                 matched: collection.matched,
                 unmatched: collection.unmatched,
                 zeroMatch: true,
                 query: result.query,
                 hint: result.hint,
-            };
+            }, barelyResult);
         }
         if (max < collection.matchedCount) {
             collection.max(max);
-            ptLog('UNEXPECTED_EXTRA_NODE (max: %s): %s', max, result.query);
-            return {
+            ptLog('UNEXPECTED_EXTRA_NODE:\n  model: %s\n  max: %s\n  collection: %s\n  matched element: %s', (0, utils_1.modelLog)(model, repeat), max, collection, matchedCount);
+            return compereResult({
                 type: 'UNEXPECTED_EXTRA_NODE',
                 matched: collection.matched,
                 unmatched: collection.unmatched,
                 zeroMatch: result.zeroMatch,
                 query: result.query,
-                hint: {
-                    ...result.hint,
-                    max,
-                },
-            };
+                hint: (0, utils_1.mergeHints)(result.hint, { max }),
+            }, barelyResult);
         }
         if (prevResult) {
             if (result.type === 'MISSING_NODE_ONE_OR_MORE' ||
                 result.type === 'MISSING_NODE_REQUIRED' ||
                 result.type === 'TRANSPARENT_MODEL_DISALLOWS') {
-                ptLog('%s(continued): %s', result.type, collection);
-                return {
+                ptLog('%s(continued): %s; Needs', result.type, collection, result.query);
+                return compereResult({
                     type: result.type,
                     matched: collection.matched,
                     unmatched: collection.unmatched,
                     zeroMatch: result.zeroMatch,
                     query: result.query,
                     hint: result.hint,
-                };
+                }, barelyResult);
             }
             ptLog('%s(continued): %s', prevResult.type, collection);
-            return prevResult;
+            return compereResult(prevResult, barelyResult);
         }
         if (added && collection.unmatched.length > 0) {
+            if (result.type !== 'MISSING_NODE' && result.type !== 'UNMATCHED_SELECTORS') {
+                barelyResult = {
+                    type: result.type,
+                    matched: collection.matched,
+                    unmatched: collection.unmatched,
+                    zeroMatch: result.zeroMatch,
+                    query: result.query,
+                    hint: result.hint,
+                };
+            }
+            ptLog('continue⤴️');
             continue;
         }
         if (collection.matchedCount + (result.zeroMatch ? 1 : 0) < min) {
@@ -110,16 +90,21 @@ function countPattern(pattern, elements, specs, options, depth) {
                 result.type === 'MISSING_NODE_ONE_OR_MORE' ||
                 result.type === 'TRANSPARENT_MODEL_DISALLOWS'
                 ? result.type
-                : type !== null && type !== void 0 ? type : 'MISSING_NODE_REQUIRED';
-            ptLog('%s(in %s): %s', resultType, type, result.query);
-            return {
+                : missingType !== null && missingType !== void 0 ? missingType : 'MISSING_NODE_REQUIRED';
+            ptLog('%s(in %s); Needs %s', resultType, missingType, result.query);
+            return compereResult({
                 type: resultType,
                 matched: collection.matched,
                 unmatched: collection.unmatched,
                 zeroMatch: result.zeroMatch,
                 query: result.query,
-                hint: result.hint,
-            };
+                hint: (0, utils_1.mergeHints)(result.hint, {
+                    missing: {
+                        barelyMatchedElements: collection.matched.length,
+                        need: result.query,
+                    },
+                }),
+            }, barelyResult);
         }
         const resultType = collection.matched.length === 0 ? 'MATCHED_ZERO' : 'MATCHED';
         const zeroMatch = result.zeroMatch || min === 0 || resultType === 'MATCHED_ZERO';
@@ -129,27 +114,49 @@ function countPattern(pattern, elements, specs, options, depth) {
             unmatched: collection.unmatched,
             zeroMatch,
             query: result.query,
-            hint: result.hint,
+            hint: (0, utils_1.mergeHints)(result.hint, {
+                missing: {
+                    barelyMatchedElements: collection.matched.length,
+                    need: result.query,
+                },
+            }),
         };
-        if (!prevResult && collection.unmatched.length) {
-            ptLog('continue checking');
+        if (collection.unmatched.length > 0) {
             prevResult = matchedResult;
+            ptLog('continue⤴️ (add prev)');
             continue;
         }
-        ptLog('%s: %s', resultType, collection);
+        ptLog('%s:\n  model: %s\n  max: %s\n  collection: %s\n  matched element: %s', resultType, (0, utils_1.modelLog)(model, repeat), max, collection, matchedCount);
         if (result.type === 'MISSING_NODE_REQUIRED' ||
             result.type === 'MISSING_NODE_ONE_OR_MORE' ||
             result.type === 'TRANSPARENT_MODEL_DISALLOWS') {
-            return {
+            return compereResult({
                 type: result.type,
                 matched: collection.matched,
                 unmatched: collection.unmatched,
                 zeroMatch: result.zeroMatch,
                 query: result.query,
                 hint: result.hint,
-            };
+            }, barelyResult);
         }
-        return matchedResult;
+        return compereResult(matchedResult, barelyResult);
     }
 }
 exports.countPattern = countPattern;
+const cLog = debug_1.cmLog.extend('countCompereResult');
+function compereResult(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+a, 
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+b) {
+    var _a;
+    cLog('current: %s %O\nbarely: %s %O', a.type, a.hint, b === null || b === void 0 ? void 0 : b.type, b === null || b === void 0 ? void 0 : b.hint);
+    if (b == null) {
+        return a;
+    }
+    if (a.type === 'MATCHED' || a.type === 'MATCHED_ZERO' || a.type === 'UNEXPECTED_EXTRA_NODE') {
+        return a;
+    }
+    const result = (_a = [a, b].sort((a, b) => { var _a, _b, _c, _d; return ((_b = (_a = b.hint.missing) === null || _a === void 0 ? void 0 : _a.barelyMatchedElements) !== null && _b !== void 0 ? _b : 0) - ((_d = (_c = a.hint.missing) === null || _c === void 0 ? void 0 : _c.barelyMatchedElements) !== null && _d !== void 0 ? _d : 0); })[0]) !== null && _a !== void 0 ? _a : a;
+    return result;
+}

package/lib/permitted-contents/debug.browser.d.ts

@@ -0,0 +1,30 @@
+/// <reference types="debug" />
+export declare const cmLog: import('debug').Debugger;
+export declare const bgGreen: {
+	(): void;
+	bold(): void;
+};
+export declare const green: {
+	(): void;
+	bold(): void;
+};
+export declare const bgRed: {
+	(): void;
+	bold(): void;
+};
+export declare const bgBlue: {
+	(): void;
+	bold(): void;
+};
+export declare const blue: {
+	(): void;
+	bold(): void;
+};
+export declare const bgMagenta: {
+	(): void;
+	bold(): void;
+};
+export declare const cyan: {
+	(): void;
+	bold(): void;
+};

package/lib/permitted-contents/debug.browser.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cyan = exports.bgMagenta = exports.blue = exports.bgBlue = exports.bgRed = exports.green = exports.bgGreen = exports.cmLog = void 0;
+const debug_1 = require("../debug");
+exports.cmLog = debug_1.log.extend('content-model');
+const fn = () => { };
+fn.bold = () => { };
+exports.bgGreen = fn;
+exports.green = fn;
+exports.bgRed = fn;
+exports.bgBlue = fn;
+exports.blue = fn;
+exports.bgMagenta = fn;
+exports.cyan = fn;

package/lib/permitted-contents/debug.d.ts

@@ -1,2 +1,3 @@
 /// <reference types="debug" />
-export declare const cmLog: import("debug").Debugger;
+export declare const cmLog: import('debug').Debugger;
+export { bgGreen, green, bgRed, bgBlue, blue, bgMagenta, cyan } from 'ansi-colors';

package/lib/permitted-contents/debug.js

@@ -1,5 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.cmLog = void 0;
+exports.cyan = exports.bgMagenta = exports.blue = exports.bgBlue = exports.bgRed = exports.green = exports.bgGreen = exports.cmLog = void 0;
 const debug_1 = require("../debug");
 exports.cmLog = debug_1.log.extend('content-model');
+var ansi_colors_1 = require("ansi-colors");
+Object.defineProperty(exports, "bgGreen", { enumerable: true, get: function () { return ansi_colors_1.bgGreen; } });
+Object.defineProperty(exports, "green", { enumerable: true, get: function () { return ansi_colors_1.green; } });
+Object.defineProperty(exports, "bgRed", { enumerable: true, get: function () { return ansi_colors_1.bgRed; } });
+Object.defineProperty(exports, "bgBlue", { enumerable: true, get: function () { return ansi_colors_1.bgBlue; } });
+Object.defineProperty(exports, "blue", { enumerable: true, get: function () { return ansi_colors_1.blue; } });
+Object.defineProperty(exports, "bgMagenta", { enumerable: true, get: function () { return ansi_colors_1.bgMagenta; } });
+Object.defineProperty(exports, "cyan", { enumerable: true, get: function () { return ansi_colors_1.cyan; } });