@davmash/bygone 0.8.5 → 0.8.7

package/out/tourCoverage.js

@@ -481,6 +481,9 @@ function parseChangeTourManifest(value) {
   }
   requireString(value.title, "title");
   requireString(value.generatedAt, "generatedAt");
+  if (value.windowTitle !== void 0) {
+    requireString(value.windowTitle, "windowTitle");
+  }
   if (value.sourceUrl !== void 0) {
     requireString(value.sourceUrl, "sourceUrl");
   }
@@ -744,8 +747,9 @@ function parseChangeTourSource(value) {
   if (!isRecord2(value) || value.version !== CHANGE_TOUR_SOURCE_VERSION) {
     throw new Error("Unsupported or missing change-tour source version.");
   }
-  requireOnlyKeys(value, ["version", "title", "sourceUrl", "range", "anchors", "connections", "chapters", "coverage"], "source");
+  requireOnlyKeys(value, ["version", "title", "windowTitle", "sourceUrl", "range", "anchors", "connections", "chapters", "coverage"], "source");
   optionalString(value.title, "title");
+  optionalString(value.windowTitle, "windowTitle");
   optionalString(value.sourceUrl, "sourceUrl");
   if (value.range !== void 0) {
     if (!isRecord2(value.range)) throw new Error("range must be an object.");
@@ -1162,7 +1166,7 @@ var CHAPTERS = {
   packaging: { id: "packaging", title: "Packaging and dependencies", priority: 4 }
 };
 function buildChangeTourManifest(startPath, options = {}) {
-  var _a, _b, _c, _d;
+  var _a, _b, _c, _d, _e;
   const range = resolveBranchReviewRange(startPath, options.headRef, options.baseRef);
   const maxFileBytes = options.maxFileBytes ?? DEFAULT_MAX_TOUR_FILE_BYTES;
   const maxLineBytes = options.maxLineBytes ?? DEFAULT_MAX_TOUR_LINE_BYTES;
@@ -1234,7 +1238,8 @@ function buildChangeTourManifest(startPath, options = {}) {
   const manifest = {
     version: CHANGE_TOUR_MANIFEST_VERSION,
     title: ((_a = options.source) == null ? void 0 : _a.title) || ((_b = options.story) == null ? void 0 : _b.title) || options.title || `${range.headRef} against ${range.baseRef}`,
-    sourceUrl: ((_c = options.source) == null ? void 0 : _c.sourceUrl) || ((_d = options.story) == null ? void 0 : _d.sourceUrl) || options.sourceUrl,
+    windowTitle: (_c = options.source) == null ? void 0 : _c.windowTitle,
+    sourceUrl: ((_d = options.source) == null ? void 0 : _d.sourceUrl) || ((_e = options.story) == null ? void 0 : _e.sourceUrl) || options.sourceUrl,
     generatedAt: options.generatedAt || (/* @__PURE__ */ new Date()).toISOString(),
     range: {
       baseRef: range.baseRef,

package/out/windowTitle.js

@@ -0,0 +1,143 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/windowTitle.ts
+var windowTitle_exports = {};
+__export(windowTitle_exports, {
+  MAX_WINDOW_TITLE_LENGTH: () => MAX_WINDOW_TITLE_LENGTH,
+  buildHistoryTitle: () => buildHistoryTitle,
+  buildHistoryTitleFromViewState: () => buildHistoryTitleFromViewState,
+  buildMultiPanelTitle: () => buildMultiPanelTitle,
+  buildStandaloneSessionTitle: () => buildStandaloneSessionTitle,
+  buildTourWindowTitle: () => buildTourWindowTitle,
+  buildTwoWayComparisonTitle: () => buildTwoWayComparisonTitle,
+  formatComparisonPair: () => formatComparisonPair,
+  truncateTitle: () => truncateTitle
+});
+module.exports = __toCommonJS(windowTitle_exports);
+var MAX_WINDOW_TITLE_LENGTH = 120;
+function truncateTitle(text, max = MAX_WINDOW_TITLE_LENGTH) {
+  if (text.length <= max) {
+    return text;
+  }
+  return `${text.slice(0, max - 1)}\u2026`;
+}
+function formatComparisonPair(left, right) {
+  return `${left} \u2194 ${right}`;
+}
+function buildMultiPanelTitle(input) {
+  const { panels, activePanelId, activePairIndex, panelIds } = input;
+  if (panels.length === 0) {
+    return "Multi-Panel Compare";
+  }
+  if (panels.length === 1) {
+    return truncateTitle(panels[0].label);
+  }
+  if (panels.length === 2) {
+    return truncateTitle(formatComparisonPair(panels[0].label, panels[1].label));
+  }
+  const ids = panelIds ?? panels.map((_panel, index) => String(index));
+  const activeIndex = activePanelId ? ids.findIndex((id) => id === activePanelId) : -1;
+  if (activePairIndex !== null && activePairIndex !== void 0 && activePairIndex >= 0 && activePairIndex < panels.length - 1) {
+    return truncateTitle(formatComparisonPair(
+      panels[activePairIndex].label,
+      panels[activePairIndex + 1].label
+    ));
+  }
+  if (activeIndex >= 0) {
+    const derivedPairIndex = activeIndex < panels.length - 1 ? activeIndex : Math.max(0, activeIndex - 1);
+    return truncateTitle(formatComparisonPair(
+      panels[derivedPairIndex].label,
+      panels[derivedPairIndex + 1].label
+    ));
+  }
+  return truncateTitle(formatComparisonPair(panels[0].label, panels[panels.length - 1].label));
+}
+function buildHistoryTitle(fileName, options) {
+  const parts = [`${fileName} History`];
+  if (options == null ? void 0 : options.shortCommit) {
+    parts.push(options.shortCommit);
+  }
+  if (options == null ? void 0 : options.positionLabel) {
+    parts.push(`(${options.positionLabel})`);
+  }
+  return truncateTitle(parts.join(" \u2014 "));
+}
+function buildHistoryTitleFromViewState(fileName, history) {
+  const shortCommit = history.rightCommitLabel.split(/\s+/)[0] || void 0;
+  return buildHistoryTitle(fileName, {
+    shortCommit,
+    positionLabel: history.positionLabel
+  });
+}
+function buildTwoWayComparisonTitle(left, right) {
+  return truncateTitle(formatComparisonPair(left, right));
+}
+function buildTourWindowTitle(manifest, appName = "Bygone") {
+  var _a, _b;
+  const label = ((_a = manifest == null ? void 0 : manifest.windowTitle) == null ? void 0 : _a.trim()) || ((_b = manifest == null ? void 0 : manifest.title) == null ? void 0 : _b.trim());
+  return label ? truncateTitle(label) : `${appName} Tour`;
+}
+function buildStandaloneSessionTitle(session) {
+  var _a, _b, _c, _d;
+  if (session.mode === "multi-diff" && session.multi) {
+    return buildMultiPanelTitle({
+      panels: session.multi.files,
+      activePanelId: session.multi.activePanelId,
+      activePairIndex: session.multi.activePairIndex,
+      panelIds: session.multi.files.map((file) => file.id)
+    });
+  }
+  if (session.mode === "history" && ((_a = session.history) == null ? void 0 : _a.filePath)) {
+    const entry = (_b = session.history.entries) == null ? void 0 : _b[session.history.index ?? 0];
+    return buildHistoryTitle(
+      session.history.filePath.split("/").pop() || "File",
+      { shortCommit: entry == null ? void 0 : entry.shortCommit }
+    );
+  }
+  if (session.mode === "directory-history" && session.dirHistory) {
+    const name = session.dirHistory.displayName || session.dirHistory.viewRelativePath || "Directory";
+    return truncateTitle(`${name} Directory History`);
+  }
+  if (session.mode === "directory" && session.directory) {
+    if ((_c = session.directory.review) == null ? void 0 : _c.headRef) {
+      return truncateTitle(`${session.directory.review.headRef} Branch Change`);
+    }
+    if ((_d = session.directory.labels) == null ? void 0 : _d.length) {
+      return truncateTitle(session.directory.labels.join(" \u2194 "));
+    }
+  }
+  if (session.left && session.right) {
+    return buildTwoWayComparisonTitle(session.left.label, session.right.label);
+  }
+  return "Compare";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MAX_WINDOW_TITLE_LENGTH,
+  buildHistoryTitle,
+  buildHistoryTitleFromViewState,
+  buildMultiPanelTitle,
+  buildStandaloneSessionTitle,
+  buildTourWindowTitle,
+  buildTwoWayComparisonTitle,
+  formatComparisonPair,
+  truncateTitle
+});
+//# sourceMappingURL=windowTitle.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@davmash/bygone",
-  "version": "0.8.5",
+  "version": "0.8.7",
   "description": "See how change happened. Visual diff and file history.",
   "author": "David Mashburn",
   "license": "MIT",

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

@@ -9,6 +9,10 @@
   "properties": {
     "version": { "const": 1 },
     "title": { "$ref": "#/$defs/nonEmptyString" },
+    "windowTitle": {
+      "$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."
+    },
     "sourceUrl": { "type": "string", "minLength": 1 },
     "range": {
       "type": "object",

package/skills/pr-tour-guide/SKILL.md

@@ -171,6 +171,10 @@ context, and keep the file within the corresponding repository so Bygone can
 resolve those objects. Use a compiled `.tour.json` only when a portable
 snapshot is required.
 
+Set optional `windowTitle` when the tour should appear in the native window
+title — for example a pull request number (`PR-1234`) so multiple open tours
+stay distinguishable. When omitted, the presenter falls back to `title`.
+
 For every step:
 
 - make one concise explanatory claim;

package/standalone/index.html

@@ -30,13 +30,13 @@
             <div id="change-toolbar" class="change-toolbar header-align-diff" hidden>
                 <div class="change-toolbar-main">
                     <div class="change-toolbar-nav">
-                        <button id="previous-file" class="change-button icon-button" type="button" title="Open previous file" aria-label="Previous file">
+                        <button id="previous-file" class="change-button icon-button" type="button" title="Open previous file" data-tooltip="Open previous file" aria-label="Previous file">
                             <svg viewBox="0 0 24 24" aria-hidden="true">
                                 <path d="M17 11l-5-5-5 5"></path>
                                 <path d="M17 18l-5-5-5 5" opacity="0.7"></path>
                             </svg>
                         </button>
-                        <button id="next-file" class="change-button change-button-primary icon-button" type="button" title="Open next file" aria-label="Next file">
+                        <button id="next-file" class="change-button change-button-primary icon-button" type="button" title="Open next file" data-tooltip="Open next file" aria-label="Next file">
                             <svg viewBox="0 0 24 24" aria-hidden="true">
                                 <path d="M7 13l5 5 5-5"></path>
                                 <path d="M7 6l5 5 5-5" opacity="0.7"></path>
@@ -72,8 +72,15 @@
                         </svg>
                     </button>
                     </div>
+                    <div class="change-toolbar-actions">
                     <button id="toggle-word-wrap" class="change-button icon-button" type="button" title="Enable line wrapping (Alt+Z)" aria-label="Enable line wrapping" aria-pressed="false" hidden>
-                        <svg viewBox="0 0 24 24" aria-hidden="true">
+                        <svg class="word-wrap-icon-off" viewBox="0 0 24 24" aria-hidden="true">
+                            <path d="M4 6h13a3 3 0 0 1 0 6H9"></path>
+                            <path d="M12 9l-3 3 3 3"></path>
+                            <path d="M4 18h8"></path>
+                            <path d="M5 4l14 16"></path>
+                        </svg>
+                        <svg class="word-wrap-icon-on" viewBox="0 0 24 24" aria-hidden="true">
                             <path d="M4 6h13a3 3 0 0 1 0 6H9"></path>
                             <path d="M12 9l-3 3 3 3"></path>
                             <path d="M4 18h8"></path>
@@ -85,6 +92,7 @@
                             <path d="M20 5v6h-6"></path>
                         </svg>
                     </button>
+                    </div>
                 </div>
                 <div class="change-hint">F7 / Shift+F7 · Cmd/Ctrl+Shift+Up/Down to jump.</div>
             </div>
@@ -94,14 +102,14 @@
                     <div id="history-left-time" class="history-time"></div>
                 </div>
                 <div class="history-nav">
-                    <button id="history-back" class="history-button icon-button" type="button" title="Open older commit (Alt+Left)" aria-label="Older commit">
+                    <button id="history-back" class="history-button icon-button" type="button" title="Open older commit (Alt+Left)" data-tooltip="Open older commit" aria-label="Older commit">
                         <svg viewBox="0 0 24 24" aria-hidden="true">
                             <path d="M15 18l-6-6 6-6"></path>
                             <path d="M10 18l-6-6 6-6" opacity="0.7"></path>
                         </svg>
                     </button>
                     <div id="history-position" class="history-position" role="status" aria-live="polite" aria-atomic="true"></div>
-                    <button id="history-forward" class="history-button icon-button" type="button" title="Open newer commit (Alt+Right)" aria-label="Newer commit">
+                    <button id="history-forward" class="history-button icon-button" type="button" title="Open newer commit (Alt+Right)" data-tooltip="Open newer commit" aria-label="Newer commit">
                         <svg viewBox="0 0 24 24" aria-hidden="true">
                             <path d="M9 18l6-6-6-6"></path>
                             <path d="M14 18l6-6-6-6" opacity="0.7"></path>

package/web/index.html

@@ -60,6 +60,34 @@
             <span id="tour-breadcrumb" class="tour-breadcrumb"></span>
             <button id="tour-next" type="button" title="Next tour item (Right or Page Down)">Next →</button>
         </nav>
+        <div id="tour-narration-controls" class="tour-narration-controls" role="group" aria-label="Tour narration">
+            <div class="tour-narration-transport" role="group" aria-label="Narration playback">
+                <button id="tour-narration-skip-back" type="button" title="Previous sentence" aria-label="Previous sentence" disabled>
+                    <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>
+                </button>
+                <button id="tour-listen" type="button" title="Listen from the current tour item" aria-label="Listen from the current tour item">
+                    <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>
+                </button>
+                <button id="tour-stop" type="button" title="Stop narration" aria-label="Stop narration" disabled>
+                    <svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path class="tour-icon-fill" d="M6 6h12v12H6z"/></svg>
+                </button>
+                <button id="tour-narration-skip-ahead" type="button" title="Next sentence" aria-label="Next sentence" disabled>
+                    <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>
+                </button>
+            </div>
+            <div class="tour-narration-settings">
+                <select id="tour-narration-voice" aria-label="Narration voice" title="Narration voice" disabled>
+                    <option value="">System default voice</option>
+                </select>
+                <select id="tour-narration-rate" aria-label="Narration speed" title="Narration speed">
+                    <option value="0.75">0.75×</option>
+                    <option value="1">1×</option>
+                    <option value="1.25">1.25×</option>
+                    <option value="1.5">1.5×</option>
+                </select>
+            </div>
+            <span id="tour-narration-status" class="tour-narration-status" role="status" aria-live="polite" aria-atomic="true">Device voice ready</span>
+        </div>
         <div class="tour-narrative-layout">
             <div class="tour-narrative-prose">
                 <div id="tour-narrative-chapter" class="tour-narrative-chapter"></div>
@@ -113,13 +141,13 @@
             <div id="change-toolbar" class="change-toolbar header-align-diff" hidden>
                 <div class="change-toolbar-main">
                     <div class="change-toolbar-nav">
-                        <button id="previous-file" class="change-button icon-button" type="button" title="Open previous file" aria-label="Previous file">
+                        <button id="previous-file" class="change-button icon-button" type="button" title="Open previous file" data-tooltip="Open previous file" aria-label="Previous file">
                             <svg viewBox="0 0 24 24" aria-hidden="true">
                                 <path d="M17 11l-5-5-5 5"></path>
                                 <path d="M17 18l-5-5-5 5"></path>
                             </svg>
                         </button>
-                        <button id="next-file" class="change-button icon-button" type="button" title="Open next file" aria-label="Next file">
+                        <button id="next-file" class="change-button icon-button" type="button" title="Open next file" data-tooltip="Open next file" aria-label="Next file">
                             <svg viewBox="0 0 24 24" aria-hidden="true">
                                 <path d="M7 13l5 5 5-5"></path>
                                 <path d="M7 6l5 5 5-5"></path>
@@ -155,8 +183,15 @@
                             </svg>
                         </button>
                     </div>
+                    <div class="change-toolbar-actions">
                     <button id="toggle-word-wrap" class="change-button icon-button" type="button" title="Enable line wrapping (Alt+Z)" aria-label="Enable line wrapping" aria-pressed="false" hidden>
-                        <svg viewBox="0 0 24 24" aria-hidden="true">
+                        <svg class="word-wrap-icon-off" viewBox="0 0 24 24" aria-hidden="true">
+                            <path d="M4 6h13a3 3 0 0 1 0 6H9"></path>
+                            <path d="M12 9l-3 3 3 3"></path>
+                            <path d="M4 18h8"></path>
+                            <path d="M5 4l14 16"></path>
+                        </svg>
+                        <svg class="word-wrap-icon-on" viewBox="0 0 24 24" aria-hidden="true">
                             <path d="M4 6h13a3 3 0 0 1 0 6H9"></path>
                             <path d="M12 9l-3 3 3 3"></path>
                             <path d="M4 18h8"></path>
@@ -168,6 +203,7 @@
                             <path d="M20 5v6h-6"></path>
                         </svg>
                     </button>
+                    </div>
                 </div>
                 <div class="change-hint">F7 / Shift+F7 · Cmd/Ctrl+Shift+Up/Down to jump.</div>
             </div>
@@ -177,14 +213,14 @@
                     <div id="history-left-time" class="history-time"></div>
                 </div>
                 <div class="history-nav">
-                    <button id="history-back" class="history-button icon-button" type="button" title="Open older commit" aria-label="Older commit">
+                    <button id="history-back" class="history-button icon-button" type="button" title="Open older commit" data-tooltip="Open older commit" aria-label="Older commit">
                         <svg viewBox="0 0 24 24" aria-hidden="true">
                             <path d="M15 18l-6-6 6-6"></path>
                             <path d="M10 18l-6-6 6-6" opacity="0.7"></path>
                         </svg>
                     </button>
                     <div id="history-position" class="history-position" role="status" aria-live="polite" aria-atomic="true"></div>
-                    <button id="history-forward" class="history-button icon-button" type="button" title="Open newer commit" aria-label="Newer commit">
+                    <button id="history-forward" class="history-button icon-button" type="button" title="Open newer commit" data-tooltip="Open newer commit" aria-label="Newer commit">
                         <svg viewBox="0 0 24 24" aria-hidden="true">
                             <path d="M9 18l6-6-6-6"></path>
                             <path d="M14 18l6-6-6-6" opacity="0.7"></path>

package/web/presenter.css

@@ -319,6 +319,121 @@ body.tour-discussion .tour-narrative-resizer {
     cursor: default;
 }
 
+.tour-narration-controls {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 6px;
+    align-items: center;
+    margin: -4px 0 12px;
+    padding: 5px;
+    border: 1px solid var(--tour-border);
+    border-radius: 8px;
+    background: rgba(255, 255, 255, 0.025);
+}
+
+.tour-narration-controls select {
+    height: 28px;
+    padding: 3px 7px;
+    color: var(--tour-muted);
+    border: 1px solid var(--tour-border);
+    border-radius: 5px;
+    background: rgba(255, 255, 255, 0.035);
+    font: inherit;
+}
+
+.tour-narration-transport,
+.tour-narration-settings {
+    display: inline-flex;
+    align-items: center;
+}
+
+.tour-narration-transport {
+    overflow: hidden;
+    border: 1px solid var(--tour-border);
+    border-radius: 6px;
+}
+
+.tour-narration-transport button {
+    display: grid;
+    width: 30px;
+    height: 28px;
+    padding: 0;
+    place-items: center;
+    color: var(--tour-muted);
+    border: 0;
+    border-right: 1px solid var(--tour-border);
+    background: rgba(255, 255, 255, 0.035);
+    cursor: pointer;
+}
+
+.tour-narration-transport button:last-child {
+    border-right: 0;
+}
+
+.tour-narration-transport button svg {
+    width: 16px;
+    height: 16px;
+    fill: none;
+    stroke: currentColor;
+    stroke-width: 1.8;
+    stroke-linecap: round;
+    stroke-linejoin: round;
+}
+
+.tour-narration-transport button svg .tour-icon-fill {
+    fill: currentColor;
+    stroke: none;
+}
+
+.tour-narration-transport #tour-listen {
+    color: var(--tour-accent-bright);
+}
+
+.tour-narration-transport button:hover:not(:disabled),
+.tour-narration-transport button:focus-visible,
+.tour-narration-controls select:focus-visible {
+    color: #fff;
+    outline: none;
+    background: rgba(169, 159, 255, 0.13);
+    box-shadow: inset 0 0 0 1px rgba(169, 159, 255, 0.55);
+}
+
+.tour-narration-transport button:disabled,
+.tour-narration-controls select:disabled {
+    opacity: 0.36;
+}
+
+.tour-narration-settings {
+    gap: 5px;
+}
+
+.tour-narration-controls select {
+    max-width: min(210px, 29vw);
+}
+
+.tour-narration-status {
+    margin-left: auto;
+    color: var(--tour-faint);
+    text-align: right;
+}
+
+.tour-narration-segment {
+    border-radius: 3px;
+    box-decoration-break: clone;
+    -webkit-box-decoration-break: clone;
+    transition: background-color 100ms ease, box-shadow 100ms ease;
+}
+
+.tour-narration-segment.is-speaking {
+    background: rgba(255, 211, 92, 0.18);
+    box-shadow: inset 0 -2px 0 rgba(255, 211, 92, 0.78);
+}
+
+.tour-narration-segment.is-speaking.is-paused {
+    background: rgba(169, 159, 255, 0.16);
+    box-shadow: inset 0 -2px 0 rgba(169, 159, 255, 0.72);
+}
+
 .tour-breadcrumb {
     min-width: 0;
     color: var(--tour-muted);
@@ -674,6 +789,11 @@ body.tour-discussion .tour-narrative-nav {
     margin-bottom: clamp(22px, 4vh, 36px);
 }
 
+body.tour-discussion .tour-narration-controls {
+    max-width: 1000px;
+    margin-bottom: clamp(18px, 3vh, 28px);
+}
+
 body.tour-discussion .tour-narrative-layout {
     display: block;
 }
@@ -811,4 +931,20 @@ body.tour-discussion .tour-narrative-takeaway {
         min-width: 64px;
         padding-inline: 7px;
     }
+
+    .tour-narration-controls select {
+        max-width: 150px;
+    }
+
+    .tour-narration-status {
+        width: 100%;
+        margin-left: 0;
+        text-align: left;
+    }
+}
+
+@media (prefers-reduced-motion: reduce) {
+    .tour-narration-segment {
+        transition: none;
+    }
 }