@davmash/bygone 0.8.14 → 0.9.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +40 -0
- package/README.md +2 -2
- package/cli/commandSpec.js +12 -2
- package/cli/completions.js +1 -1
- package/cli/present.js +89 -7
- package/cli/tour.js +13 -2
- package/cli/tourFile.js +9 -0
- package/cli/tourHistory.js +432 -0
- package/completions/_bygone +2 -1
- package/completions/bygone +1 -1
- package/completions/bygone.fish +1 -0
- package/docs/change-tour-format.md +199 -7
- package/docs/explore.md +21 -1
- package/docs/generating-change-tours.md +70 -17
- package/docs/present.md +134 -5
- package/docs/product-surface.md +64 -8
- package/docs/releasing.md +25 -29
- package/examples/bygone-history.bygone +52 -10
- package/examples/navigation-lab.bygone.yaml +420 -0
- package/media/diff.worker.js +3 -3
- package/media/webview.css +1 -1
- package/media/webview.js +546 -178
- package/out/changeTour.js +1391 -469
- package/out/gitComparison.js +354 -0
- package/out/standalone-main.js +13989 -4749
- package/out/tourCoverage.js +1434 -461
- package/package.json +2 -2
- package/schemas/change-tour-source.schema.json +222 -3
- package/skills/pr-tour-guide/SKILL.md +111 -11
- package/standalone/index.html +6 -1
- package/web/index.html +114 -73
- package/web/presenter.css +658 -230
- package/web/web-host.js +374 -5
package/web/index.html
CHANGED
|
@@ -11,102 +11,132 @@
|
|
|
11
11
|
<aside id="tour-shell" class="tour-shell" hidden>
|
|
12
12
|
<header class="tour-overview">
|
|
13
13
|
<button id="tour-sidebar-hide" class="tour-sidebar-hide" type="button" title="Hide tour sidebar" aria-label="Hide tour sidebar">‹</button>
|
|
14
|
-
<h1 id="tour-title"></h1>
|
|
15
|
-
<
|
|
16
|
-
|
|
17
|
-
<
|
|
18
|
-
<div id="tour-
|
|
14
|
+
<h1><button id="tour-title" type="button" title="Back to the beginning of the tour"></button></h1>
|
|
15
|
+
<div id="tour-mode-controls" class="tour-mode-controls" hidden>
|
|
16
|
+
<nav id="tour-mode-tabs" class="tour-mode-tabs" aria-label="Presentation mode"></nav>
|
|
17
|
+
<p id="tour-mode-description" class="tour-mode-description"></p>
|
|
18
|
+
<div id="tour-mode-status" role="status" aria-live="polite"></div>
|
|
19
19
|
</div>
|
|
20
|
+
<details class="tour-details">
|
|
21
|
+
<summary>Tour details</summary>
|
|
22
|
+
<a id="tour-source" class="tour-source" target="_blank" rel="noreferrer" hidden>Open source ↗</a>
|
|
23
|
+
<div class="tour-meta">
|
|
24
|
+
<div id="tour-range" class="tour-range"></div>
|
|
25
|
+
<div id="tour-stats" class="tour-stats"></div>
|
|
26
|
+
</div>
|
|
27
|
+
<div id="tour-authoring-coverage" class="tour-authoring-coverage" aria-label="Tour authoring coverage" hidden></div>
|
|
28
|
+
</details>
|
|
29
|
+
<button id="tour-review-toggle" class="tour-review-toggle" type="button" title="Read authored review notes and open their evidence" aria-controls="tour-review" aria-expanded="false" hidden>Review notes</button>
|
|
20
30
|
</header>
|
|
21
|
-
<
|
|
22
|
-
<
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
31
|
+
<nav id="tour-navigator-tabs" class="tour-navigator-tabs" aria-label="Tour navigator">
|
|
32
|
+
<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>
|
|
33
|
+
<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>
|
|
34
|
+
<button type="button" data-tour-navigator="commits" aria-controls="tour-navigator-commits" aria-selected="false" title="Browse revisions">Commits</button>
|
|
35
|
+
</nav>
|
|
36
|
+
<div class="tour-navigator-content">
|
|
37
|
+
<section id="tour-navigator-tour" class="tour-navigator-panel" data-tour-navigator-panel="tour">
|
|
38
|
+
<details class="tour-search-disclosure">
|
|
39
|
+
<summary>Search tour</summary>
|
|
40
|
+
<section class="tour-search" aria-label="Search tour">
|
|
41
|
+
<div class="tour-search-controls">
|
|
42
|
+
<input id="tour-search-input" type="search" placeholder="Search tour" aria-label="Search tour narrative and code">
|
|
43
|
+
<select id="tour-search-scope" aria-label="Tour search scope" title="Tour search scope">
|
|
44
|
+
<option value="all">Narrative + code</option>
|
|
45
|
+
<option value="narrative">Narrative</option>
|
|
46
|
+
<option value="code">Code</option>
|
|
47
|
+
</select>
|
|
48
|
+
</div>
|
|
49
|
+
<div id="tour-search-status" class="tour-search-status" role="status" aria-live="polite"></div>
|
|
50
|
+
<div id="tour-search-results" class="tour-search-results" role="listbox"></div>
|
|
51
|
+
</section>
|
|
52
|
+
</details>
|
|
35
53
|
<header class="tour-rail-heading">
|
|
36
54
|
<span>Tour</span>
|
|
37
|
-
<span id="tour-scene-count" class="tour-rail-count"></span>
|
|
38
55
|
</header>
|
|
39
56
|
<nav id="tour-scenes" class="tour-scenes" aria-label="Change tour scenes"></nav>
|
|
40
57
|
</section>
|
|
41
|
-
<section class="tour-
|
|
58
|
+
<section id="tour-navigator-files" class="tour-navigator-panel" data-tour-navigator-panel="files" hidden>
|
|
42
59
|
<header class="tour-rail-heading">
|
|
43
60
|
<span>Files</span>
|
|
44
|
-
<span id="tour-file-count" class="tour-rail-count"></span>
|
|
45
61
|
<button id="tour-return-focus" class="tour-return-focus" type="button" title="Return to the file focused by the current tour step" hidden>Return to tour</button>
|
|
46
62
|
</header>
|
|
47
63
|
<nav id="tour-files" class="tour-files" aria-label="Changed files"></nav>
|
|
48
64
|
</section>
|
|
65
|
+
<section id="tour-navigator-commits" class="tour-navigator-panel" data-tour-navigator-panel="commits" hidden>
|
|
66
|
+
<div id="tour-history-controls" class="tour-evidence-controls" hidden>
|
|
67
|
+
<div class="tour-evidence-actions">
|
|
68
|
+
<button id="tour-history-compare" type="button" title="Compare the selected revisions" disabled>Compare selected (0)</button>
|
|
69
|
+
<button id="tour-history-clear" type="button" title="Uncheck all draft revisions without changing panels">Clear selection</button>
|
|
70
|
+
<button id="tour-history-reset" type="button" title="Select the revisions currently loaded in panels">Reset selection</button>
|
|
71
|
+
<button id="tour-history-parent" type="button" title="Compare this revision with its parent">Parent</button>
|
|
72
|
+
<button id="tour-history-base" type="button" title="Compare this revision with the review base">Review base</button>
|
|
73
|
+
<button id="tour-history-final" type="button" title="Compare the review base with its head across all changed files">Final diff</button>
|
|
74
|
+
</div>
|
|
75
|
+
</div>
|
|
76
|
+
<div id="tour-compare-controls" class="tour-evidence-controls" hidden>
|
|
77
|
+
<div id="tour-compare-scope"></div>
|
|
78
|
+
<div class="tour-evidence-actions">
|
|
79
|
+
<button id="tour-compare-apply" type="button" title="Update the comparison with the selected revisions" disabled>Update comparison (0)</button>
|
|
80
|
+
<button id="tour-compare-clear" type="button" title="Uncheck all draft revisions without changing panels">Clear selection</button>
|
|
81
|
+
<button id="tour-compare-reset" type="button" title="Select the revisions currently loaded in panels">Reset selection</button>
|
|
82
|
+
<button id="tour-compare-final" type="button" title="Compare the review base with its head across all changed files">Final diff</button>
|
|
83
|
+
<button id="tour-compare-all" type="button" title="Compare these revisions across all changed files" hidden>All files</button>
|
|
84
|
+
</div>
|
|
85
|
+
</div>
|
|
86
|
+
<div id="tour-commits-host" class="tour-commits-host"></div>
|
|
87
|
+
<p class="tour-commit-legend"><span>● Changed this file</span><span># Loaded panel</span><span><span class="tour-range-swatch" aria-hidden="true"></span>Tour range</span></p>
|
|
88
|
+
</section>
|
|
49
89
|
</div>
|
|
50
|
-
<details class="tour-commits-section">
|
|
51
|
-
<summary id="tour-commits-summary">0 commits</summary>
|
|
52
|
-
<ol id="tour-commits" class="tour-commits"></ol>
|
|
53
|
-
</details>
|
|
54
90
|
<div id="tour-sidebar-resizer" class="tour-sidebar-resizer" role="separator" aria-label="Resize tour sidebar" title="Resize tour sidebar (Left/Right; Home/End)" aria-orientation="vertical" aria-valuemin="240" aria-valuemax="600" tabindex="0"></div>
|
|
55
91
|
</aside>
|
|
92
|
+
<section id="tour-review" class="tour-review" aria-labelledby="tour-review-title" hidden>
|
|
93
|
+
<header class="tour-review-heading">
|
|
94
|
+
<h2 id="tour-review-title">Review notes</h2>
|
|
95
|
+
<button id="tour-review-close" type="button" title="Close review notes (Escape)" aria-label="Close review notes">Close</button>
|
|
96
|
+
</header>
|
|
97
|
+
<div id="tour-review-content" class="tour-review-content"></div>
|
|
98
|
+
<p id="tour-review-status" role="status" aria-live="polite"></p>
|
|
99
|
+
</section>
|
|
56
100
|
<button id="tour-sidebar-show" class="tour-sidebar-show" type="button" title="Show tour sidebar" aria-label="Show tour sidebar" hidden>›</button>
|
|
57
101
|
<section id="tour-narrative" class="tour-narrative" hidden>
|
|
58
|
-
<
|
|
59
|
-
<button id="tour-previous" type="button" title="Previous tour item (Left or Page Up)">← Prev</button>
|
|
102
|
+
<div class="tour-narrative-toolbar" role="group" aria-label="Tour reading view">
|
|
60
103
|
<span id="tour-breadcrumb" class="tour-breadcrumb"></span>
|
|
61
|
-
<
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
<div class="tour-narrative-layout">
|
|
92
|
-
<div class="tour-narrative-prose">
|
|
93
|
-
<div id="tour-narrative-chapter" class="tour-narrative-chapter"></div>
|
|
94
|
-
<h2 id="tour-narrative-title"></h2>
|
|
95
|
-
<p id="tour-narrative-summary" class="tour-narrative-summary"></p>
|
|
96
|
-
<ul id="tour-narrative-bullets" class="tour-narrative-bullets"></ul>
|
|
97
|
-
<div id="tour-narrative-tags" class="tour-narrative-tags"></div>
|
|
98
|
-
</div>
|
|
99
|
-
<div class="tour-narrative-side">
|
|
100
|
-
<div id="tour-step" class="tour-step" hidden>
|
|
101
|
-
<div id="tour-step-title" class="tour-step-title"></div>
|
|
102
|
-
<p id="tour-step-body" class="tour-step-body"></p>
|
|
103
|
-
<div id="tour-connection" class="tour-connection" hidden></div>
|
|
104
|
+
<div class="tour-narration-dock">
|
|
105
|
+
<div id="tour-audio-settings" class="tour-audio-settings" hidden>
|
|
106
|
+
<div id="tour-narration-controls" class="tour-narration-controls" role="group" aria-label="Tour narration">
|
|
107
|
+
<button id="tour-listen" type="button" title="Listen from the current tour item" aria-label="Listen from the current tour item">
|
|
108
|
+
<svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path class="tour-icon-fill tour-play-pause-icon" d="m8 5 11 7-11 7Z"/></svg><span id="tour-listen-label">Listen</span>
|
|
109
|
+
</button>
|
|
110
|
+
<div class="tour-narration-transport" role="group" aria-label="Narration playback">
|
|
111
|
+
<button id="tour-narration-skip-back" type="button" title="Previous sentence" aria-label="Previous sentence" disabled>
|
|
112
|
+
<svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M3 12a9 9 0 1 0 3-6.7L3 8"/><path d="M3 3v5h5"/></svg>
|
|
113
|
+
</button>
|
|
114
|
+
<button id="tour-stop" type="button" title="Stop narration" aria-label="Stop narration" disabled>
|
|
115
|
+
<svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path class="tour-icon-fill" d="M6 6h12v12H6z"/></svg>
|
|
116
|
+
</button>
|
|
117
|
+
<button id="tour-narration-skip-ahead" type="button" title="Next sentence" aria-label="Next sentence" disabled>
|
|
118
|
+
<svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M21 12a9 9 0 1 1-3-6.7L21 8"/><path d="M21 3v5h-5"/></svg>
|
|
119
|
+
</button>
|
|
120
|
+
</div>
|
|
121
|
+
<div class="tour-narration-settings">
|
|
122
|
+
<select id="tour-narration-voice" aria-label="Narration voice" title="Narration voice" disabled>
|
|
123
|
+
<option value="">System default voice</option>
|
|
124
|
+
</select>
|
|
125
|
+
<select id="tour-narration-rate" aria-label="Narration speed" title="Narration speed">
|
|
126
|
+
<option value="0.75">0.75×</option>
|
|
127
|
+
<option value="1">1×</option>
|
|
128
|
+
<option value="1.25">1.25×</option>
|
|
129
|
+
<option value="1.5">1.5×</option>
|
|
130
|
+
</select>
|
|
131
|
+
</div>
|
|
132
|
+
<span id="tour-narration-status" class="tour-narration-status" role="status" aria-live="polite" aria-atomic="true">Device voice ready</span>
|
|
133
|
+
</div>
|
|
104
134
|
</div>
|
|
105
|
-
<
|
|
135
|
+
<button id="tour-narration" type="button" title="Show narration controls" aria-label="Show narration controls" aria-controls="tour-audio-settings" aria-expanded="false">‹ Narration</button>
|
|
106
136
|
</div>
|
|
107
137
|
</div>
|
|
138
|
+
<div id="tour-narrative-content" class="tour-narrative-content" tabindex="0" role="region" aria-label="Tour reading flow"></div>
|
|
108
139
|
</section>
|
|
109
|
-
<div id="tour-narrative-resizer" class="tour-narrative-resizer" role="separator" aria-label="Resize tour header" title="Resize tour header (Up/Down; Home/End)" aria-orientation="horizontal" aria-valuemin="180" tabindex="0"></div>
|
|
110
140
|
<div class="web-toolbar">
|
|
111
141
|
<div class="web-toolbar-group">
|
|
112
142
|
<button id="web-compare-test" type="button" title="Compare sample files">Compare Test Files</button>
|
|
@@ -121,6 +151,12 @@
|
|
|
121
151
|
|
|
122
152
|
<div id="container">
|
|
123
153
|
<div id="header">
|
|
154
|
+
<nav id="tour-directory-breadcrumb" class="tour-directory-breadcrumb header-align-diff" aria-label="Overview evidence" hidden>
|
|
155
|
+
<button id="tour-directory-root" type="button" title="Return to the overview directory comparison (Cmd/Ctrl+[)" aria-current="location">Overview</button>
|
|
156
|
+
<span id="tour-directory-separator" aria-hidden="true" hidden>›</span>
|
|
157
|
+
<span id="tour-directory-file" class="tour-directory-file" aria-current="location" hidden></span>
|
|
158
|
+
<span id="tour-directory-narration-context" class="tour-directory-narration-context" hidden>Narration describes the overview</span>
|
|
159
|
+
</nav>
|
|
124
160
|
<div id="file-info" class="header-align-diff">Choose a compare command to render a diff.</div>
|
|
125
161
|
<div id="status-banner" class="status-banner header-align-diff" role="status" aria-live="polite" aria-atomic="true" hidden></div>
|
|
126
162
|
<div id="directory-return-toolbar" class="directory-return-toolbar header-align-diff" hidden>
|
|
@@ -279,6 +315,11 @@
|
|
|
279
315
|
</div>
|
|
280
316
|
</div>
|
|
281
317
|
<div id="directory-diff" class="dir-view hidden">
|
|
318
|
+
<div id="directory-view-tabs" class="directory-view-tabs" hidden>
|
|
319
|
+
<button id="directory-overview-tab" type="button" title="Show change overview" aria-pressed="true">Overview</button>
|
|
320
|
+
<button id="directory-files-tab" type="button" title="Show all changed files" aria-pressed="false">Files</button>
|
|
321
|
+
</div>
|
|
322
|
+
<section id="directory-overview" class="directory-overview" aria-label="Change overview" hidden></section>
|
|
282
323
|
<div class="dir-headers">
|
|
283
324
|
<div class="dir-col-header" id="dir-left-header">Left</div>
|
|
284
325
|
<div class="dir-header-gutter" aria-hidden="true"></div>
|