@rse/specbook 1.2.10 → 1.2.11

package/dst/specbook-export-html-search.js

@@ -11,7 +11,9 @@
     the table header and the headings of all enclosing objects, and
     every matched word is highlighted with a <mark> element (an SVG
     <tspan> element underlaid with a <rect> inside a diagram), while
-    the table of contents (page and side panel) is filtered along  */
+    the table of contents (page and side panel) is filtered along; the
+    explicit anchor id of an object (invisible in the document) is
+    searched like its text, a hit marking the anchor symbol instead  */
 (function () {
     const tab    = document.getElementById("search")
     const toggle = document.getElementById("search-toggle")
@@ -52,7 +54,9 @@
         one not nested inside another unit (like a paragraph or diagram
         in a table cell, which is covered by its table row), where a
         diagram is searched by its SVG text labels, joined by spaces,
-        as its raw text content would run them together  */
+        as its raw text content would run them together, and where the
+        explicit anchor id of an object heading or table row joins the
+        searched text  */
     const index = () => {
         if (indexed)
             return
@@ -66,12 +70,13 @@
                             return
                         parent = parent.parentElement
                     }
-                    const text  = (el.classList.contains("diagram") ?
+                    const id    = (el.dataset.id ?? "").toLowerCase()
+                    const text  = ((el.classList.contains("diagram") ?
                         Array.from(el.querySelectorAll("text")).map((t) => t.textContent ?? "").join(" ") :
-                        (el.textContent ?? "")).toLowerCase()
+                        (el.textContent ?? "")) + " " + id).toLowerCase()
                     const words = new Set(text.split(/[^\p{L}\p{N}]+/u).filter((w) => w !== ""))
                     words.forEach((w) => { vocab.add(w) })
-                    units.push({ el, text, words, keep: false })
+                    units.push({ el, id, text, words, keep: false })
                 })
         })
 
@@ -319,12 +324,24 @@
                 el.classList.add("search-hide")
         })
 
-        /*  highlight every matched word within the kept units  */
+        /*  highlight every matched word within the kept units, plus the
+            anchor symbol of a unit whose explicit anchor id matched, as
+            the id itself is nowhere visible  */
         const words = Array.from(new Set(parts.flat()))
         const regex = buildRegex(words, Array.from(variants))
         units.forEach((unit) => {
-            if (unit.el.classList.contains("search-keep"))
-                highlight(unit.el, regex)
+            if (!unit.el.classList.contains("search-keep"))
+                return
+            highlight(unit.el, regex)
+            regex.lastIndex = 0
+            const symbol = unit.el.querySelector("span.anchor-symbol")
+            if (unit.id === "" || symbol === null || !regex.test(unit.id))
+                return
+            const mark = document.createElement("mark")
+            mark.classList.add("search-hit")
+            while (symbol.firstChild !== null)
+                mark.appendChild(symbol.firstChild)
+            symbol.appendChild(mark)
         })
 
         /*  filter the table of contents (its page rows and its side

package/dst/specbook-export-html.js

@@ -152,7 +152,7 @@ const templates = {
     /*  <Object/>  */
     "Object": textframe `
         <section>
-            <h{{ Object.level }} id="{{ Object.id }}"><span class="object-kind"{% if Object.info %} data-info="{{ Object.info }}" data-info-path="{{ Object.infopath }}"{% endif %}>{{ Object.kind }}:</span> <span class="object-name"{% if Object.spec %} data-info-spec="{{ Object.spec }}" data-info-path="{{ Object.specpath }}"{% endif %}>{{ Object.name }}</span>{% if Object.primary %} <span class="primary-marker">&#x2318;</span>{% endif %}{% if Object.paren %} <span class="anchor-paren">({{ Object.paren }})</span>{% endif %} <a href="#{{ Object.id }}"><span class="anchor-symbol">&#x2693;&#xFE0E;</span></a></h{{ Object.level }}>
+            <h{{ Object.level }} id="{{ Object.id }}"{% if Object.anchor %} data-id="{{ Object.anchor }}"{% endif %}><span class="object-kind"{% if Object.info %} data-info="{{ Object.info }}" data-info-path="{{ Object.infopath }}"{% endif %}>{{ Object.kind }}:</span> <span class="object-name"{% if Object.spec %} data-info-spec="{{ Object.spec }}" data-info-path="{{ Object.specpath }}"{% endif %}>{{ Object.name }}</span>{% if Object.primary %} <span class="primary-marker">&#x2318;</span>{% endif %}{% if Object.paren %} <span class="anchor-paren">({{ Object.paren }})</span>{% endif %} <a href="#{{ Object.id }}"><span class="anchor-symbol">&#x2693;&#xFE0E;</span></a></h{{ Object.level }}>
             {{ Object.diagram }}
             {{ Object.properties }}
             {{ Object.description }}
@@ -206,7 +206,7 @@ const templates = {
             </thead>
             <tbody>
                 {% for row in Table.rows %}
-                <tr id="{{ row.id }}"{% if row.even %} class="even"{% endif %}>
+                <tr id="{{ row.id }}"{% if row.anchor %} data-id="{{ row.anchor }}"{% endif %}{% if row.even %} class="even"{% endif %}>
                     <td><span{% if row.spec %} data-info-spec="{{ row.spec }}" data-info-path="{{ row.specpath }}"{% endif %}>{{ row.name }}</span>{% if row.primary %} <span class="primary-marker">&#x2318;</span>{% endif %}{% if row.paren %} <span class="anchor-paren">({{ row.paren }})</span>{% endif %} <a href="#{{ row.id }}"><span class="anchor-symbol">&#x2693;&#xFE0E;</span></a></td>
                     {%- for value in row.values %}<td>{{ value }}</td>{% endfor %}
                     {%- if Table.desc %}<td>{{ row.description }}</td>{% endif %}
@@ -226,7 +226,7 @@ const templates = {
             </thead>
             <tbody>
                 {% for row in Table.rows %}
-                <tr id="{{ row.id }}"{% if row.even %} class="even"{% endif %}>
+                <tr id="{{ row.id }}"{% if row.anchor %} data-id="{{ row.anchor }}"{% endif %}{% if row.even %} class="even"{% endif %}>
                     <td><span{% if row.spec %} data-info-spec="{{ row.spec }}" data-info-path="{{ row.specpath }}"{% endif %}>{{ row.name }}</span>{% if row.primary %} <span class="primary-marker">&#x2318;</span>{% endif %}{% if row.paren %} <span class="anchor-paren">({{ row.paren }})</span>{% endif %} <a href="#{{ row.id }}"><span class="anchor-symbol">&#x2693;&#xFE0E;</span></a></td>
                     <td class="chunks">
                         <table class="chunks">
@@ -1460,6 +1460,7 @@ const renderTable = (children, maxColumns) => {
                 width: Math.round(200 / (keys.length + 3)),
                 rows: children.map((child, i) => scoped(child, () => ({
                     id: anchorOf(child),
+                    anchor: child.anchor,
                     paren: child.paren,
                     primary: child.primary,
                     spec: infoParents !== null ? anchorOf(child) : undefined,
@@ -1500,6 +1501,7 @@ const renderTable = (children, maxColumns) => {
                     chunks.unshift([{ key: "Diagram", desc: true, span: size, value: diagram }]);
                 return {
                     id: anchorOf(child),
+                    anchor: child.anchor,
                     paren: child.paren,
                     primary: child.primary,
                     spec: infoParents !== null ? anchorOf(child) : undefined,
@@ -1522,6 +1524,7 @@ const renderObject = (object, level, concise) => {
             spec: infoParents !== null ? anchorOf(object) : undefined,
             specpath: infoPathOf(object),
             id: anchorOf(object),
+            anchor: object.anchor,
             paren: object.paren,
             primary: object.primary,
             name: inline(object.name),

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":                                "@rse/specbook",
-    "version":                             "1.2.10",
+    "version":                             "1.2.11",
     "publishConfig":                       { "access": "public" },
     "description":                         "Markdown-based Specification Format (API, CLI and MCP service)",
     "license":                             "Apache-2.0",
@@ -17,9 +17,9 @@
     },
     "files":                               [ "dst" ],
     "dependencies": {
-        "marked":                          "18.0.12",
+        "marked":                          "18.0.13",
         "marked-smartypants":              "1.1.12",
-        "yaml":                            "2.9.0",
+        "yaml":                            "2.9.1",
         "json5":                           "2.2.3",
         "pdf-lib":                         "1.17.1",
         "subset-font":                     "2.7.0",
@@ -40,10 +40,10 @@
         "glob":                            "13.0.6",
         "picomatch":                       "4.0.7",
         "es-toolkit":                      "1.52.0",
-        "fastify":                         "5.12.3",
+        "fastify":                         "5.12.4",
         "@fastify/websocket":              "11.3.0",
         "@modelcontextprotocol/sdk":       "1.30.0",
-        "zod":                             "4.6.1"
+        "zod":                             "4.6.5"
     },
     "devDependencies": {
         "chokidar-cli":                    "3.0.0",
@@ -55,7 +55,7 @@
         "globals":                         "17.12.0",
         "markdownlint":                    "0.41.1",
         "markdownlint-cli2":               "0.23.2",
-        "@types/node":                     "26.5.0",
+        "@types/node":                     "26.5.1",
         "@types/picomatch":                "4.0.3",
         "@types/subset-font":              "2.3.0",
         "@types/nunjucks":                 "3.2.6",