@emeryld/rrroutes-export 1.0.1 → 1.0.4

package/README.md

@@ -7,3 +7,4 @@ Export helpers and CLI for RRRoutes finalized leaves.
 - Schema utilities: `serializeLeafContract`, `flattenLeafSchemas`, `introspectSchema`
 
 Depends on `@emeryld/rrroutes-contract` for contract types and schema parsing.
+This package is configured to install `@emeryld/rrroutes-contract` from npm (not from the local workspace) to ensure release-version parity.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@emeryld/rrroutes-export",
   "description": "Finalized leaves export helpers and CLI for RRRoutes",
-  "version": "1.0.1",
+  "version": "1.0.4",
   "private": false,
   "type": "module",
   "main": "dist/index.cjs",
@@ -23,7 +23,7 @@
     "bin/rrroutes-export-finalized-leaves.mjs"
   ],
   "dependencies": {
-    "@emeryld/rrroutes-contract": "^2.7.13",
+    "@emeryld/rrroutes-contract": "^2.8.0",
     "typescript": "^5.9.3",
     "zod": "^4.3.6"
   },

package/tools/finalized-leaves-viewer.html

@@ -924,15 +924,35 @@
         return node
       }
 
-      function setHighlighted(node, text, engine) {
-        node.innerHTML = engine.highlight(text ?? '')
+      function normalizeFieldIds(fieldIds) {
+        if (!fieldIds) return []
+        return Array.isArray(fieldIds) ? fieldIds : [fieldIds]
       }
 
-      function kv(key, value, engine) {
+      function shouldHighlightField(fieldIds, selectedIds) {
+        const ids = normalizeFieldIds(fieldIds)
+        if (ids.length === 0) return false
+        if (!Array.isArray(selectedIds)) return false
+        return ids.some((id) => selectedIds.includes(id))
+      }
+
+      function highlightWithFieldScope(text, engine, selectedIds, fieldIds) {
+        const source = text ?? ''
+        if (!engine.active || !shouldHighlightField(fieldIds, selectedIds)) {
+          return escapeHtml(source)
+        }
+        return engine.highlight(source)
+      }
+
+      function setHighlighted(node, text, engine, selectedIds, fieldIds) {
+        node.innerHTML = highlightWithFieldScope(text, engine, selectedIds, fieldIds)
+      }
+
+      function kv(key, value, engine, selectedIds, fieldIds) {
         const box = el('div', 'kv')
         box.appendChild(el('div', 'k', key))
         const valueNode = el('div', 'v mono')
-        setHighlighted(valueNode, value === undefined ? '—' : String(value), engine)
+        setHighlighted(valueNode, value === undefined ? '—' : String(value), engine, selectedIds, fieldIds)
         box.appendChild(valueNode)
         return box
       }
@@ -982,12 +1002,12 @@
         return `vscode://file/${encodeURI(vscodePath)}:${line}:${column}`
       }
 
-      function createSourceRow(label, source, engine) {
+      function createSourceRow(label, source, engine, selectedIds, fieldIds) {
         const box = el('div', 'kv')
         const labelNode = el('div', 'v mono')
 
         if (!source || !source.file) {
-          setHighlighted(labelNode, label, engine)
+          setHighlighted(labelNode, label, engine, selectedIds, fieldIds)
           box.appendChild(labelNode)
           return box
         }
@@ -997,7 +1017,7 @@
         link.href = href
         link.target = '_blank'
         link.rel = 'noopener noreferrer'
-        link.innerHTML = engine.highlight(label)
+        link.innerHTML = highlightWithFieldScope(label, engine, selectedIds, fieldIds)
         labelNode.appendChild(link)
         box.appendChild(labelNode)
         return box
@@ -1083,14 +1103,14 @@
         return root
       }
 
-      function renderTreeNode(node, engine, isRoot) {
+      function renderTreeNode(node, engine, selectedIds, sectionName, isRoot) {
         const childKeys = Object.keys(node.children)
         const hasChildren = childKeys.length > 0
         const hasInfo = Boolean(node.info)
         const appendNameCell = (row) => {
           const nameWrap = el('span', 'mono tree-name')
           const nameNode = el('span')
-          setHighlighted(nameNode, node.name, engine)
+          setHighlighted(nameNode, node.name, engine, selectedIds, sectionName)
           nameWrap.appendChild(nameNode)
 
           if (node.info && !node.info.optional) {
@@ -1107,7 +1127,10 @@
 
         const appendTypeCell = (row, info) => {
           const type = el('span', 'tree-pill')
-          setHighlighted(type, info?.type || info?.kind || '—', engine)
+          setHighlighted(type, info?.type || info?.kind || '—', engine, selectedIds, [
+            sectionName,
+            'types',
+          ])
           row.appendChild(type)
         }
 
@@ -1126,7 +1149,11 @@
           const container = el('div', 'schema-tree')
           childKeys
             .sort((a, b) => a.localeCompare(b))
-            .forEach((key) => container.appendChild(renderTreeNode(node.children[key], engine, false)))
+            .forEach((key) =>
+              container.appendChild(
+                renderTreeNode(node.children[key], engine, selectedIds, sectionName, false),
+              ),
+            )
           details.appendChild(container)
           return details
         }
@@ -1163,7 +1190,7 @@
           hasAnySchemaEntries = true
           const block = el('div', 'schema-block')
           const header = el('div', 'schema-header mono')
-          setHighlighted(header, sectionName, engine)
+          setHighlighted(header, sectionName, engine, selectedIds, sectionName)
           block.appendChild(header)
 
           const schemaSource = getSchemaSource(source, sectionName)
@@ -1176,12 +1203,14 @@
                 ),
                 schemaSource.sourceValue,
                 engine,
+                selectedIds,
+                'sourceSchemas',
               ),
             )
           }
 
           const tree = buildSchemaTree(entries, sectionName)
-          block.appendChild(renderTreeNode(tree, engine, true))
+          block.appendChild(renderTreeNode(tree, engine, selectedIds, sectionName, true))
 
           section.appendChild(block)
         })
@@ -1192,7 +1221,13 @@
       function renderLeaf(leaf, engine, selectedIds) {
         const details = el('details', 'leaf')
         const summary = el('summary')
-        setHighlighted(summary, `${String(leaf.method || '').toUpperCase()} ${leaf.path || ''}`, engine)
+        setHighlighted(
+          summary,
+          `${String(leaf.method || '').toUpperCase()} ${leaf.path || ''}`,
+          engine,
+          selectedIds,
+          ['method', 'path'],
+        )
         details.appendChild(summary)
 
         const content = el('div', 'leaf-content')
@@ -1202,32 +1237,38 @@
         const overview = el('div', 'section')
         overview.appendChild(el('h3', '', 'Overview'))
         const topGrid = el('div', 'grid-3')
-        topGrid.appendChild(kv('group', cfg.docsGroup, engine))
+        topGrid.appendChild(kv('group', cfg.docsGroup, engine, selectedIds, 'docsGroup'))
         topGrid.appendChild(
-          kv('tags', cfg.tags && cfg.tags.length > 0 ? cfg.tags.join(', ') : undefined, engine),
+          kv(
+            'tags',
+            cfg.tags && cfg.tags.length > 0 ? cfg.tags.join(', ') : undefined,
+            engine,
+            selectedIds,
+            'tags',
+          ),
         )
-        topGrid.appendChild(kv('stability', cfg.stability, engine))
+        topGrid.appendChild(kv('stability', cfg.stability, engine, selectedIds, 'stability'))
         overview.appendChild(topGrid)
-        overview.appendChild(kv('summary', cfg.summary, engine))
-        overview.appendChild(kv('description', cfg.description, engine))
+        overview.appendChild(kv('summary', cfg.summary, engine, selectedIds, 'summary'))
+        overview.appendChild(kv('description', cfg.description, engine, selectedIds, 'description'))
 
         const iconRow = el('div', 'icon-row')
         if (cfg.feed) {
           const feed = el('span', 'icon-badge feed')
           feed.title = 'Feed endpoint'
-          setHighlighted(feed, 'Feed', engine)
+          feed.textContent = 'Feed'
           iconRow.appendChild(feed)
         }
         if (cfg.deprecated) {
           const deprecated = el('span', 'icon-badge warn')
           deprecated.title = 'Deprecated'
-          setHighlighted(deprecated, 'D', engine)
+          deprecated.textContent = 'D'
           iconRow.appendChild(deprecated)
         }
         if (cfg.docsHidden) {
           const hidden = el('span', 'icon-badge warn')
           hidden.title = 'Hidden'
-          setHighlighted(hidden, 'H', engine)
+          hidden.textContent = 'H'
           iconRow.appendChild(hidden)
         }
         if (iconRow.childNodes.length > 0) {
@@ -1241,7 +1282,7 @@
           const chips = el('div', 'chips')
           cfg.bodyFiles.forEach((file) => {
             const chip = el('span', 'chip ok')
-            setHighlighted(chip, `${file.name} (max ${file.maxCount})`, engine)
+            chip.textContent = `${file.name} (max ${file.maxCount})`
             chips.appendChild(chip)
           })
           files.appendChild(chips)
@@ -1251,7 +1292,9 @@
         const sourceByLeaf = state.payload?.sourceByLeaf || {}
         const source = sourceByLeaf[leaf.key]
         if (source?.definition) {
-          overview.appendChild(createSourceRow('definition', source.definition, engine))
+          overview.appendChild(
+            createSourceRow('definition', source.definition, engine, selectedIds, 'sourceDefinition'),
+          )
         }
 
         const separatedSchemas = renderSeparatedSchemas(flatSchema, engine, selectedIds, source)