shelving 1.266.0 → 1.267.0

package/markup/rule/heading.d.ts

@@ -3,6 +3,7 @@
  * - `#` 1-6 hashes, then one or more spaces, then the title.
  * - `#` must be the first character on the line.
  * - Markdown's underline syntax is not supported (for simplification).
+ * - Each heading gets a `getSlug()` `id` derived from its text, so same-page `#anchor` links resolve to it (e.g. `## React integration` becomes `id="react-integration"`). An all-punctuation heading that slugs to nothing gets no `id`.
  *
  * @example new MarkupParser({ rules: [HEADING_RULE] }).parse("# Title")
  * @see https://shelving.cc/markup/HEADING_RULE

package/markup/rule/heading.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { getSlug } from "../../util/string.js";
 import { createMarkupRule } from "../MarkupRule.js";
 import { createLineRegExp, LINE_CONTENT_REGEXP, LINE_SPACE_REGEXP } from "../util/regexp.js";
 /**
@@ -6,6 +7,7 @@ import { createLineRegExp, LINE_CONTENT_REGEXP, LINE_SPACE_REGEXP } from "../uti
  * - `#` 1-6 hashes, then one or more spaces, then the title.
  * - `#` must be the first character on the line.
  * - Markdown's underline syntax is not supported (for simplification).
+ * - Each heading gets a `getSlug()` `id` derived from its text, so same-page `#anchor` links resolve to it (e.g. `## React integration` becomes `id="react-integration"`). An all-punctuation heading that slugs to nothing gets no `id`.
  *
  * @example new MarkupParser({ rules: [HEADING_RULE] }).parse("# Title")
  * @see https://shelving.cc/markup/HEADING_RULE
@@ -13,5 +15,7 @@ import { createLineRegExp, LINE_CONTENT_REGEXP, LINE_SPACE_REGEXP } from "../uti
 export const HEADING_RULE = createMarkupRule(createLineRegExp(`(?<prefix>#{1,6})(?:${LINE_SPACE_REGEXP}+(?<heading>${LINE_CONTENT_REGEXP}))?`), (key, { prefix, heading = "" }, parser) => {
     // The hash count picks the heading level; cast the dynamic tag to the known `h1`–`h6` set.
     const Heading = `h${prefix.length}`;
-    return _jsx(Heading, { children: parser.parse(heading.trim(), "inline") }, key);
+    const title = heading.trim();
+    // Slug the raw title (before inline parsing) for the `id`, so `#anchor` fragment links land on the heading.
+    return (_jsx(Heading, { id: getSlug(title), children: parser.parse(title, "inline") }, key));
 }, ["block"]);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "shelving",
-	"version": "1.266.0",
+	"version": "1.267.0",
 	"author": "Dave Houlbrooke <dave@shax.com>",
 	"repository": {
 		"type": "git",