@yadsh/dsh-qa-surface 0.2.0 → 0.4.0

package/lib/client/components/QaSourcesPanel.js

@@ -0,0 +1,127 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useMemo, useRef, useState } from "react";
+import { Markdown } from "./Markdown.js";
+const KIND_LABELS = {
+    file: "Документы",
+    code: "Код",
+    web: "Web",
+    jira: "Jira",
+    confluence: "Confluence",
+    knowledge: "База знаний",
+    other: "Другие",
+};
+function sourceTarget(source) {
+    return source.path ?? source.uri ?? source.title;
+}
+export function SourceIcon({ kind }) {
+    if (kind === "web") {
+        return (_jsxs("svg", { viewBox: "0 0 16 16", "aria-hidden": "true", children: [_jsx("circle", { cx: "8", cy: "8", r: "5.75" }), _jsx("path", { d: "M2.25 8h11.5M8 2.25c1.6 1.55 2.4 3.5 2.4 5.75S9.6 12.2 8 13.75C6.4 12.2 5.6 10.25 5.6 8S6.4 3.8 8 2.25Z" })] }));
+    }
+    if (kind === "jira" || kind === "confluence" || kind === "knowledge") {
+        return (_jsxs("svg", { viewBox: "0 0 16 16", "aria-hidden": "true", children: [_jsx("circle", { cx: "7.1", cy: "7.1", r: "4.3" }), _jsx("path", { d: "m10.3 10.3 2.9 2.9" })] }));
+    }
+    return (_jsxs("svg", { viewBox: "0 0 16 16", "aria-hidden": "true", children: [_jsx("path", { d: "M9.25 2.5H4.75A1.25 1.25 0 0 0 3.5 3.75v8.5a1.25 1.25 0 0 0 1.25 1.25h6.5a1.25 1.25 0 0 0 1.25-1.25V5.75L9.25 2.5Z" }), _jsx("path", { d: "M9.25 2.5v3.25h3.25" })] }));
+}
+function OriginBadges({ source, showOrigin, }) {
+    const delegated = showOrigin && source.origins.some((origin) => origin.role === "subagent");
+    const truncated = source.metadata?.truncated === true;
+    if (!delegated && !truncated && source.evidence !== "discovered")
+        return null;
+    return (_jsxs("span", { className: "dsh-qa-sources__badges", children: [delegated ? _jsx("span", { children: "Subagent" }) : null, truncated ? _jsx("span", { children: "Partial" }) : null, source.evidence === "discovered" ? _jsx("span", { children: "Discovered" }) : null] }));
+}
+function QaSourceCard({ source, showOriginBadges, onOpen, }) {
+    return (_jsxs("button", { type: "button", className: "dsh-qa-sources__item", onClick: onOpen, children: [_jsx("span", { className: "dsh-qa-sources__kind", "data-kind": source.kind, children: _jsx(SourceIcon, { kind: source.kind }) }), _jsxs("span", { className: "dsh-qa-sources__text", children: [_jsx("span", { className: "dsh-qa-sources__title", children: source.title }), _jsx("span", { className: "dsh-qa-sources__target", children: sourceTarget(source) }), _jsx(OriginBadges, { source: source, showOrigin: showOriginBadges }), source.snippet === undefined ? null : _jsx("p", { children: source.snippet })] })] }));
+}
+function RawFilePreview({ preview, lineStart, lineEnd, }) {
+    const target = useRef(null);
+    useEffect(() => {
+        if (typeof target.current?.scrollIntoView === "function") {
+            target.current.scrollIntoView({ block: "center" });
+        }
+    }, [preview.path, lineStart]);
+    const lines = preview.content.replace(/\r\n?/gu, "\n").split("\n");
+    return (_jsx("pre", { className: "dsh-qa-preview__raw", children: _jsx("code", { children: lines.map((line, index) => {
+                const number = index + 1;
+                const highlighted = lineStart !== undefined &&
+                    number >= lineStart &&
+                    number <= (lineEnd ?? lineStart);
+                return (_jsxs("span", { ref: number === lineStart ? target : undefined, className: highlighted
+                        ? "dsh-qa-preview__line dsh-qa-preview__line--highlight"
+                        : "dsh-qa-preview__line", children: [_jsx("span", { className: "dsh-qa-preview__number", children: number }), _jsx("span", { children: line || " " })] }, number));
+            }) }) }));
+}
+function QaSourceDetail({ source, sessionId, sourceApi, filePreviewConfig, showOriginBadges, onBack, }) {
+    const [preview, setPreview] = useState(null);
+    const [previewError, setPreviewError] = useState(false);
+    const [mode, setMode] = useState("raw");
+    const external = source.uri?.match(/^https?:\/\//iu)?.[0] === undefined
+        ? undefined
+        : source.uri;
+    const firstRange = source.locations.find((location) => location.lineStart !== undefined || location.lineEnd !== undefined);
+    const lineStart = firstRange?.lineStart ?? firstRange?.lineEnd;
+    const lineEnd = firstRange?.lineEnd ?? firstRange?.lineStart;
+    useEffect(() => {
+        let alive = true;
+        setPreview(null);
+        setPreviewError(false);
+        if (source.path === undefined ||
+            sessionId === null ||
+            !filePreviewConfig.enabled)
+            return;
+        sourceApi.readSourceFile(sessionId, source.path).then((result) => {
+            if (!alive)
+                return;
+            if (!result.ok) {
+                setPreviewError(true);
+                return;
+            }
+            setPreview(result.value);
+            setMode(result.value.markdown &&
+                result.value.renderableMarkdown &&
+                filePreviewConfig.markdownRenderedByDefault
+                ? "rendered"
+                : "raw");
+        }, () => alive && setPreviewError(true));
+        return () => {
+            alive = false;
+        };
+    }, [
+        filePreviewConfig.enabled,
+        filePreviewConfig.markdownRenderedByDefault,
+        sessionId,
+        source.id,
+        source.path,
+        sourceApi,
+    ]);
+    return (_jsxs("div", { className: "dsh-qa-sourcedetail", children: [_jsxs("div", { className: "dsh-qa-sourcedetail__head", children: [_jsx("button", { type: "button", className: "dsh-qa-sourcedetail__back", "aria-label": "\u041A\u043E \u0432\u0441\u0435\u043C \u0438\u0441\u0442\u043E\u0447\u043D\u0438\u043A\u0430\u043C", title: "\u041A\u043E \u0432\u0441\u0435\u043C \u0438\u0441\u0442\u043E\u0447\u043D\u0438\u043A\u0430\u043C", onClick: onBack, children: _jsx("svg", { viewBox: "0 0 14 14", "aria-hidden": "true", children: _jsx("path", { d: "m8.75 3.5-3.5 3.5 3.5 3.5" }) }) }), _jsx("span", { className: "dsh-qa-sourcedetail__kind", children: _jsx(SourceIcon, { kind: source.kind }) }), _jsx("span", { className: "dsh-qa-sourcedetail__title", children: source.title }), preview?.markdown && filePreviewConfig.allowRawToggle ? (_jsxs("span", { className: "dsh-qa-preview__toggle", children: [_jsx("button", { type: "button", "aria-pressed": mode === "rendered", disabled: !preview.renderableMarkdown, onClick: () => setMode("rendered"), children: "Rendered" }), _jsx("button", { type: "button", "aria-pressed": mode === "raw", onClick: () => setMode("raw"), children: "Raw" })] })) : external === undefined ? null : (_jsx("a", { className: "dsh-qa-sourcedetail__open", href: external, target: "_blank", rel: "noopener noreferrer", children: "\u041E\u0442\u043A\u0440\u044B\u0442\u044C" }))] }), _jsx("div", { className: "dsh-qa-sourcedetail__target", children: sourceTarget(source) }), _jsxs("div", { className: "dsh-qa-sourcedetail__body", children: [_jsx(OriginBadges, { source: source, showOrigin: showOriginBadges }), source.path !== undefined && preview === null && !previewError ? (_jsx("p", { className: "dsh-qa-sourcedetail__empty", children: "\u041E\u0442\u043A\u0440\u044B\u0432\u0430\u044E \u0438\u0441\u0442\u043E\u0447\u043D\u0438\u043A\u2026" })) : null, previewError ? (_jsx("p", { className: "dsh-qa-sourcedetail__empty", children: "\u041D\u0435 \u0443\u0434\u0430\u043B\u043E\u0441\u044C \u043E\u0442\u043A\u0440\u044B\u0442\u044C \u0438\u0441\u0442\u043E\u0447\u043D\u0438\u043A. \u0412\u043E\u0437\u043C\u043E\u0436\u043D\u043E, \u0444\u0430\u0439\u043B \u0431\u044B\u043B \u043F\u0435\u0440\u0435\u043C\u0435\u0449\u0451\u043D \u0438\u043B\u0438 \u0431\u043E\u043B\u044C\u0448\u0435 \u043D\u0435\u0434\u043E\u0441\u0442\u0443\u043F\u0435\u043D." })) : null, preview !== null ? (_jsxs(_Fragment, { children: [preview.truncated ? (_jsx("p", { className: "dsh-qa-preview__notice", children: "\u041F\u043E\u043A\u0430\u0437\u0430\u043D\u043E \u043D\u0430\u0447\u0430\u043B\u043E \u0444\u0430\u0439\u043B\u0430: \u0440\u0430\u0437\u043C\u0435\u0440 \u043F\u0440\u0435\u0432\u044B\u0448\u0430\u0435\u0442 \u043B\u0438\u043C\u0438\u0442 preview." })) : null, lineStart === undefined ? null : (_jsxs("p", { className: "dsh-qa-preview__range", children: ["Referenced lines: ", lineStart, lineEnd !== undefined && lineEnd !== lineStart
+                                        ? `–${lineEnd}`
+                                        : "", mode === "rendered" ? (_jsx("button", { type: "button", onClick: () => setMode("raw"), children: "View raw" })) : null] })), mode === "rendered" && preview.renderableMarkdown ? (_jsx("div", { className: "dsh-qa-preview__markdown", children: _jsx(Markdown, { text: preview.content }) })) : (_jsx(RawFilePreview, { preview: preview, lineStart: lineStart, lineEnd: lineEnd }))] })) : source.path === undefined ? (source.snippet === undefined ? (_jsx("p", { className: "dsh-qa-sourcedetail__empty", children: "\u0423 \u0438\u0441\u0442\u043E\u0447\u043D\u0438\u043A\u0430 \u043D\u0435\u0442 \u0442\u0435\u043A\u0441\u0442\u043E\u0432\u043E\u0433\u043E \u0444\u0440\u0430\u0433\u043C\u0435\u043D\u0442\u0430." })) : (_jsx("p", { children: source.snippet }))) : null, _jsxs("p", { className: "dsh-qa-sourcedetail__provenance", children: [_jsxs("span", { children: ["\u0418\u0441\u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u043D ", source.origins.length, " \u0440\u0430\u0437(\u0430)"] }), _jsx("span", { children: source.evidence })] })] })] }));
+}
+/** Canonical grouped source panel and safe local-file preview. */
+export function QaSourcesPanel({ sources, complete, incompleteOrigins, sessionId, sourceApi, display, filePreview, initialDetail = null, pinned = false, onShowAll, }) {
+    const [detailId, setDetailId] = useState(initialDetail?.id ?? null);
+    const [expanded, setExpanded] = useState(() => new Set());
+    const detail = detailId === null
+        ? undefined
+        : (sources.find((source) => source.id === detailId) ??
+            (initialDetail?.id === detailId ? initialDetail : undefined));
+    const groups = useMemo(() => {
+        if (!display.groupByKind)
+            return [{ key: "all", label: "Источники", sources }];
+        const grouped = new Map();
+        for (const source of sources)
+            grouped.set(source.kind, [...(grouped.get(source.kind) ?? []), source]);
+        return [...grouped].map(([key, items]) => ({
+            key,
+            label: KIND_LABELS[key],
+            sources: items,
+        }));
+    }, [display.groupByKind, sources]);
+    return (_jsxs("div", { className: "dsh-qa-sourcespanel", children: [detail === undefined && pinned && onShowAll !== undefined ? (_jsx("button", { type: "button", className: "dsh-qa-sourcespanel__all", onClick: onShowAll, children: "\u0412\u0441\u0435 \u0438\u0441\u0442\u043E\u0447\u043D\u0438\u043A\u0438" })) : null, detail === undefined ? (_jsxs("div", { className: "dsh-qa-sources__list", children: [!complete ? (_jsxs("p", { className: "dsh-qa-sources__incomplete", children: ["\u041D\u0435\u043A\u043E\u0442\u043E\u0440\u044B\u0435 \u0438\u0441\u0442\u043E\u0447\u043D\u0438\u043A\u0438 \u0434\u0435\u043B\u0435\u0433\u0438\u0440\u043E\u0432\u0430\u043D\u043D\u044B\u0445 \u0437\u0430\u043F\u0443\u0441\u043A\u043E\u0432 \u043D\u0435\u0434\u043E\u0441\u0442\u0443\u043F\u043D\u044B (", incompleteOrigins?.length ?? 1, ")."] })) : null, groups.map((group) => {
+                        const visible = expanded.has(group.key)
+                            ? group.sources
+                            : group.sources.slice(0, display.maxInitiallyVisiblePerGroup);
+                        return (_jsxs("section", { className: "dsh-qa-sources__group", children: [_jsxs("h3", { children: [group.label, _jsx("span", { children: group.sources.length })] }), visible.map((source) => (_jsx(QaSourceCard, { source: source, showOriginBadges: display.showOriginBadges, onOpen: () => setDetailId(source.id) }, source.id))), visible.length < group.sources.length ? (_jsxs("button", { type: "button", className: "dsh-qa-sources__more", onClick: () => setExpanded(new Set([...expanded, group.key])), children: ["\u041F\u043E\u043A\u0430\u0437\u0430\u0442\u044C \u0435\u0449\u0451 ", group.sources.length - visible.length] })) : null] }, group.key));
+                    })] })) : (_jsx(QaSourceDetail, { source: detail, sessionId: sessionId, sourceApi: sourceApi, filePreviewConfig: filePreview, showOriginBadges: display.showOriginBadges, onBack: () => setDetailId(null) }))] }));
+}
+//# sourceMappingURL=QaSourcesPanel.js.map

package/lib/client/components/QaSourcesPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QaSourcesPanel.js","sourceRoot":"","sources":["../../../src/client/components/QaSourcesPanel.tsx"],"names":[],"mappings":"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"}

package/lib/client/components/QaTurnRail.js

@@ -0,0 +1,296 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { memo, useCallback, useEffect, useId, useRef, useState, } from "react";
+/** Transcript attribute marking the message slot that opens a turn. */
+export const QA_TURN_ANCHOR_ATTRIBUTE = "data-dsh-qa-turn-anchor";
+/** Scroll distance from the floor at which the rail still calls it "at bottom". */
+export const QA_TURN_FOLLOW_PX = 96;
+/** The reading line: reading offset from the scrollport top while scrolling. */
+export const QA_TURN_READING_PX = 96;
+/** Where a jump lands its prompt row, mirroring the harness chat rail. */
+const QA_TURN_LAND_PX = 24;
+const PROMPT_CLIP = 140;
+const RESPONSE_CLIP = 220;
+function clipPreview(text, max) {
+    const flat = text.replace(/\s+/gu, " ").trim();
+    if (flat.length <= max)
+        return flat;
+    return `${flat.slice(0, max - 1).trimEnd()}…`;
+}
+/**
+ * Rail ladder of the visible transcript: every user prompt opens a turn, the
+ * first non-empty answer after it fills the response preview. Hidden variant
+ * answers never reach this list because callers pass the already-filtered
+ * messages.
+ */
+export function buildTurnRailItems(messages) {
+    const items = [];
+    for (const message of messages) {
+        if (message.role === "user") {
+            items.push({
+                turn: items.length + 1,
+                id: message.id,
+                prompt: clipPreview(message.text, PROMPT_CLIP),
+                response: "",
+            });
+            continue;
+        }
+        if (message.role !== "assistant" || items.length === 0)
+            continue;
+        const current = items.at(-1);
+        if (current === undefined || current.response !== "")
+            continue;
+        const response = clipPreview(message.text, RESPONSE_CLIP);
+        if (response !== "")
+            items[items.length - 1] = { ...current, response };
+    }
+    return items;
+}
+/** Deep equality guard so the memoized rail skips streaming commits. */
+export function sameTurnRailItems(left, right) {
+    if (left === right)
+        return true;
+    if (left.length !== right.length)
+        return false;
+    return left.every((item, index) => {
+        const other = right[index];
+        return (other !== undefined &&
+            item.turn === other.turn &&
+            item.id === other.id &&
+            item.prompt === other.prompt &&
+            item.response === other.response);
+    });
+}
+/**
+ * Turn owning the transcript's reading line, or the newest one while the
+ * reader follows the live tail. Anchors above the line are scanned in flow
+ * order; the last one at or above it owns the mark.
+ */
+export function computeActiveTurn(scroller, items) {
+    if (items.length === 0)
+        return null;
+    const last = items.at(-1);
+    if (last === undefined)
+        return null;
+    if (scroller.scrollHeight - scroller.scrollTop - scroller.clientHeight <=
+        QA_TURN_FOLLOW_PX + 1) {
+        return last.turn;
+    }
+    const line = scroller.getBoundingClientRect().top +
+        Math.min(QA_TURN_READING_PX, scroller.clientHeight * 0.2);
+    const turnByAnchor = new Map(items.map((item) => [item.id, item.turn]));
+    const first = items[0];
+    if (first === undefined)
+        return null;
+    let next = first.turn;
+    for (const row of scroller.querySelectorAll(`[${QA_TURN_ANCHOR_ATTRIBUTE}]`)) {
+        if (row.getBoundingClientRect().top > line)
+            break;
+        const turn = turnByAnchor.get(row.getAttribute(QA_TURN_ANCHOR_ATTRIBUTE) ?? "");
+        if (turn !== undefined)
+            next = turn;
+    }
+    return next;
+}
+/** Fixed pitch between neighbouring marks; overflow scrolls inside the frame. */
+const TURN_SPACING_PX = 10;
+/** Rail padding above the first mark and below the last one, per end. */
+const RAIL_INSET_PX = 6;
+/** Fade band the mask reserves at a scrollable end. */
+const FADE_PX = 24;
+const RAIL_AT_REST = {
+    top: 0,
+    canScrollUp: false,
+    canScrollDown: false,
+};
+function railScrollState(scroller) {
+    const top = scroller.scrollTop;
+    return {
+        top,
+        canScrollUp: top > 1,
+        canScrollDown: top < scroller.scrollHeight - scroller.clientHeight - 1,
+    };
+}
+function sameRailScrollState(left, right) {
+    return (left.top === right.top &&
+        left.canScrollUp === right.canScrollUp &&
+        left.canScrollDown === right.canScrollDown);
+}
+function itemAtPointer(items, frame, scrollTop, clientY) {
+    const rect = frame.getBoundingClientRect();
+    const offset = clientY - rect.top + scrollTop - RAIL_INSET_PX;
+    const index = Math.max(0, Math.min(items.length - 1, Math.round(offset / TURN_SPACING_PX)));
+    return items[index];
+}
+function QaTurnRailView({ items, activeTurn, busyTurn, scrollerRef, onNavigate, }) {
+    const slotRef = useRef(null);
+    const ladderRef = useRef(null);
+    /** While the pointer works the rail, follow must not move it under the hand. */
+    const pointerInsideRef = useRef(false);
+    const [previewTurn, setPreviewTurn] = useState(null);
+    const [scrollState, setScrollState] = useState(RAIL_AT_REST);
+    const previewId = useId();
+    // The band the marks centre in is the transcript scrollport's own height;
+    // publish it as a custom property so the frame can centre without knowing
+    // the header/composer layout around it.
+    useEffect(() => {
+        const slot = slotRef.current;
+        const scroller = scrollerRef.current;
+        if (slot === null || scroller === null)
+            return;
+        const apply = () => {
+            slot.style.setProperty("--dsh-qa-rail-band", `${scroller.clientHeight}px`);
+        };
+        apply();
+        if (typeof ResizeObserver === "undefined")
+            return;
+        const observer = new ResizeObserver(apply);
+        observer.observe(scroller);
+        return () => {
+            observer.disconnect();
+        };
+    }, [scrollerRef]);
+    const syncScrollState = useCallback(() => {
+        const ladder = ladderRef.current;
+        if (ladder === null)
+            return;
+        const next = railScrollState(ladder);
+        setScrollState((current) => sameRailScrollState(current, next) ? current : next);
+    }, []);
+    // Frame resizes (band changes) move the overflow edges without a scroll
+    // event; item count changes move the content height the same way.
+    useEffect(() => {
+        const ladder = ladderRef.current;
+        if (ladder === null || typeof ResizeObserver === "undefined")
+            return;
+        const observer = new ResizeObserver(syncScrollState);
+        observer.observe(ladder);
+        return () => {
+            observer.disconnect();
+        };
+    }, [syncScrollState]);
+    useEffect(() => {
+        syncScrollState();
+    }, [items.length, syncScrollState]);
+    // Keep the active mark visible: centre it whenever it leaves the scrollport,
+    // unless the reader's pointer is working the rail.
+    useEffect(() => {
+        const ladder = ladderRef.current;
+        const index = items.findIndex((item) => item.turn === activeTurn);
+        if (ladder === null || index < 0 || pointerInsideRef.current)
+            return;
+        const markTop = index * TURN_SPACING_PX + RAIL_INSET_PX;
+        const viewTop = ladder.scrollTop;
+        const viewHeight = ladder.clientHeight;
+        if (viewHeight <= 0 ||
+            (markTop >= viewTop + FADE_PX &&
+                markTop <= viewTop + viewHeight - FADE_PX)) {
+            return;
+        }
+        const target = Math.max(0, markTop - viewHeight / 2);
+        const reduced = typeof matchMedia === "function" &&
+            matchMedia("(prefers-reduced-motion: reduce)").matches;
+        if (typeof ladder.scrollTo === "function") {
+            ladder.scrollTo({ top: target, behavior: reduced ? "auto" : "smooth" });
+        }
+        else {
+            ladder.scrollTop = target;
+        }
+        syncScrollState();
+    }, [activeTurn, items, syncScrollState]);
+    if (items.length < 2)
+        return null;
+    const previewIndex = items.findIndex((item) => item.turn === previewTurn);
+    const preview = previewIndex < 0 ? undefined : items[previewIndex];
+    const previewPosition = previewIndex < 0 ? undefined : previewIndex * TURN_SPACING_PX;
+    const previewAtPointer = (event) => {
+        const scrollTop = ladderRef.current?.scrollTop ?? 0;
+        setPreviewTurn(itemAtPointer(items, event.currentTarget, scrollTop, event.clientY)
+            ?.turn ?? null);
+    };
+    const navigateAtPointer = (event) => {
+        const scrollTop = ladderRef.current?.scrollTop ?? 0;
+        const item = itemAtPointer(items, event.currentTarget, scrollTop, event.clientY);
+        if (item !== undefined)
+            onNavigate(item);
+    };
+    const ladderClasses = ["dsh-qa-rail__scroll"];
+    if (scrollState.canScrollUp)
+        ladderClasses.push("dsh-qa-rail__scroll--fade-top");
+    if (scrollState.canScrollDown) {
+        ladderClasses.push("dsh-qa-rail__scroll--fade-bottom");
+    }
+    return (_jsx("div", { ref: slotRef, className: "dsh-qa-rail", children: _jsxs("nav", { className: "dsh-qa-rail__frame", style: {
+                "--dsh-qa-rail-natural": `${(items.length - 1) * TURN_SPACING_PX + 2 * RAIL_INSET_PX}px`,
+                "--dsh-qa-rail-scroll-top": `${scrollState.top}px`,
+            }, "aria-label": "\u041F\u0435\u0440\u0435\u0445\u043E\u0434 \u043F\u043E \u0432\u043E\u043F\u0440\u043E\u0441\u0430\u043C", onClick: navigateAtPointer, onPointerMove: previewAtPointer, onPointerEnter: () => {
+                pointerInsideRef.current = true;
+            }, onPointerLeave: () => {
+                pointerInsideRef.current = false;
+                setPreviewTurn(null);
+            }, children: [_jsx("div", { ref: ladderRef, className: ladderClasses.join(" "), onScroll: () => {
+                        syncScrollState();
+                    }, children: _jsx("div", { className: "dsh-qa-rail__marks", children: items.map((item, index) => {
+                            const active = item.turn === activeTurn;
+                            const showingPreview = item.turn === previewTurn;
+                            const classes = ["dsh-qa-rail__mark"];
+                            if (active)
+                                classes.push("dsh-qa-rail__mark--active");
+                            else if (showingPreview) {
+                                classes.push("dsh-qa-rail__mark--preview");
+                            }
+                            if (item.turn === busyTurn)
+                                classes.push("dsh-qa-rail__mark--busy");
+                            return (_jsx("div", { className: "dsh-qa-rail__pos", style: {
+                                    "--dsh-qa-rail-pos": `${index * TURN_SPACING_PX}px`,
+                                }, children: _jsx("button", { type: "button", className: classes.join(" "), "aria-label": `К вопросу ${item.turn}`, "aria-current": active ? "true" : undefined, "aria-busy": item.turn === busyTurn ? "true" : undefined, "aria-describedby": showingPreview ? previewId : undefined, onClick: (event) => {
+                                        event.stopPropagation();
+                                        onNavigate(item);
+                                    }, onFocus: () => {
+                                        setPreviewTurn(item.turn);
+                                    }, onBlur: () => {
+                                        setPreviewTurn(null);
+                                    } }) }, item.turn));
+                        }) }) }), preview !== undefined && previewPosition !== undefined ? (_jsxs("div", { id: previewId, role: "tooltip", className: "dsh-qa-rail__preview", style: {
+                        "--dsh-qa-rail-pos": `${previewPosition}px`,
+                    }, children: [_jsx("div", { className: "dsh-qa-rail__preview-prompt", children: preview.prompt }), preview.response === "" ? null : (_jsx("div", { className: "dsh-qa-rail__preview-response", children: preview.response }))] })) : null] }) }));
+}
+function sameRailProps(previous, next) {
+    return (previous.activeTurn === next.activeTurn &&
+        previous.busyTurn === next.busyTurn &&
+        previous.scrollerRef === next.scrollerRef &&
+        previous.onNavigate === next.onNavigate &&
+        sameTurnRailItems(previous.items, next.items));
+}
+/**
+ * Fixed-pitch rail of every turn of the visible transcript, floating over the
+ * transcript's right gutter: the active mark follows the reading line, a
+ * hover/focus preview shows the prompt and answer, and a click lands the
+ * transcript on that turn. Memoized like the harness rail — the transcript
+ * re-renders on every streaming delta, and the rail only changes when a turn
+ * is added or becomes active.
+ */
+export const QaTurnRail = memo(QaTurnRailView, sameRailProps);
+/** Land the transcript on a turn's prompt row, harness-style. */
+export function turnScrollTarget(scroller, row) {
+    const top = scroller.scrollTop +
+        row.getBoundingClientRect().top -
+        scroller.getBoundingClientRect().top;
+    const max = Math.max(0, scroller.scrollHeight - scroller.clientHeight);
+    return Math.min(max, Math.max(0, top - QA_TURN_LAND_PX));
+}
+/**
+ * Find the message slot carrying `anchorId` and land the transcript on it,
+ * harness-style. Returns whether the anchor row exists; callers tie their
+ * near-bottom bookkeeping and rail-mark updates to that outcome.
+ */
+export function scrollToTranscriptAnchor(scroller, anchorId) {
+    const escaped = typeof CSS !== "undefined" && typeof CSS.escape === "function"
+        ? CSS.escape(anchorId)
+        : anchorId;
+    const row = scroller.querySelector(`[${QA_TURN_ANCHOR_ATTRIBUTE}="${escaped}"]`);
+    if (row === null)
+        return false;
+    scroller.scrollTop = turnScrollTarget(scroller, row);
+    return true;
+}
+//# sourceMappingURL=QaTurnRail.js.map

package/lib/client/components/QaTurnRail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QaTurnRail.js","sourceRoot":"","sources":["../../../src/client/components/QaTurnRail.tsx"],"names":[],"mappings":"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"}

package/lib/client/components/QaWelcomeNotice.js

@@ -0,0 +1,125 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useRef, useState, } from "react";
+import { createPortal } from "react-dom";
+/** Bump when the notice changes materially and must be acknowledged again. */
+export const QA_WELCOME_NOTICE_VERSION = "2026-09-12.1";
+export const QA_WELCOME_NOTICE_COPY = Object.freeze({
+    title: "Перед началом тестирования",
+    paragraphs: Object.freeze([
+        "Этот помощник разработан не с нуля: он основан на DeepSeek Harness. Платформа находится в preview, поэтому возможны ошибки, нестабильная работа и изменения поведения.",
+        "На этапе тестирования заданные вопросы и полученные ответы будут анализироваться для повышения качества помощника. Пожалуйста, задавайте преимущественно вопросы, связанные с работой.",
+        "Помощник использует локальные модели. Данные обрабатываются внутри контура и никуда за его пределы не передаются.",
+    ]),
+    continueLabel: "Понятно, продолжить",
+});
+const QA_WELCOME_ACKNOWLEDGED_EVENT = "dsh-qa-welcome-acknowledged";
+function acknowledged(storage, key) {
+    try {
+        return storage.getItem(key) === QA_WELCOME_NOTICE_VERSION;
+    }
+    catch {
+        return false;
+    }
+}
+function focusable(root) {
+    return [
+        ...root.querySelectorAll("button:not([disabled]), a[href], input:not([disabled]), [tabindex]:not([tabindex='-1'])"),
+    ].filter((element) => !element.hidden);
+}
+/** Route-scoped replacement for DSH's stock `welcome-notice` onboarding step. */
+export function QaWelcomeNotice(props) {
+    const [isAcknowledged, setAcknowledged] = useState(() => acknowledged(props.storage, props.storageKey));
+    const completed = useRef(false);
+    const dialog = useRef(null);
+    const continueButton = useRef(null);
+    const complete = useCallback(() => {
+        if (completed.current)
+            return;
+        completed.current = true;
+        props.complete?.();
+    }, [props.complete]);
+    useEffect(() => {
+        if (isAcknowledged)
+            complete();
+    }, [complete, isAcknowledged]);
+    useEffect(() => {
+        if (isAcknowledged)
+            return;
+        const appRoot = document.getElementById("root");
+        const wasInert = appRoot?.inert;
+        if (appRoot !== null)
+            appRoot.inert = true;
+        continueButton.current?.focus();
+        return () => {
+            if (appRoot !== null)
+                appRoot.inert = wasInert ?? false;
+        };
+    }, [isAcknowledged]);
+    const confirm = useCallback(() => {
+        try {
+            props.storage.setItem(props.storageKey, QA_WELCOME_NOTICE_VERSION);
+        }
+        catch {
+            // A denied localStorage write only costs persistence across reloads.
+        }
+        setAcknowledged(true);
+        window.dispatchEvent(new CustomEvent(QA_WELCOME_ACKNOWLEDGED_EVENT, {
+            detail: props.storageKey,
+        }));
+        complete();
+    }, [complete, props.storage, props.storageKey]);
+    const trapKeys = useCallback((event) => {
+        if (event.key === "Escape") {
+            event.preventDefault();
+            event.stopPropagation();
+            return;
+        }
+        if (event.key !== "Tab" || dialog.current === null)
+            return;
+        const items = focusable(dialog.current);
+        if (items.length === 0) {
+            event.preventDefault();
+            dialog.current.focus();
+            return;
+        }
+        const first = items[0];
+        const last = items.at(-1);
+        if (event.shiftKey && document.activeElement === first) {
+            event.preventDefault();
+            last?.focus();
+        }
+        else if (!event.shiftKey && document.activeElement === last) {
+            event.preventDefault();
+            first?.focus();
+        }
+    }, []);
+    if (isAcknowledged)
+        return null;
+    return createPortal(_jsx("div", { className: "dsh-qa-onboarding", onKeyDown: trapKeys, children: _jsxs("div", { ref: dialog, className: "dsh-qa-onboarding__panel", role: "dialog", "aria-modal": "true", "aria-labelledby": "dsh-qa-onboarding-title", "aria-describedby": "dsh-qa-onboarding-description", tabIndex: -1, children: [_jsx("div", { className: "dsh-qa-onboarding__mark", "aria-hidden": "true", children: _jsxs("svg", { viewBox: "0 0 24 24", children: [_jsx("path", { d: "M12 3.5 20 8v8l-8 4.5L4 16V8l8-4.5Z" }), _jsx("path", { d: "m8.75 12 2 2 4.5-4.5" })] }) }), _jsxs("div", { className: "dsh-qa-onboarding__content", children: [_jsx("h1", { id: "dsh-qa-onboarding-title", className: "dsh-qa-onboarding__title", children: QA_WELCOME_NOTICE_COPY.title }), _jsx("div", { id: "dsh-qa-onboarding-description", className: "dsh-qa-onboarding__description", children: QA_WELCOME_NOTICE_COPY.paragraphs.map((paragraph) => (_jsx("p", { children: paragraph }, paragraph))) }), _jsx("div", { className: "dsh-qa-onboarding__actions", children: _jsx("button", { ref: continueButton, type: "button", className: "dsh-qa-onboarding__continue", onClick: confirm, children: QA_WELCOME_NOTICE_COPY.continueLabel }) })] })] }) }), document.body);
+}
+/**
+ * Invisible shadow for DSH's stock welcome step. The host coordinator removes
+ * onboarding content as soon as a chat stops being blank, so the visible QA
+ * notice is owned by the route overlay above instead of this lifecycle.
+ */
+export function QaWelcomeNoticeStep(props) {
+    const [isAcknowledged, setAcknowledged] = useState(() => acknowledged(props.storage, props.storageKey));
+    const completed = useRef(false);
+    useEffect(() => {
+        const handleAcknowledged = (event) => {
+            if (event instanceof CustomEvent && event.detail === props.storageKey) {
+                setAcknowledged(true);
+            }
+        };
+        window.addEventListener(QA_WELCOME_ACKNOWLEDGED_EVENT, handleAcknowledged);
+        return () => window.removeEventListener(QA_WELCOME_ACKNOWLEDGED_EVENT, handleAcknowledged);
+    }, [props.storageKey]);
+    useEffect(() => {
+        if (!isAcknowledged || completed.current)
+            return;
+        completed.current = true;
+        props.complete();
+    }, [isAcknowledged, props.complete]);
+    return null;
+}
+//# sourceMappingURL=QaWelcomeNotice.js.map

package/lib/client/components/QaWelcomeNotice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QaWelcomeNotice.js","sourceRoot":"","sources":["../../../src/client/components/QaWelcomeNotice.tsx"],"names":[],"mappings":"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"}