@emeryld/rrroutes-export 1.0.23 → 1.0.25

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@emeryld/rrroutes-export",
   "description": "Finalized leaves export helpers and CLI for RRRoutes",
-  "version": "1.0.23",
+  "version": "1.0.25",
   "private": false,
   "type": "module",
   "main": "dist/index.cjs",

package/tools/finalized-leaves-viewer.html

@@ -381,7 +381,12 @@
       .changelog-commit-separator {
         margin-top: 12px;
         padding-top: 10px;
+        padding-bottom: 6px;
         border-top: 1px solid var(--muted);
+        position: sticky;
+        top: 0;
+        z-index: 5;
+        background: var(--bg);
       }
 
       .changelog-commit-separator:first-child {
@@ -418,6 +423,24 @@
       .changelog-schema-type {
         color: var(--schema-accent);
       }
+      .changelog-schema-details {
+        margin-top: 6px;
+      }
+      .changelog-schema-details > summary {
+        color: var(--schema-accent);
+        font-size: 12px;
+      }
+      .changelog-schema-details-body {
+        margin-top: 6px;
+        display: grid;
+        gap: 4px;
+      }
+      .changelog-schema-line > summary {
+        font-size: 12px;
+      }
+      .changelog-schema-line .meta {
+        margin-top: 4px;
+      }
 
       .event-title-row {
         display: inline-flex;
@@ -1844,6 +1867,23 @@
         return basePath
       }
 
+      function stripSectionPrefix(path, section) {
+        if (typeof path !== 'string' || typeof section !== 'string') return ''
+        if (!path) return ''
+        if (path === section) return ''
+        if (path.startsWith(`${section}.`)) return path.slice(section.length + 1)
+        if (path.startsWith(`${section}[]`)) return path.slice(section.length)
+        return path
+      }
+
+      function sourceSchemaLocation(section, path) {
+        if (typeof section !== 'string' || !section) return String(path || '')
+        const normalizedPath = stripSectionPrefix(path, section)
+        if (!normalizedPath) return section
+        if (normalizedPath.startsWith('[]')) return `${section}${normalizedPath}`
+        return `${section}.${normalizedPath}`
+      }
+
       function parseSignatureEntry(signature) {
         if (typeof signature !== 'string') return null
         const typeMatch = signature.match(/(?:^|,\s*)type=([^,]+)/)
@@ -1947,7 +1987,7 @@
       function formatSchemaDiffLine(delta) {
         if (!delta || typeof delta !== 'object') return null
         if ('section' in delta) {
-          const location = `${delta.section}.${delta.path}`
+          const location = sourceSchemaLocation(delta.section, delta.path)
           if (delta.op === 'added') {
             const afterType = formatSourceTypeLabel(delta.after)
             if (afterType) return buildSchemaDiffLine(delta.op, afterType, location)
@@ -2024,7 +2064,7 @@
           '<svg viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round"><path d="M2 4h12"/><path d="M2 8h12"/><path d="M2 12h12"/><circle cx="6" cy="4" r="1.6" fill="currentColor" stroke="none"/><circle cx="10.5" cy="8" r="1.6" fill="currentColor" stroke="none"/><circle cx="4.5" cy="12" r="1.6" fill="currentColor" stroke="none"/></svg>',
       }
 
-      function eventVisualByType(type) {
+      function eventVisualByType(type, eventKind) {
         switch (type) {
           case 'route_added':
             return {
@@ -2040,7 +2080,8 @@
             }
           case 'schema_changed':
             return {
-              actionText: 'modified schema',
+              actionText:
+                eventKind === 'route' ? 'modified route' : 'modified schema',
               actionClass: 'event-action-modified',
               icon: 'schema',
             }
@@ -2099,13 +2140,61 @@
 
       function renderEventTitle(item) {
         const row = el('div', 'event-title-row mono')
-        const visual = eventVisualByType(item?.event?.type)
+        const visual = eventVisualByType(item?.event?.type, item?.eventKind)
         row.appendChild(el('span', visual.actionClass, visual.actionText))
         row.appendChild(renderEventIcon(visual.icon))
         row.appendChild(el('span', 'event-name', `[${resolveEventName(item)}]`))
         return row
       }
 
+      function schemaDiffRawDetail(delta) {
+        if (!delta || typeof delta !== 'object') return ''
+        if ('path' in delta) {
+          const location = formatPathLabel(delta.path) || String(delta.path || '')
+          if (delta.op === 'added') {
+            return `added ${location}: ${formatRouteSchemaEntry(delta.after)}`
+          }
+          if (delta.op === 'removed') {
+            return `removed ${location}: ${formatRouteSchemaEntry(delta.before)}`
+          }
+          return `changed ${location}: ${formatRouteSchemaEntry(delta.before)} -> ${formatRouteSchemaEntry(delta.after)}`
+        }
+        if ('section' in delta) {
+          const location = sourceSchemaLocation(delta.section, delta.path)
+          if (delta.op === 'added') {
+            return `added ${location}: ${JSON.stringify(delta.after || [])}`
+          }
+          if (delta.op === 'removed') {
+            return `removed ${location}: ${JSON.stringify(delta.before || [])}`
+          }
+          return `changed ${location}: ${JSON.stringify(delta.before || [])} -> ${JSON.stringify(delta.after || [])}`
+        }
+        return JSON.stringify(delta)
+      }
+
+      function renderSchemaDiffNested(schemaDiff) {
+        if (!Array.isArray(schemaDiff) || schemaDiff.length === 0) return null
+        const wrapper = el('details', 'changelog-schema-details')
+        wrapper.appendChild(
+          el('summary', 'mono', `schema changes (${schemaDiff.length})`),
+        )
+        const body = el('div', 'changelog-schema-details-body')
+        schemaDiff.forEach((delta) => {
+          const lineNode = formatSchemaDiffLine(delta)
+          if (!lineNode) return
+          const lineDetails = el('details', 'changelog-schema-line')
+          const lineSummary = el('summary')
+          lineSummary.appendChild(lineNode)
+          lineDetails.appendChild(lineSummary)
+          lineDetails.appendChild(
+            el('div', 'meta mono', schemaDiffRawDetail(delta)),
+          )
+          body.appendChild(lineDetails)
+        })
+        wrapper.appendChild(body)
+        return wrapper
+      }
+
       function renderEventCard(event, commitBySha, options = {}) {
         const card = el('div', 'leaf-content')
         const commit = commitBySha.get(event.commitSha)
@@ -2123,16 +2212,8 @@
           card.appendChild(renderEventTitle(options.item))
         }
         if (Array.isArray(event.schemaDiff) && event.schemaDiff.length > 0) {
-          card.appendChild(
-            el('div', 'meta', `schema changes: ${event.schemaDiff.length}`),
-          )
-          const schemaChanges = el('div')
-          event.schemaDiff.forEach((delta) => {
-            const lineNode = formatSchemaDiffLine(delta)
-            if (!lineNode) return
-            schemaChanges.appendChild(lineNode)
-          })
-          card.appendChild(schemaChanges)
+          const schemaDetails = renderSchemaDiffNested(event.schemaDiff)
+          if (schemaDetails) card.appendChild(schemaDetails)
         }
         if (Array.isArray(event.cfgDiff) && event.cfgDiff.length > 0) {
           card.appendChild(
@@ -2190,8 +2271,14 @@
         const box = el('div', 'changelog-commit-separator')
         const commit = commitBySha.get(commitSha)
         const commitDateTime = formatCommitDateTime(commit?.authorDate)
-        const label = `commit ${String(commitSha || '').slice(0, 12)}`
-        const meta = [commitDateTime, commit?.authorName || null, commit?.subject || null]
+        const subjectFirstLine = String(commit?.subject || '')
+          .split('\n')
+          .map((line) => line.trim())
+          .find(Boolean)
+        const labelParts = [`commit ${String(commitSha || '').slice(0, 12)}`]
+        if (subjectFirstLine) labelParts.push(subjectFirstLine)
+        const label = labelParts.join(' ')
+        const meta = [commitDateTime, commit?.authorName || null]
           .filter(Boolean)
           .join(' - ')
         box.appendChild(el('div', 'changelog-commit-label mono', label))
@@ -2223,11 +2310,8 @@
         row.appendChild(renderEventTitle(item))
 
         if (Array.isArray(event.schemaDiff) && event.schemaDiff.length > 0) {
-          event.schemaDiff.forEach((delta) => {
-            const lineNode = formatSchemaDiffLine(delta)
-            if (!lineNode) return
-            row.appendChild(lineNode)
-          })
+          const schemaDetails = renderSchemaDiffNested(event.schemaDiff)
+          if (schemaDetails) row.appendChild(schemaDetails)
         }
         if (Array.isArray(event.cfgDiff) && event.cfgDiff.length > 0) {
           event.cfgDiff.forEach((diff) => {
@@ -2318,7 +2402,7 @@
           return { op, location, before, after }
         }
         if ('section' in delta) {
-          const location = `${delta.section}.${delta.path}`
+          const location = sourceSchemaLocation(delta.section, delta.path)
           const before = Array.isArray(delta.before)
             ? delta.before.map((item) => normalizeSignatureToken(item)).filter(Boolean)
             : []