@davmash/bygone 0.10.1 → 0.11.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@davmash/bygone",
-  "version": "0.10.1",
+  "version": "0.11.0",
   "description": "See how change happened. Visual diff and file history.",
   "author": "David Mashburn",
   "license": "MIT",
@@ -40,7 +40,7 @@
     "electron"
   ],
   "dependencies": {
-    "electron": "^43.7.6",
+    "electron": "^43.8.3",
     "electron-updater": "^6.8.9",
     "js-yaml": "^4.3.0"
   }

package/schemas/change-tour-source.schema.json

@@ -7,7 +7,7 @@
   "additionalProperties": false,
   "required": ["version", "anchors", "connections", "chapters"],
   "properties": {
-    "version": { "enum": [1, 2, 4, 5] },
+    "version": { "enum": [1, 2, 4, 5, 6] },
     "opening": { "$ref": "#/$defs/passage" },
     "conclusion": { "$ref": "#/$defs/passage" },
     "title": { "$ref": "#/$defs/nonEmptyString" },
@@ -15,6 +15,7 @@
       "$ref": "#/$defs/nonEmptyString",
       "description": "Optional native window title for the tour presenter. Use a short label such as a pull request number when multiple tours may be open."
     },
+    "correspondence": { "$ref": "#/$defs/nonEmptyString", "description": "Repository-relative validated correspondence artifact; requires version 6." },
     "sourceUrl": { "type": "string", "minLength": 1 },
     "details": { "$ref": "#/$defs/details" },
     "range": {
@@ -72,7 +73,7 @@
   },
   "allOf": [
     {
-      "if": { "properties": { "version": { "const": 5 } } },
+      "if": { "properties": { "version": { "enum": [5, 6] } } },
       "then": {
         "properties": {
           "chapters": { "$ref": "#/$defs/purposeChapters" },
@@ -127,7 +128,7 @@
       }
     },
     {
-      "if": { "properties": { "version": { "enum": [2, 4, 5] } }, "required": ["version"] },
+      "if": { "properties": { "version": { "enum": [2, 4, 5, 6] } }, "required": ["version"] },
       "then": {
         "properties": {
           "chapters": {
@@ -144,9 +145,47 @@
           }
         }
       }
+    },
+    {
+      "if": {
+        "properties": {
+          "version": {
+            "enum": [
+              1,
+              2,
+              4,
+              5
+            ]
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "correspondence": false,
+          "chapters": {
+            "$ref": "#/$defs/legacySymbolChapters"
+          },
+          "tours": {
+            "additionalProperties": {
+              "properties": {
+                "chapters": {
+                  "$ref": "#/$defs/legacySymbolChapters"
+                }
+              }
+            }
+          }
+        }
+      }
     }
   ],
   "$defs": {
+    "legacySymbolChapters": {
+      "items": { "properties": { "scenes": {
+        "items": { "properties": { "steps": {
+          "items": { "properties": { "symbol": false } }
+        } } }
+      } } }
+    },
     "legacyFramingChapters": {
       "items": {
         "allOf": [
@@ -276,6 +315,7 @@
       }
     },
     "step": {
+      "not": { "anyOf": [{ "required": ["symbol", "image"] }, { "required": ["symbol", "connection"] }] },
       "type": "object",
       "additionalProperties": false,
       "required": ["id", "title", "body", "focus"],
@@ -284,6 +324,11 @@
         "title": { "$ref": "#/$defs/nonEmptyString" },
         "body": { "$ref": "#/$defs/nonEmptyString" },
         "focus": { "$ref": "#/$defs/nonEmptyString" },
+        "symbol": {
+          "type": "object", "additionalProperties": false,
+          "properties": {"relation": {"$ref": "#/$defs/nonEmptyString"}, "symbol": {"$ref": "#/$defs/nonEmptyString"}},
+          "oneOf": [{"required": ["relation"]}, {"required": ["symbol"]}]
+        },
         "image": {
           "type": "object", "additionalProperties": false,
           "required": ["file", "revision", "alt"],

package/web/export-runtime.json

@@ -1,12 +1,12 @@
 {
   "schema": 1,
-  "version": "0.10.1",
+  "version": "0.11.0",
   "assets": {
-    "web/presenter.css": "sha256-zQdYI+Wl5V3zHjwpgjytYyFguJkHrGh6usOY8wBFfVU=",
-    "media/webview.css": "sha256-M190TAd1/y9PQVR++dd3O9MG2EbmvmEOT8CKm3L/gh0=",
-    "web/web-host.js": "sha256-aADV181nqkkok1/Osu1g5VuJ3ht19o7Uoebex1vPNgU=",
+    "web/presenter.css": "sha256-UsJZl/OYwt1v1G57hlkuuvVH3VU2tdT8zz8DdXmEXyA=",
+    "media/webview.css": "sha256-GiajYKzkQfLMRBlFze7TtXtdvxqYAIGukFbgEDZpFdI=",
+    "web/web-host.js": "sha256-X4Y//onjgzIv0frhnDAhOdOEzjPpUiquJoJh4zRB8oo=",
     "media/webview.js": "sha256-pnnG4JuNqHLjkKDQy4kJ1lOtBt7UyPqUSQPIvsur2s4=",
     "media/editor.worker.js": "sha256-qWbRV7U57PL25iH34w5bTeMJ0D1QDMulvRzYEPBRKnI=",
-    "media/diff.worker.js": "sha256-A+PzHkIfw4Egmw5ciI7CZVu3725hEZ45ZLHgxtZy4t8="
+    "media/diff.worker.js": "sha256-QphF2PTO5YfP8QFMIUyQsBk3v+w9/Pi6wPsXifCR1aU="
   }
 }

package/web/index.html

@@ -31,6 +31,7 @@
         <nav id="tour-navigator-tabs" class="tour-navigator-tabs" aria-label="Tour navigator">
             <button type="button" data-tour-navigator="tour" aria-controls="tour-navigator-tour" aria-selected="true" title="Browse tour scenes">Tour <span id="tour-scene-count" class="tour-rail-count"></span></button>
             <button type="button" data-tour-navigator="files" aria-controls="tour-navigator-files" aria-selected="false" title="Browse changed files">Files <span id="tour-file-count" class="tour-rail-count"></span></button>
+            <button id="correspondence-tab" type="button" title="Explore inferred symbol mappings across the pinned comparison" data-tour-navigator="symbols" aria-controls="tour-navigator-symbols" aria-selected="false" hidden>Symbols</button>
             <button type="button" data-tour-navigator="commits" aria-controls="tour-navigator-commits" aria-selected="false" title="Browse revisions">Commits</button>
         </nav>
         <div class="tour-navigator-content">
@@ -63,6 +64,16 @@
                 <label id="tour-file-filter" class="file-tree-filter"><input id="tour-show-all-files" type="checkbox"><span id="tour-file-filter-label">Show all files</span><span id="tour-visible-file-count"></span></label>
                 <nav id="tour-files" class="tour-files" aria-label="Changed files"></nav>
             </section>
+            <section id="tour-navigator-symbols" class="tour-navigator-panel" data-tour-navigator-panel="symbols" hidden>
+                <p id="correspondence-status" role="status"></p>
+                <label>Find a symbol <input id="correspondence-filter" type="search" placeholder="Name or path"></label>
+                <label><input id="correspondence-all" type="checkbox"> Include unchanged local symbols</label>
+                <label title="Includes before-only and after-only declarations without an accepted match; these are not confirmed additions or deletions."><input id="correspondence-unmatched" type="checkbox" checked> Include added or removed local symbols</label>
+                <p id="correspondence-selection" aria-live="polite"></p>
+                <button id="correspondence-context" type="button" title="Show complete source and destination files with declarations highlighted" hidden>Show file context</button>
+                <nav id="correspondence-list" aria-label="Symbol tree"></nav>
+                <details id="correspondence-analysis"><summary>Analysis details</summary><div id="correspondence-limitations"></div></details>
+            </section>
             <section id="tour-navigator-commits" class="tour-navigator-panel" data-tour-navigator-panel="commits" hidden>
                 <div id="tour-history-controls" class="tour-evidence-controls" hidden>
                     <div class="tour-selection-toolbar">
@@ -181,6 +192,7 @@
                 <span id="tour-directory-narration-context" class="tour-directory-narration-context" hidden>Narration describes the overview</span>
             </nav>
             <div id="file-info" class="header-align-diff">Choose a compare command to render a diff.</div>
+            <button id="file-symbol-context" class="header-align-diff" type="button" title="Switch between the symbol comparison and its full file context" hidden>Show file context</button>
             <div id="status-banner" class="status-banner header-align-diff" role="status" aria-live="polite" aria-atomic="true" hidden></div>
             <div id="directory-return-toolbar" class="directory-return-toolbar header-align-diff" hidden>
                 <button id="back-to-directory" class="directory-return-button" type="button" title="Show directory comparison (Cmd/Ctrl+[)" aria-label="Show directory comparison">

package/web/presenter.css

@@ -1579,3 +1579,84 @@ body.tour-bookend.tour-discussion #tour-narrative-resizer { display: none; }
 
 .tour-route-chapter { margin-top: 1.5em; }
 .tour-route-chapter > .tour-route { margin-top: 1em; padding-left: 1em; border-left: 2px solid var(--tour-border); }
+
+/* Optional, revision-pinned symbol correspondence exploration. */
+#tour-navigator-symbols { padding: 12px; overflow: auto; }
+#tour-navigator-symbols label { display: block; margin: 8px 0; }
+#correspondence-filter { width: 100%; box-sizing: border-box; }
+.correspondence-tree, .correspondence-tree ul { list-style: none; margin: 0; padding: 0; }
+.correspondence-tree ul { margin-left: 11px; padding-left: 10px; border-left: 1px solid var(--tour-border); }
+.correspondence-heading { display: flex; align-items: flex-start; gap: 3px; margin: 3px 0; }
+.correspondence-toggle { flex: 0 0 18px; width: 18px; padding: 8px 0; background: none; border: 0; color: var(--tour-muted); cursor: pointer; }
+.correspondence-toggle[hidden] { display: block !important; visibility: hidden; }
+.correspondence-file-label { min-width: 0; padding: 8px 2px; border: 0; background: none; color: inherit; font: inherit; font-size: 12px; font-weight: 600; overflow-wrap: anywhere; text-align: left; cursor: pointer; }
+.correspondence-file + .correspondence-file { margin-top: 12px; }
+.correspondence-item { display: flex; flex: 1; min-width: 0; flex-direction: column; align-items: flex-start; gap: 3px; text-align: left; padding: 7px; border: 1px solid transparent; border-radius: 4px; background: none; color: inherit; cursor: pointer; font: inherit; }
+.correspondence-item strong { font-size: 12px; font-weight: 500; overflow-wrap: anywhere; }
+.correspondence-item[data-change-kind="added"] > strong { color: var(--vscode-gitDecoration-addedResourceForeground, #8ed6a5); }
+.correspondence-item[data-change-kind="modified"] > strong { color: var(--vscode-gitDecoration-modifiedResourceForeground, #e2b36b); }
+.correspondence-item[data-change-kind="deleted"] > strong { color: var(--vscode-gitDecoration-deletedResourceForeground, #f48771); }
+.correspondence-item span { font-size: 12px; overflow-wrap: anywhere; color: var(--tour-muted); }
+.correspondence-location { display: none; }
+.correspondence-item.is-relocated .correspondence-location, .correspondence-item:hover .correspondence-location, .correspondence-item[aria-pressed="true"] .correspondence-location, .correspondence-item:focus-visible .correspondence-location { display: block; }
+.is-context > .correspondence-heading > .correspondence-item { opacity: .65; }
+.correspondence-item:hover, .correspondence-file-label:hover { background: var(--vscode-list-hoverBackground, #ffffff0d); }
+.correspondence-item:focus-visible, .correspondence-toggle:focus-visible, .correspondence-file-label:focus-visible { outline: 2px solid var(--vscode-focusBorder, #58a6ff); outline-offset: -2px; }
+.correspondence-item[aria-pressed="true"] { outline: 1px solid var(--vscode-focusBorder, #58a6ff); }
+#correspondence-status, #correspondence-selection, #correspondence-limitations { font-size: 12px; overflow-wrap: anywhere; }
+#correspondence-analysis { margin-top: 16px; border-top: 1px solid var(--tour-border); padding-top: 12px; }
+#correspondence-limitations details { margin: 12px 0; }
+#correspondence-limitations summary { cursor: pointer; line-height: 1.5; }
+.correspondence-diagnostics { list-style: none; margin: 8px 0; padding: 0; }
+.correspondence-diagnostics li { padding: 10px 0; border-top: 1px solid var(--tour-border); }
+.correspondence-diagnostics p { margin: 5px 0; }
+.correspondence-diagnostics code { font-size: 12px; color: var(--tour-muted); }
+.correspondence-diagnostic-location { display: block; margin-top: 6px; padding: 3px 0; font: inherit; color: inherit; overflow-wrap: anywhere; text-align: left; }
+button.correspondence-diagnostic-location { background: none; border: 0; text-decoration: underline; cursor: pointer; }
+button.correspondence-diagnostic-location:focus-visible { outline: 2px solid var(--vscode-focusBorder, #58a6ff); }
+
+.tour-navigator-tabs:has(#correspondence-tab:not([hidden])) { grid-template-columns: repeat(4, minmax(0, 1fr)); }
+
+.file-symbols { margin: 4px 0 8px 16px; font-size: 12px; }
+.file-symbols[hidden] { display: none; }
+.has-file-symbols { position: relative; }
+.has-file-symbols > .tour-file { padding-right: 32px; }
+.file-symbol-toggle {
+    position: absolute;
+    top: 5px;
+    right: 4px;
+    width: 24px;
+    height: 28px;
+    padding: 0;
+    font: inherit;
+    font-size: 16px;
+    line-height: 1;
+    color: var(--tour-muted);
+    background: transparent;
+    border: 0;
+    border-radius: 4px;
+    cursor: pointer;
+}
+.file-symbol-toggle:hover { color: var(--tour-body); background: var(--bygone-hover); }
+.file-symbol-toggle:focus-visible { outline: 2px solid var(--vscode-focusBorder, #58a6ff); }
+.tour-file[data-change-kind="added"] { --file-status-color: var(--vscode-gitDecoration-addedResourceForeground, #8ed6a5); }
+.tour-file[data-change-kind="deleted"] { --file-status-color: var(--vscode-gitDecoration-deletedResourceForeground, #f48771); }
+.tour-file[data-change-kind="modified"] { --file-status-color: var(--vscode-gitDecoration-modifiedResourceForeground, #e2b36b); }
+.tour-file[data-change-kind="renamed"] { --file-status-color: var(--vscode-gitDecoration-renamedResourceForeground, #73c991); }
+.tour-file[data-change-kind]:not(.is-comparison-empty) .tour-file-path,
+.tour-file[data-change-kind]:not(.is-comparison-empty) .tour-file-marker { color: var(--file-status-color, var(--tour-body)); }
+.correspondence-file-label[aria-current="true"] { outline: 1px solid var(--vscode-focusBorder, #58a6ff); }
+#correspondence-context, #file-symbol-context {
+    width: fit-content;
+    max-width: 100%;
+    margin-top: 6px;
+    margin-bottom: 6px;
+    padding: 5px 9px;
+    color: var(--tour-accent-bright);
+    background: var(--bygone-selection);
+    border: 1px solid var(--tour-border);
+    border-radius: 4px;
+    cursor: pointer;
+    font: inherit;
+}
+#correspondence-context:hover, #file-symbol-context:hover { background: var(--bygone-hover); }