mdrefine 0.2.2 → 0.2.3

package/dist/syntax/misread-lists.d.ts

@@ -42,5 +42,7 @@ export interface MisreadLists {
  * not count. Renderers read the `===` below such text as text, of the list
  * item or after an empty one, so a paragraph or heading on the next line
  * continues it too, and a block there is nested: a `---` would underline it.
+ * Where such text ends a list item or block quote, renderers continue it
+ * lazily into a paragraph or heading on the next line below the container.
  */
 export declare function misreadLists(document: Document): MisreadLists;

package/dist/syntax/misread-lists.js

@@ -23,6 +23,8 @@ const found = new WeakMap();
  * not count. Renderers read the `===` below such text as text, of the list
  * item or after an empty one, so a paragraph or heading on the next line
  * continues it too, and a block there is nested: a `---` would underline it.
+ * Where such text ends a list item or block quote, renderers continue it
+ * lazily into a paragraph or heading on the next line below the container.
  */
 export function misreadLists(document) {
     const known = found.get(document.tree);
@@ -58,16 +60,21 @@ export function misreadLists(document) {
             return node.children[0]?.position?.start.offset ?? start;
         return undefined;
     };
+    /** Returns the last line of misread text that ends `parent` and whose `===` renderers read as text. */
     const visit = (parent) => {
         let reach;
         /** The last line of misread text whose `===` renderers read as text, if the last block is that. */
         let continued;
+        /** Whether that text ends the last block, a container, rather than being it. */
+        let inside = false;
         parent.children.forEach((child, index) => {
             const offset = child.position?.start.offset;
             if (offset === undefined)
                 return;
             const start = textStart(child);
-            const adjacent = continued === child.position.start.line - 1;
+            // Renderers continue the text lazily on the line below the container
+            // that it ends, but only with text (issue #343).
+            const adjacent = continued === child.position.start.line - 1 && (!inside || start !== undefined);
             const misread = start !== undefined &&
                 (listMarker.test(source.slice(start, start + 11)) || adjacent) &&
                 !(index === 0 && parent.type === "listItem" && typeof parent.checked === "boolean");
@@ -88,9 +95,16 @@ export function misreadLists(document) {
                 misread && child.type === "heading" && child.depth === 1
                     ? child.position.end.line
                     : undefined;
-            if ("children" in child && !leaves.has(child.type))
-                visit(child);
+            inside = false;
+            if ("children" in child && !leaves.has(child.type)) {
+                const last = visit(child);
+                if (last !== undefined && last === child.position.end.line) {
+                    continued = last;
+                    inside = true;
+                }
+            }
         });
+        return continued;
     };
     visit(document.tree);
     const result = { text, nested, next };

package/dist/syntax/misread-lists.js.map

@@ -1 +1 @@
-{"version":3,"file":"misread-lists.js","sourceRoot":"","sources":["../../src/syntax/misread-lists.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Nodes, Parents, Root } from \"mdast\";\nimport type { Document } from \"../core/types.js\";\n\n/**\n * A list marker as CommonMark reads one at the start of a line's content: a\n * bullet, `-`, `*`, or `+`, or a number of one to nine digits followed by `.`\n * or `)`, and then a space, a tab, or the end of the line.\n */\nexport const listMarker = /^(?:[-+*]|\\d{1,9}[.)])(?:[ \\t\\r\\n]|$)/;\n\n/** Text that the parser read where renderers may read a list, and the blocks after it. */\nexport interface MisreadLists {\n  /**\n   * Paragraphs, and headings underlined with `===` or `---`, whose text starts\n   * with a list marker, and the text that renderers read as continuing it.\n   */\n  text: ReadonlySet<Nodes>;\n  /**\n   * The blocks after such text in its container whose first lines start\n   * further right than the text, up to one that does not. Renderers may read\n   * them inside the list's last item, where their indentation counts from the\n   * item's text: an indented code block can be a paragraph there.\n   */\n  nested: ReadonlySet<Nodes>;\n  /**\n   * The block after those, which starts no further right than the text.\n   * Renderers may read it as more items of the list.\n   */\n  next: ReadonlySet<Nodes>;\n}\n\n/** Leaf blocks: their children, if they have any, are not blocks. */\nconst leaves = new Set<Nodes[\"type\"]>([\"paragraph\", \"heading\", \"table\", \"code\", \"html\"]);\nconst found = new WeakMap<Root, MisreadLists>();\n\n/**\n * Where renderers may read a list in text that the parser read as text.\n *\n * micromark refuses to start a list that does not start at 1, or an empty\n * item, where it would interrupt a paragraph, as CommonMark says, but also\n * where no paragraph is open: at the start of a list item, block quote, or\n * footnote definition below a paragraph, and after an indented code block\n * (issue #191). It reads the line as text there, where GitHub, commonmark.js,\n * and markdown-it read a list. By CommonMark's rules, text can start with a\n * list marker only below a link reference definition, as what remains of the\n * definition's lines; GitHub and commonmark.js read text there too, and\n * markdown-it a list. The paragraph of a task list item starts after its\n * checkbox, which renderers read as the start of the item's text, so it does\n * not count. Renderers read the `===` below such text as text, of the list\n * item or after an empty one, so a paragraph or heading on the next line\n * continues it too, and a block there is nested: a `---` would underline it.\n */\nexport function misreadLists(document: Document): MisreadLists {\n  const known = found.get(document.tree);\n  if (known) return known;\n  const { source } = document;\n  const text = new Set<Nodes>();\n  const nested = new Set<Nodes>();\n  const next = new Set<Nodes>();\n  /** The column of the first character from `offset` on, after spaces and tabs. */\n  const columnAt = (offset: number) => {\n    let start = offset;\n    while (start > 0 && source[start - 1] !== \"\\n\" && source[start - 1] !== \"\\r\") start--;\n    let column = 0;\n    for (let at = start; at < source.length; at++) {\n      const character = source[at];\n      if (at >= offset && character !== \" \" && character !== \"\\t\") break;\n      column = character === \"\\t\" ? column + 4 - (column % 4) : column + 1;\n    }\n    return column;\n  };\n  /** Where a paragraph's or an underlined heading's text starts. */\n  const textStart = (node: Nodes): number | undefined => {\n    const start = node.position?.start.offset;\n    if (start === undefined || node.position?.end.offset === undefined) return undefined;\n    if (node.type === \"paragraph\") return start;\n    // An underlined heading below link reference definitions starts at them.\n    if (node.type === \"heading\" && source[start] !== \"#\")\n      return node.children[0]?.position?.start.offset ?? start;\n    return undefined;\n  };\n  const visit = (parent: Parents) => {\n    let reach: number | undefined;\n    /** The last line of misread text whose `===` renderers read as text, if the last block is that. */\n    let continued: number | undefined;\n    parent.children.forEach((child, index) => {\n      const offset = child.position?.start.offset;\n      if (offset === undefined) return;\n      const start = textStart(child);\n      const adjacent = continued === child.position!.start.line - 1;\n      const misread =\n        start !== undefined &&\n        (listMarker.test(source.slice(start, start + 11)) || adjacent) &&\n        !(index === 0 && parent.type === \"listItem\" && typeof parent.checked === \"boolean\");\n      if (misread || adjacent || reach !== undefined) {\n        const column = columnAt(misread ? start! : offset);\n        if ((adjacent && !misread) || (reach !== undefined && column > reach)) nested.add(child);\n        else if (reach !== undefined) {\n          next.add(child);\n          reach = undefined;\n        }\n        if (misread) {\n          text.add(child);\n          reach = Math.min(reach ?? column, column);\n        }\n      }\n      continued =\n        misread && child.type === \"heading\" && child.depth === 1\n          ? child.position!.end.line\n          : undefined;\n      if (\"children\" in child && !leaves.has(child.type)) visit(child);\n    });\n  };\n  visit(document.tree);\n  const result = { text, nested, next };\n  found.set(document.tree, result);\n  return result;\n}\n"]}
+{"version":3,"file":"misread-lists.js","sourceRoot":"","sources":["../../src/syntax/misread-lists.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Nodes, Parents, Root } from \"mdast\";\nimport type { Document } from \"../core/types.js\";\n\n/**\n * A list marker as CommonMark reads one at the start of a line's content: a\n * bullet, `-`, `*`, or `+`, or a number of one to nine digits followed by `.`\n * or `)`, and then a space, a tab, or the end of the line.\n */\nexport const listMarker = /^(?:[-+*]|\\d{1,9}[.)])(?:[ \\t\\r\\n]|$)/;\n\n/** Text that the parser read where renderers may read a list, and the blocks after it. */\nexport interface MisreadLists {\n  /**\n   * Paragraphs, and headings underlined with `===` or `---`, whose text starts\n   * with a list marker, and the text that renderers read as continuing it.\n   */\n  text: ReadonlySet<Nodes>;\n  /**\n   * The blocks after such text in its container whose first lines start\n   * further right than the text, up to one that does not. Renderers may read\n   * them inside the list's last item, where their indentation counts from the\n   * item's text: an indented code block can be a paragraph there.\n   */\n  nested: ReadonlySet<Nodes>;\n  /**\n   * The block after those, which starts no further right than the text.\n   * Renderers may read it as more items of the list.\n   */\n  next: ReadonlySet<Nodes>;\n}\n\n/** Leaf blocks: their children, if they have any, are not blocks. */\nconst leaves = new Set<Nodes[\"type\"]>([\"paragraph\", \"heading\", \"table\", \"code\", \"html\"]);\nconst found = new WeakMap<Root, MisreadLists>();\n\n/**\n * Where renderers may read a list in text that the parser read as text.\n *\n * micromark refuses to start a list that does not start at 1, or an empty\n * item, where it would interrupt a paragraph, as CommonMark says, but also\n * where no paragraph is open: at the start of a list item, block quote, or\n * footnote definition below a paragraph, and after an indented code block\n * (issue #191). It reads the line as text there, where GitHub, commonmark.js,\n * and markdown-it read a list. By CommonMark's rules, text can start with a\n * list marker only below a link reference definition, as what remains of the\n * definition's lines; GitHub and commonmark.js read text there too, and\n * markdown-it a list. The paragraph of a task list item starts after its\n * checkbox, which renderers read as the start of the item's text, so it does\n * not count. Renderers read the `===` below such text as text, of the list\n * item or after an empty one, so a paragraph or heading on the next line\n * continues it too, and a block there is nested: a `---` would underline it.\n * Where such text ends a list item or block quote, renderers continue it\n * lazily into a paragraph or heading on the next line below the container.\n */\nexport function misreadLists(document: Document): MisreadLists {\n  const known = found.get(document.tree);\n  if (known) return known;\n  const { source } = document;\n  const text = new Set<Nodes>();\n  const nested = new Set<Nodes>();\n  const next = new Set<Nodes>();\n  /** The column of the first character from `offset` on, after spaces and tabs. */\n  const columnAt = (offset: number) => {\n    let start = offset;\n    while (start > 0 && source[start - 1] !== \"\\n\" && source[start - 1] !== \"\\r\") start--;\n    let column = 0;\n    for (let at = start; at < source.length; at++) {\n      const character = source[at];\n      if (at >= offset && character !== \" \" && character !== \"\\t\") break;\n      column = character === \"\\t\" ? column + 4 - (column % 4) : column + 1;\n    }\n    return column;\n  };\n  /** Where a paragraph's or an underlined heading's text starts. */\n  const textStart = (node: Nodes): number | undefined => {\n    const start = node.position?.start.offset;\n    if (start === undefined || node.position?.end.offset === undefined) return undefined;\n    if (node.type === \"paragraph\") return start;\n    // An underlined heading below link reference definitions starts at them.\n    if (node.type === \"heading\" && source[start] !== \"#\")\n      return node.children[0]?.position?.start.offset ?? start;\n    return undefined;\n  };\n  /** Returns the last line of misread text that ends `parent` and whose `===` renderers read as text. */\n  const visit = (parent: Parents): number | undefined => {\n    let reach: number | undefined;\n    /** The last line of misread text whose `===` renderers read as text, if the last block is that. */\n    let continued: number | undefined;\n    /** Whether that text ends the last block, a container, rather than being it. */\n    let inside = false;\n    parent.children.forEach((child, index) => {\n      const offset = child.position?.start.offset;\n      if (offset === undefined) return;\n      const start = textStart(child);\n      // Renderers continue the text lazily on the line below the container\n      // that it ends, but only with text (issue #343).\n      const adjacent =\n        continued === child.position!.start.line - 1 && (!inside || start !== undefined);\n      const misread =\n        start !== undefined &&\n        (listMarker.test(source.slice(start, start + 11)) || adjacent) &&\n        !(index === 0 && parent.type === \"listItem\" && typeof parent.checked === \"boolean\");\n      if (misread || adjacent || reach !== undefined) {\n        const column = columnAt(misread ? start! : offset);\n        if ((adjacent && !misread) || (reach !== undefined && column > reach)) nested.add(child);\n        else if (reach !== undefined) {\n          next.add(child);\n          reach = undefined;\n        }\n        if (misread) {\n          text.add(child);\n          reach = Math.min(reach ?? column, column);\n        }\n      }\n      continued =\n        misread && child.type === \"heading\" && child.depth === 1\n          ? child.position!.end.line\n          : undefined;\n      inside = false;\n      if (\"children\" in child && !leaves.has(child.type)) {\n        const last = visit(child);\n        if (last !== undefined && last === child.position!.end.line) {\n          continued = last;\n          inside = true;\n        }\n      }\n    });\n    return continued;\n  };\n  visit(document.tree);\n  const result = { text, nested, next };\n  found.set(document.tree, result);\n  return result;\n}\n"]}

package/docs/design.md

@@ -52,14 +52,15 @@ The comparison is only as good as the parser's reading:
   there are left out, plugins' too, and so are their findings. The list rules
   also leave a list there, or directly after it, as written, because another
   marker or indentation could join it to that list or move it out of the list,
-  and `style/block-spacing` adds no blank line that would make the list loose.
-  The same holds below a link reference definition, where the parser and GitHub
-  read such a line as text and markdown-it reads a list. Below an empty list
-  item (`-`), the parser takes the `[x]` that begins the next line for a
-  checkbox that belongs to no item, where GitHub shows the text `[x]`, so a
-  blank line between them, as `style/block-spacing` would add, is refused as a
-  change of meaning. The parser also keeps the spaces and tabs that start a code
-  span's next line, where CommonMark and GitHub leave them out, so that a span
+  and `style/block-spacing` adds no blank line that would make the list loose,
+  or that would end text that renderers continue on the line below the list. The
+  same holds below a link reference definition, where the parser and GitHub read
+  such a line as text and markdown-it reads a list. Below an empty list item
+  (`-`), the parser takes the `[x]` that begins the next line for a checkbox
+  that belongs to no item, where GitHub shows the text `[x]`, so a blank line
+  between them, as `style/block-spacing` would add, is refused as a change of
+  meaning. The parser also keeps the spaces and tabs that start a code span's
+  next line, where CommonMark and GitHub leave them out, so that a span
   `npm run` continued by an indented `build` reads `npm run    build`, and it
   takes a space or line ending off each end of a span before its line endings
   become spaces, where CommonMark takes spaces off after. The comparison reads a
@@ -73,7 +74,12 @@ The comparison is only as good as the parser's reading:
   lines of another table as text, where GitHub shows a table, so `style/wrap`
   and `style/block-spacing` leave text whose second line is a table delimiter
   row as written ([issue
-  #283](https://github.com/viell-dev/slop-markdown-tools/issues/283)).
+  #283](https://github.com/viell-dev/slop-markdown-tools/issues/283)). A fenced
+  code block without its closing fence runs to the end of its list item, and
+  CommonMark and GitHub count the blank lines at the end of the item as code,
+  where the parser does not, so `style/block-spacing` adds no blank line below
+  such a list ([issue
+  #350](https://github.com/viell-dev/slop-markdown-tools/issues/350)).
 - Front matter needs a closing line. A first line of `---` or `+++` that no
   later line closes is read as renderers read it, as a thematic break or text,
   with the lists and block quotes below it; the parser's front matter extension

package/docs/quick-start.md

@@ -6,7 +6,7 @@ mdrefine needs Node.js 22.12 or newer. Install the package in the project that
 holds your documents:
 
 ```sh
-npm install --save-dev --save-exact mdrefine@0.2.2
+npm install --save-dev --save-exact mdrefine@0.2.3
 npx --no-install mdtools --help
 ```
 

package/docs/rules.md

@@ -245,7 +245,9 @@ label shows its target as text, and a note embed is not the same thing as a
 Markdown image. A new wikilink decodes percent escapes, because Obsidian takes
 its text as the note's name: `[x](My%20Note.md)` becomes `[[My Note.md|x]]`. A
 destination that does not decode, or whose name would hold `|`, `[`, `]`, `#`,
-or `^`, stays as written.
+or `^`, stays as written. In a table cell, a `|` that the rule writes, between a
+new wikilink's target and label or in a new Markdown label, is escaped as `\|`,
+because one that is not escaped ends the cell.
 
 With `"style": "markdown"`, before:
 
@@ -293,11 +295,14 @@ only when the new destination leads to the same file and fragment.
 A relative path also gets `./` when it would otherwise name a different file at
 the vault's root. A destination that already has the configured spelling keeps
 its percent-encoding; a new path encodes `%` and `#`, so that it names the same
-file. Absolute filesystem paths are never written. These are left as written: a
-wikilink without a label, whose target is also its visible text; reference
-definitions, which are checked but not rewritten; autolinks; and links whose
-target is uncertain because a directory could not be read or the workspace root
-is only part of a vault (see [Obsidian
+file, and in a table cell writes a `|` in a name as `\|`, because one that is
+not escaped ends the cell. In a wikilink only the destination changes: the `|`
+or `\|` after it, the label, and an embed's size stay as written. Absolute
+filesystem paths are never written. These are left as written: a wikilink
+without a label, whose target is also its visible text; reference definitions,
+which are checked but not rewritten; autolinks; and links whose target is
+uncertain because a directory could not be read or the workspace root is only
+part of a vault (see [Obsidian
 vaults](obsidian.md#a-workspace-root-inside-a-vault)).
 
 With `{ "style": "relative", "leadingDot": true }` in `README.md`, before:
@@ -677,7 +682,9 @@ or what a comment applies to:
   blocks of a list item makes the list loose, which changes how it renders.
 - Front matter and the block below it.
 - A list that ends inside an HTML comment or another HTML block without its end
-  marker, which would take the blank line in.
+  marker, which would take the blank line in. The same goes for a list whose
+  last item ends in a fenced code block without its closing fence: renderers put
+  the blank line into the code, although the parser does not.
 - A heading or list directly below an HTML comment or below a
   `mdtools-disable-next-line` directive, which apply to the line below them.
 - The line that opens a callout or alert, such as `> [!NOTE]`, and the block
@@ -691,7 +698,9 @@ or what a comment applies to:
 - Text that the parser reads where renderers read a list, such as `- 2. Step`
   directly below text: the list or quote that starts with it, the blocks
   indented below it, and a list after them, which renderers read as part of that
-  list (see [how it works](design.md#safety-model)).
+  list, and text on the line directly below the list item or quote that it ends,
+  which renderers read as more of it (see [how it
+  works](design.md#safety-model)).
 - Directly below a table that ends in a list item or block quote: text whose
   second line is a table delimiter row. The parser reads a table there as text,
   where GitHub reads a table, and a blank line would make it a table for the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mdrefine",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Configurable Markdown linting and formatting for CommonMark, GitHub, Forgejo, Gitea, and Obsidian",
   "keywords": [
     "markdown",