eslint-plugin-markdown-preferences 0.39.0 → 0.40.1

package/README.md

@@ -223,6 +223,7 @@ The rules with the following 💄 are included in the `standard` config.
 | [markdown-preferences/atx-heading-closing-sequence-length](https://ota-meshi.github.io/eslint-plugin-markdown-preferences/rules/atx-heading-closing-sequence-length.html) | enforce consistent length for the closing sequence (trailing #s) in ATX headings.         |   🔧    |   💄   |
 | [markdown-preferences/atx-heading-closing-sequence](https://ota-meshi.github.io/eslint-plugin-markdown-preferences/rules/atx-heading-closing-sequence.html)               | enforce consistent use of closing sequence in ATX headings.                               |   🔧    |   💄   |
 | [markdown-preferences/code-fence-length](https://ota-meshi.github.io/eslint-plugin-markdown-preferences/rules/code-fence-length.html)                                     | enforce consistent code fence length in fenced code blocks.                               |   🔧    |   💄   |
+| [markdown-preferences/max-len](https://ota-meshi.github.io/eslint-plugin-markdown-preferences/rules/max-len.html)                                                         | enforce maximum length for various Markdown entities                                      |         |        |
 | [markdown-preferences/no-laziness-blockquotes](https://ota-meshi.github.io/eslint-plugin-markdown-preferences/rules/no-laziness-blockquotes.html)                         | disallow laziness in blockquotes                                                          |         |  ⭐💄  |
 | [markdown-preferences/ordered-list-marker-sequence](https://ota-meshi.github.io/eslint-plugin-markdown-preferences/rules/ordered-list-marker-sequence.html)               | enforce consistent ordered list marker numbering (sequential or flat)                     |   🔧    |   💄   |
 | [markdown-preferences/setext-heading-underline-length](https://ota-meshi.github.io/eslint-plugin-markdown-preferences/rules/setext-heading-underline-length.html)         | enforce setext heading underline length                                                   |   🔧    |   💄   |

package/lib/index.d.ts

@@ -140,6 +140,11 @@ interface RuleOptions {
    * @see https://ota-meshi.github.io/eslint-plugin-markdown-preferences/rules/list-marker-alignment.html
    */
   'markdown-preferences/list-marker-alignment'?: Linter.RuleEntry<MarkdownPreferencesListMarkerAlignment>;
+  /**
+   * enforce maximum length for various Markdown entities
+   * @see https://ota-meshi.github.io/eslint-plugin-markdown-preferences/rules/max-len.html
+   */
+  'markdown-preferences/max-len'?: Linter.RuleEntry<MarkdownPreferencesMaxLen>;
   /**
    * disallow trailing punctuation in headings.
    * @see https://ota-meshi.github.io/eslint-plugin-markdown-preferences/rules/no-heading-trailing-punctuation.html
@@ -403,6 +408,59 @@ type MarkdownPreferencesLinkTitleStyle = [] | [{
 type MarkdownPreferencesListMarkerAlignment = [] | [{
   align?: ("left" | "right");
 }];
+type MarkdownPreferencesMaxLen = [] | [{
+  heading?: (number | "ignore");
+  paragraph?: (number | "ignore");
+  table?: (number | "ignore");
+  html?: (number | "ignore");
+  math?: (number | "ignore");
+  code?: ((number | "ignore") | {
+    [k: string]: (number | "ignore");
+  });
+  frontmatter?: ((number | "ignore") | {
+    [k: string]: (number | "ignore");
+  });
+  list?: ((number | "ignore") | {
+    heading?: (number | "ignore");
+    paragraph?: (number | "ignore");
+    table?: (number | "ignore");
+    html?: (number | "ignore");
+    math?: (number | "ignore");
+    code?: ((number | "ignore") | {
+      [k: string]: (number | "ignore");
+    });
+    frontmatter?: ((number | "ignore") | {
+      [k: string]: (number | "ignore");
+    });
+  });
+  blockquote?: ((number | "ignore") | {
+    heading?: (number | "ignore");
+    paragraph?: (number | "ignore");
+    table?: (number | "ignore");
+    html?: (number | "ignore");
+    math?: (number | "ignore");
+    code?: ((number | "ignore") | {
+      [k: string]: (number | "ignore");
+    });
+    frontmatter?: ((number | "ignore") | {
+      [k: string]: (number | "ignore");
+    });
+  });
+  footnoteDefinition?: ((number | "ignore") | {
+    heading?: (number | "ignore");
+    paragraph?: (number | "ignore");
+    table?: (number | "ignore");
+    html?: (number | "ignore");
+    math?: (number | "ignore");
+    code?: ((number | "ignore") | {
+      [k: string]: (number | "ignore");
+    });
+    frontmatter?: ((number | "ignore") | {
+      [k: string]: (number | "ignore");
+    });
+  });
+  ignoreUrls?: boolean;
+}];
 type MarkdownPreferencesNoHeadingTrailingPunctuation = [] | [{
   punctuation?: (string | {
     "1"?: string;
@@ -587,7 +645,7 @@ declare namespace meta_d_exports {
   export { name, version };
 }
 declare const name: "eslint-plugin-markdown-preferences";
-declare const version: "0.39.0";
+declare const version: "0.40.1";
 //#endregion
 //#region src/language/ast-types.d.ts
 type Node = mdast.Node;

package/lib/index.js

@@ -732,7 +732,7 @@ function getOtherMarker(unavailableMarker) {
 /**
 * Parse rule options.
 */
-function parseOptions$8(options) {
+function parseOptions$9(options) {
 	const primary = options.primary || "-";
 	const secondary = options.secondary || getOtherMarker(primary);
 	if (primary === secondary) throw new Error(`\`primary\` and \`secondary\` cannot be the same (primary: "${primary}", secondary: "${secondary}").`);
@@ -800,7 +800,7 @@ var bullet_list_marker_style_default = createRule("bullet-list-marker-style", {
 	},
 	create(context) {
 		const sourceCode = context.sourceCode;
-		const options = parseOptions$8(context.options[0] || {});
+		const options = parseOptions$9(context.options[0] || {});
 		let containerStack = {
 			node: sourceCode.ast,
 			level: 1,
@@ -1418,7 +1418,7 @@ var custom_container_marker_spacing_default = createRule("custom-container-marke
 /**
 * Parse options with defaults.
 */
-function parseOptions$7(options) {
+function parseOptions$8(options) {
 	return {
 		linkDefinitionPlacement: {
 			referencedFromSingleSection: options?.linkDefinitionPlacement?.referencedFromSingleSection || "document-last",
@@ -1490,7 +1490,7 @@ var definitions_last_default = createRule("definitions-last", {
 	},
 	create(context) {
 		const sourceCode = context.sourceCode;
-		const options = parseOptions$7(context.options[0]);
+		const options = parseOptions$8(context.options[0]);
 		/**
 		* Determine whether a node can be placed as the last node of the document or a section.
 		*/
@@ -4570,12 +4570,12 @@ var PreserveWordsContext = class {
 			if (firstLowerWord !== phrase[0].toLowerCase()) continue;
 			while (subWords.length < phrase.length) {
 				const word = words.next();
-				if (word.done) return null;
+				if (word.done) break;
 				subWords.push(word.value);
 			}
-			if (subWords.every((word, i) => word.toLowerCase() === phrase[i].toLowerCase())) {
+			if (subWords.length >= phrase.length && phrase.every((word, i) => subWords[i].toLowerCase() === word.toLowerCase())) {
 				let matchCount = 0;
-				for (let i = 0; i < subWords.length; i++) if (subWords[i] === phrase[i]) matchCount++;
+				for (let i = 0; i < phrase.length; i++) if (subWords[i] === phrase[i]) matchCount++;
 				if (!returnCandidate || matchCount > returnCandidate.matchCount) returnCandidate = {
 					preservePhrase: phrase,
 					matchCount
@@ -5464,7 +5464,7 @@ function parseMathClosingSequenceFromText(text) {
 /**
 * Parse options.
 */
-function parseOptions$6(options) {
+function parseOptions$7(options) {
 	const listItems = options?.listItems;
 	return { listItems: {
 		first: listItems?.first ?? 1,
@@ -5517,7 +5517,7 @@ var indent_default = createRule("indent", {
 	},
 	create(context) {
 		const sourceCode = context.sourceCode;
-		const options = parseOptions$6(context.options[0]);
+		const options = parseOptions$7(context.options[0]);
 		class AbsBlockStack {
 			violations = [];
 			getCurrentBlockquote() {
@@ -6723,11 +6723,11 @@ var link_bracket_newline_default = createRule("link-bracket-newline", {
 	},
 	create(context) {
 		const sourceCode = context.sourceCode;
-		const optionProvider = parseOptions$9(context.options[0]);
+		const optionProvider = parseOptions$10(context.options[0]);
 		/**
 		* Parse the options.
 		*/
-		function parseOptions$9(option) {
+		function parseOptions$10(option) {
 			const newline = option?.newline ?? "never";
 			const multiline = option?.multiline ?? false;
 			return (bracketsRange) => {
@@ -6869,7 +6869,7 @@ var link_bracket_newline_default = createRule("link-bracket-newline", {
 /**
 * The basic option for links and images.
 */
-function parseOptions$5(option) {
+function parseOptions$6(option) {
 	const space = option?.space ?? "never";
 	const imagesInLinks = option?.imagesInLinks;
 	return {
@@ -6919,7 +6919,7 @@ var link_bracket_spacing_default = createRule("link-bracket-spacing", {
 	},
 	create(context) {
 		const sourceCode = context.sourceCode;
-		const options = parseOptions$5(context.options[0]);
+		const options = parseOptions$6(context.options[0]);
 		/**
 		* Verify the space after the opening bracket and before the closing bracket.
 		*/
@@ -7228,11 +7228,11 @@ var link_paren_newline_default = createRule("link-paren-newline", {
 	},
 	create(context) {
 		const sourceCode = context.sourceCode;
-		const optionProvider = parseOptions$9(context.options[0]);
+		const optionProvider = parseOptions$10(context.options[0]);
 		/**
 		* Parse the options.
 		*/
-		function parseOptions$9(option) {
+		function parseOptions$10(option) {
 			const newline = option?.newline ?? "never";
 			const multiline = option?.multiline ?? false;
 			return (openingParenIndex, closingParenIndex) => {
@@ -7690,6 +7690,209 @@ var list_marker_alignment_default = createRule("list-marker-alignment", {
 	}
 });
 
+//#endregion
+//#region src/rules/max-len.ts
+const URL_PATTERN = /https?:\/\/(?:w{3}\.)?[\w#%+\-.:=@~]{1,256}\.[\w()]{1,6}\b[\w#%&()+\-./:=?@~]*/gu;
+const maxLengthSchema = { oneOf: [{
+	type: "integer",
+	minimum: 1
+}, { enum: ["ignore"] }] };
+const maxLengthParLangSchema = { oneOf: [maxLengthSchema, {
+	type: "object",
+	patternProperties: { ".*": maxLengthSchema },
+	additionalProperties: false
+}] };
+const maxLengthParPhrasingNodeOptionsSchema = {
+	type: "object",
+	properties: {
+		heading: maxLengthSchema,
+		paragraph: maxLengthSchema,
+		table: maxLengthSchema,
+		html: maxLengthSchema,
+		math: maxLengthSchema,
+		code: maxLengthParLangSchema,
+		frontmatter: maxLengthParLangSchema
+	},
+	additionalProperties: false
+};
+const maxLengthOptionForContainerSchema = { oneOf: [maxLengthSchema, maxLengthParPhrasingNodeOptionsSchema] };
+/**
+* Parse options
+*/
+function parseOptions$5(options, sourceCode) {
+	const ignoreUrls = options.ignoreUrls ?? true;
+	const maxLengthForNode = parseOptionsParNode({
+		heading: options.heading ?? 80,
+		paragraph: options.paragraph ?? 120,
+		table: options.table ?? 120,
+		html: options.html ?? 120,
+		math: options.math ?? 120,
+		code: options.code ?? "ignore",
+		frontmatter: options.frontmatter ?? "ignore"
+	});
+	const maxLengthForInBlockquote = parseContainerOption(options.blockquote ?? {});
+	const maxLengthForInList = parseContainerOption(options.list ?? {});
+	const maxLengthForInFootnoteDefinition = parseContainerOption(options.footnoteDefinition ?? {});
+	return {
+		maxLength: (node) => {
+			let maxLength = null;
+			let parent = getParent(sourceCode, node);
+			while (parent) {
+				const len = parent.type === "blockquote" ? maxLengthForInBlockquote(node) : parent.type === "listItem" ? maxLengthForInList(node) : parent.type === "footnoteDefinition" ? maxLengthForInFootnoteDefinition(node) : null;
+				if (len === "ignore") return "ignore";
+				if (len && (maxLength == null || len < maxLength)) maxLength = len;
+				parent = getParent(sourceCode, parent);
+			}
+			return maxLength ?? maxLengthForNode(node);
+		},
+		ignoreUrls
+	};
+}
+/**
+* Parse code option
+*/
+function parseCodeOption(option) {
+	if (typeof option === "number" || option === "ignore") return () => option;
+	return (node) => {
+		if (node.lang && option[node.lang] != null) return option[node.lang];
+		return "ignore";
+	};
+}
+/**
+* Parse frontmatter option
+*/
+function parseFrontmatterOption(option) {
+	if (typeof option === "number" || option === "ignore") return () => option;
+	return (node) => {
+		if (option[node.type] != null) return option[node.type];
+		return "ignore";
+	};
+}
+/**
+* Parse container option
+*/
+function parseContainerOption(option) {
+	if (typeof option === "number" || option === "ignore") return () => option;
+	return parseOptionsParNode(option);
+}
+/**
+* Parse options for phrasing nodes
+*/
+function parseOptionsParNode(option) {
+	const headingMax = option.heading;
+	const paragraphMax = option.paragraph;
+	const tableMax = option.table;
+	const htmlMax = option.html;
+	const mathMax = option.math;
+	const maxLengthForCode = option.code ? parseCodeOption(option.code) : null;
+	const maxLengthForFrontmatter = option.frontmatter ? parseFrontmatterOption(option.frontmatter) : null;
+	/**
+	* Get max length for a specific node type
+	*/
+	function getMaxLength(node) {
+		switch (node.type) {
+			case "heading": return headingMax ?? null;
+			case "paragraph": return paragraphMax ?? null;
+			case "table": return tableMax ?? null;
+			case "html": return htmlMax ?? null;
+			case "math": return mathMax ?? null;
+			case "code": return maxLengthForCode?.(node) ?? null;
+			case "yaml":
+			case "toml": return maxLengthForFrontmatter?.(node) ?? null;
+		}
+		return null;
+	}
+	return (node) => getMaxLength(node);
+}
+var max_len_default = createRule("max-len", {
+	meta: {
+		type: "layout",
+		docs: {
+			description: "enforce maximum length for various Markdown entities",
+			categories: [],
+			listCategory: "Decorative"
+		},
+		fixable: void 0,
+		hasSuggestions: false,
+		schema: [{
+			type: "object",
+			properties: {
+				...maxLengthParPhrasingNodeOptionsSchema.properties,
+				list: maxLengthOptionForContainerSchema,
+				blockquote: maxLengthOptionForContainerSchema,
+				footnoteDefinition: maxLengthOptionForContainerSchema,
+				ignoreUrls: { type: "boolean" }
+			},
+			additionalProperties: false
+		}],
+		messages: { maxLenExceeded: "Line length of {{actual}} exceeds the maximum of {{max}}." }
+	},
+	create(context) {
+		const sourceCode = context.sourceCode;
+		const options = parseOptions$5(context.options[0] ?? {}, sourceCode);
+		const checkedLines = /* @__PURE__ */ new Set();
+		/**
+		* Check if a line contains a URL (following @stylistic/max-len behavior)
+		* URLs are identified by the URL_PATTERN
+		*/
+		function containsUrl(line) {
+			URL_PATTERN.lastIndex = 0;
+			return URL_PATTERN.test(line);
+		}
+		/**
+		* Check lines in a node against a maximum length
+		*/
+		function checkLines(node) {
+			const maxLength = options.maxLength(node);
+			if (maxLength === "ignore") return;
+			const nodeLoc = sourceCode.getLoc(node);
+			const startLine = nodeLoc.start.line;
+			const endLine = nodeLoc.end.line;
+			for (let lineNumber = startLine; lineNumber <= endLine; lineNumber++) {
+				if (checkedLines.has(lineNumber)) continue;
+				const line = sourceCode.lines[lineNumber - 1];
+				const width = getTextWidth(line);
+				if (width > maxLength) {
+					if (options.ignoreUrls && containsUrl(line)) continue;
+					context.report({
+						node,
+						loc: {
+							start: {
+								line: lineNumber,
+								column: 1
+							},
+							end: {
+								line: lineNumber,
+								column: line.length + 1
+							}
+						},
+						messageId: "maxLenExceeded",
+						data: {
+							actual: String(width),
+							max: String(maxLength)
+						}
+					});
+					checkedLines.add(lineNumber);
+				}
+			}
+		}
+		return {
+			heading: checkLines,
+			paragraph: checkLines,
+			table: checkLines,
+			html(node) {
+				const parent = getParent(sourceCode, node);
+				if (parent.type !== "root" && parent.type !== "blockquote" && parent.type !== "listItem" && parent.type !== "footnoteDefinition" && parent.type !== "customContainer") return;
+				checkLines(node);
+			},
+			code: checkLines,
+			yaml: checkLines,
+			toml: checkLines,
+			math: checkLines
+		};
+	}
+});
+
 //#endregion
 //#region src/rules/no-heading-trailing-punctuation.ts
 const DEFAULT_PUNCTUATION = ".,;:!。、，；：！｡､";
@@ -12416,6 +12619,7 @@ const rules$1 = [
 	link_paren_spacing_default,
 	link_title_style_default,
 	list_marker_alignment_default,
+	max_len_default,
 	no_heading_trailing_punctuation_default,
 	no_implicit_block_closing_default,
 	no_laziness_blockquotes_default,
@@ -12550,7 +12754,7 @@ var meta_exports = /* @__PURE__ */ __export({
 	version: () => version
 });
 const name = "eslint-plugin-markdown-preferences";
-const version = "0.39.0";
+const version = "0.40.1";
 
 //#endregion
 //#region src/language/extensions/micromark-custom-container.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-markdown-preferences",
-  "version": "0.39.0",
+  "version": "0.40.1",
   "description": "ESLint plugin that enforces our markdown preferences",
   "type": "module",
   "exports": {