@drscrewdriver/dsh-better-display 0.3.3-fork.1

package/lib/types/client/waiting-clock.js

@@ -0,0 +1,80 @@
+const timestamp = (value) => typeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : null;
+/**
+ * Chat-layer kinds that hand the turn back to the model unconditionally.
+ *
+ * These are `ChatNodeDataMap` keys, NOT conversation-layer `ConversationNode` kinds.
+ * The two layers name the same idea differently: a returned tool is `tool-result`
+ * in the conversation contract, but the row the reader sees is the `tool-call` node.
+ * A name copied from the wrong layer silently disables the branch it guards, so
+ * the `satisfies` below makes the compiler reject any name that is not a real kind.
+ */
+export const WAIT_AFTER = new Set(['context', 'model-retry']);
+/**
+ * Every chat-kind the handover logic reasons about, checked against the host's own
+ * kind union at compile time. Adding a name here that the host does not register
+ * fails `tsc` instead of failing silently at runtime.
+ */
+export const HANDOVER_KINDS = [
+    'user', 'steering', 'context', 'model-retry', 'tool-call', 'command',
+];
+/**
+ * Mirrors the host's `isSettledTool`: a running call has no `kind`, a settled one
+ * carries `kind: 'tool-result'`. Kept local so this module stays dependency-free,
+ * and pinned by a test against the host's own helper contract.
+ */
+function toolSettled(data) {
+    const root = data?.root;
+    return typeof root === 'object' && root !== null && root.kind === 'tool-result';
+}
+/** A command that is still executing has no outcome yet; only a settled one hands over. */
+function commandSettled(data) {
+    return data?.outcome != null;
+}
+/**
+ * Does this node leave the model on the hook for the next move?
+ *
+ * A tool or command that is *still running* is not a wait — the tool is the one
+ * working. Only its returned form hands control back, which is exactly the moment
+ * the model can stall.
+ */
+export function handsBackToModel(node) {
+    if (node.kind === 'user' || node.kind === 'steering')
+        return true;
+    if (node.kind === 'tool-call')
+        return toolSettled(node.data);
+    if (node.kind === 'command')
+        return commandSettled(node.data);
+    return WAIT_AFTER.has(node.kind);
+}
+/**
+ * The moment the current wait began.
+ *
+ * This is the time of the **last** node that handed control to the model — a
+ * returned tool, an injected context, or the user's own message. Anchoring on the
+ * user's message alone made the readout count the entire turn, so a wait that had
+ * only just begun showed the minutes the tools had already spent.
+ */
+export function waitingAnchor(order, get, pending = []) {
+    let anchor = { key: 'unresolved', time: null };
+    for (let i = order.length - 1; i >= 0; i--) {
+        const node = get(order[i]);
+        if (!node)
+            continue;
+        if (!handsBackToModel(node))
+            continue;
+        const time = node.data && typeof node.data === 'object' && 'time' in node.data && typeof node.data.time === 'number' ? node.data.time : undefined;
+        anchor = { key: order[i], time: timestamp(time) };
+        break;
+    }
+    for (let i = pending.length - 1; i >= 0; i--) {
+        const input = pending[i];
+        if (input.placement === 'queued')
+            continue;
+        const time = timestamp(input.time);
+        if (time === null || anchor.time === null || time >= anchor.time)
+            return { key: `pending:${input.requestId}`, time };
+        break;
+    }
+    return anchor;
+}
+//# sourceMappingURL=waiting-clock.js.map

package/lib/types/client/waiting-clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waiting-clock.js","sourceRoot":"","sources":["../../../src/client/waiting-clock.ts"],"names":[],"mappings":"AAKA,MAAM,SAAS,GAAG,CAAC,KAAyB,EAAiB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAEjJ;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAe,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC;AAE5E;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS;CAC1B,CAAC;AAE7C;;;;GAIG;AACH,SAAS,WAAW,CAAC,IAAa;IAChC,MAAM,IAAI,GAAI,IAAuC,EAAE,IAAI,CAAC;IAC5D,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAK,IAA2B,CAAC,IAAI,KAAK,aAAa,CAAC;AAC1G,CAAC;AAED,2FAA2F;AAC3F,SAAS,cAAc,CAAC,IAAa;IACnC,OAAQ,IAA0C,EAAE,OAAO,IAAI,IAAI,CAAC;AACtE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAe;IAC9C,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IAClE,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7D,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9D,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAoB,CAAC,CAAC;AACnD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,KAAwB,EAAE,GAA2C,EAAE,UAAiC,EAAE;IACtI,IAAI,MAAM,GAAkB,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC9D,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC;YAAE,SAAS;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,IAAI,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QAClJ,MAAM,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QAClD,MAAM;IACR,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,KAAK,CAAC,SAAS,KAAK,QAAQ;YAAE,SAAS;QAC3C,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,IAAI,MAAM,CAAC,IAAI;YAAE,OAAO,EAAE,GAAG,EAAE,WAAW,KAAK,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC;QACrH,MAAM;IACR,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/lib/types/client/word-motion.d.ts

@@ -0,0 +1,16 @@
+import type { MarkdownFileMentions } from '@deepseek-ai/dsh-client-ui-primitives';
+/** Native Think is literal text, not Markdown. Spans never alter its bytes. */
+export declare function MotionPlainText({ text, enabled, revision }: {
+    text: string;
+    enabled: boolean;
+    revision: number;
+}): import("react").JSX.Element;
+/** Native DSH Markdown semantics with a stable text-leaf animation hook. */
+export declare function MotionMarkdown({ text, streaming, enabled, revision, fileMentions }: {
+    text: string;
+    streaming: boolean;
+    enabled: boolean;
+    revision: number;
+    fileMentions?: MarkdownFileMentions;
+}): import("react").JSX.Element;
+//# sourceMappingURL=word-motion.d.ts.map

package/lib/types/client/word-motion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"word-motion.d.ts","sourceRoot":"","sources":["../../../src/client/word-motion.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAmDlF,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,+BAYhH;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE;IACnF,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,oBAAoB,CAAC;CAC3G,+BAoBA"}

package/lib/types/client/word-motion.js

@@ -0,0 +1,90 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useLayoutEffect, useMemo, useRef } from 'react';
+import { MarkdownText } from './markdown/MarkdownText.js';
+import { readerPathImages } from './platform-media.js';
+import { WORD_MOTION, WordTimeline } from './word-timeline.js';
+import css from './Reader.module.css';
+const WordScope = createContext({ enabled: false, generation: 0 });
+const CODE_LABELS = { copyLabel: '复制代码', copiedLabel: '已复制' };
+function useSourceReveal(element, born, generation) {
+    const scope = useContext(WordScope);
+    const cancelled = useRef(false);
+    useLayoutEffect(() => {
+        const target = element.current;
+        if (!target)
+            return;
+        target.dataset.wordState = 'settled';
+        if (!scope.enabled || scope.generation !== generation) {
+            cancelled.current = true;
+            return;
+        }
+        if (cancelled.current || born === null || document.hidden)
+            return;
+        const age = Number(document.timeline.currentTime ?? performance.now()) - born;
+        if (age >= WORD_MOTION.duration || typeof target.animate !== 'function')
+            return;
+        // The reference opacity + blur frames, applied only to this new word.
+        // No color interpolation, stylesheet mutation, or whole-paragraph wipe.
+        const animation = target.animate([
+            { opacity: 0, filter: `blur(${WORD_MOTION.blur}px)` },
+            { opacity: 1, filter: 'blur(0px)' },
+        ], { duration: WORD_MOTION.duration, easing: WORD_MOTION.easing, fill: 'backwards' });
+        // One absolute clock prevents newly mounted/resegmented leaves from getting
+        // a fresh delay or running ahead because their layout effects ran later.
+        animation.startTime = born;
+        target.dataset.wordState = 'resolving';
+        const finish = () => { animation.cancel(); target.dataset.wordState = 'settled'; document.removeEventListener('visibilitychange', hidden); };
+        animation.onfinish = finish;
+        const hidden = () => { if (document.hidden) {
+            cancelled.current = true;
+            finish();
+        } };
+        document.addEventListener('visibilitychange', hidden);
+        return () => { animation.cancel(); document.removeEventListener('visibilitychange', hidden); target.dataset.wordState = 'settled'; };
+    }, [element, born, generation, scope.enabled, scope.generation]);
+}
+function Word({ children, born, generation, offset, inline }) {
+    const element = useRef(null);
+    useSourceReveal(element, born, generation);
+    return _jsx("span", { ref: element, className: inline ? css.streamInlineWord : css.streamWord, "data-reader-word": true, "data-source-start": offset, "data-source-birth": born ?? undefined, children: children });
+}
+/** A native code block enters on the same clock, without rebuilding its text. */
+function MotionAtom({ children, born, generation, offset }) {
+    const element = useRef(null);
+    useSourceReveal(element, born, generation);
+    return _jsx("div", { ref: element, className: css.streamAtom, "data-reader-atom": true, "data-source-start": offset, "data-source-birth": born ?? undefined, children: children });
+}
+/** Native Think is literal text, not Markdown. Spans never alter its bytes. */
+export function MotionPlainText({ text, enabled, revision }) {
+    const timeline = useRef();
+    timeline.current ??= new WordTimeline();
+    timeline.current.begin(text, enabled, revision, Number(document.timeline.currentTime ?? performance.now()));
+    const current = timeline.current;
+    const generation = current.generation;
+    const scope = useMemo(() => ({ enabled, generation }), [enabled, generation]);
+    return _jsx(WordScope.Provider, { value: scope, children: _jsx("div", { className: css.reasonPlain, children: current.hasLiveText ? current.words(text, 0).map(word => word.text.trim()
+                ? _jsx(Word, { born: word.born, generation: generation, offset: word.key, inline: true, children: word.text }, word.key)
+                : word.text) : text }) });
+}
+/** Native DSH Markdown semantics with a stable text-leaf animation hook. */
+export function MotionMarkdown({ text, streaming, enabled, revision, fileMentions }) {
+    const timeline = useRef();
+    timeline.current ??= new WordTimeline();
+    timeline.current.begin(text, enabled, revision, Number(document.timeline.currentTime ?? performance.now()));
+    const generation = timeline.current.generation;
+    const scope = useMemo(() => ({ enabled, generation }), [enabled, generation]);
+    const renderText = useMemo(() => (value, offset, inline = false) => {
+        const current = timeline.current;
+        if (!current.hasLiveText)
+            return value;
+        return current.words(value, offset).map(word => word.text.trim()
+            ? _jsx(Word, { born: word.born, generation: current.generation, offset: word.key, inline: inline || /^\p{P}+$/u.test(word.text), children: word.text }, word.key)
+            : word.text);
+    }, []);
+    const renderAtom = useMemo(() => (children, offset) => {
+        const current = timeline.current;
+        return current.hasLiveText ? _jsx(MotionAtom, { born: current.bornAt(offset), generation: current.generation, offset: offset, children: children }) : children;
+    }, []);
+    return _jsx(WordScope.Provider, { value: scope, children: _jsx(MarkdownText, { text: text, streaming: streaming, codeLabels: CODE_LABELS, fileMentions: fileMentions, pathImages: readerPathImages, renderText: renderText, renderAtom: renderAtom }) });
+}
+//# sourceMappingURL=word-motion.js.map

package/lib/types/client/word-motion.js.map

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

package/lib/types/client/word-timeline.d.ts

@@ -0,0 +1,32 @@
+/** Motion parameters from the public transitions.dev streaming-text recipe. */
+export declare const WORD_MOTION: {
+    readonly duration: 350;
+    readonly gap: 60;
+    readonly blur: 1;
+    readonly easing: "cubic-bezier(0.22, 1, 0.36, 1)";
+    readonly maxDelay: 240;
+    /** Floor for the per-word cadence once a batch is compressed. */
+    readonly minGap: 3;
+    /** One paint's words should land inside this window, however many arrive. */
+    readonly batchMs: 90;
+};
+export interface RevealingWord {
+    key: number;
+    text: string;
+    born: number | null;
+}
+/** Source-offset identity survives reparsing, frozen blocks, and final formatting. */
+export declare class WordTimeline {
+    generation: number;
+    hasLiveText: boolean;
+    private source;
+    private enabled;
+    private revision;
+    private floor;
+    private lastBirth;
+    private readonly births;
+    begin(source: string, enabled: boolean, revision: number, now: number): void;
+    bornAt(offset: number): number | null;
+    words(value: string, offset: number): RevealingWord[];
+}
+//# sourceMappingURL=word-timeline.d.ts.map

package/lib/types/client/word-timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"word-timeline.d.ts","sourceRoot":"","sources":["../../../src/client/word-timeline.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,eAAO,MAAM,WAAW;;;;;;IAMtB,iEAAiE;;IAEjE,6EAA6E;;CAErE,CAAC;AAKX,MAAM,WAAW,aAAa;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE;AAGjF,sFAAsF;AACtF,qBAAa,YAAY;IACvB,UAAU,SAAK;IACf,WAAW,UAAS;IACpB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAE5C,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IA+C5E,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAYrC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE;CAuBtD"}

package/lib/types/client/word-timeline.js

@@ -0,0 +1,119 @@
+/** Motion parameters from the public transitions.dev streaming-text recipe. */
+export const WORD_MOTION = {
+    duration: 350,
+    gap: 60,
+    blur: 1,
+    easing: 'cubic-bezier(0.22, 1, 0.36, 1)',
+    maxDelay: 240,
+    /** Floor for the per-word cadence once a batch is compressed. */
+    minGap: 3,
+    /** One paint's words should land inside this window, however many arrive. */
+    batchMs: 90,
+};
+const segmenter = new Intl.Segmenter(undefined, { granularity: 'word' });
+const closingPunctuation = /^[\p{Pe}\p{Pf},.!?:;，。！？、；：％‰…·]+$/u;
+const openingPunctuation = /^[\p{Ps}\p{Pi}]+$/u;
+/** Source-offset identity survives reparsing, frozen blocks, and final formatting. */
+export class WordTimeline {
+    generation = 0;
+    hasLiveText = false;
+    source = null;
+    enabled = false;
+    revision = 0;
+    floor = 0;
+    lastBirth = -Infinity;
+    births = [];
+    begin(source, enabled, revision, now) {
+        if (this.source === source && this.enabled === enabled && this.revision === revision)
+            return;
+        const replaced = revision !== this.revision || (this.source !== null && !source.startsWith(this.source));
+        if (replaced || !enabled) {
+            this.births.length = 0;
+            this.lastBirth = -Infinity;
+            this.generation++;
+            this.floor = source.length;
+        }
+        else if (this.source === null) {
+            // A mounted historical prefix must not replay; a fresh live buffer mounts empty.
+            this.floor = source.length;
+        }
+        else {
+            // Allocate in source order, before Markdown can split/reorder text leaves.
+            // Intervals cover every offset, so resegmented CJK words inherit the time
+            // of their characters rather than falling through as instant "history".
+            const from = this.source.length;
+            const added = source.slice(from);
+            // The cadence follows the batch, not a constant. A fixed per-word gap caps
+            // the reveal at ~16 words/second however fast the model actually wrote, so
+            // a 500 tok/s answer still dripped out one word at a time. A batch of many
+            // words is compressed into one short window instead; a lone word keeps the
+            // original typing rhythm.
+            let arriving = 0;
+            for (const part of segmenter.segment(added))
+                if (part.segment.trim())
+                    arriving++;
+            const gap = arriving > 1
+                ? Math.max(WORD_MOTION.minGap, Math.min(WORD_MOTION.gap, WORD_MOTION.batchMs / arriving))
+                : WORD_MOTION.gap;
+            for (const part of segmenter.segment(added)) {
+                let born = Number.isFinite(this.lastBirth) ? this.lastBirth : null;
+                if (part.segment.trim()) {
+                    // Capping at the batch window is what stops a queue from forming: the
+                    // clock can never run further ahead than one window past the newest text.
+                    born = Math.min(now + WORD_MOTION.batchMs, Math.max(now, this.lastBirth + gap));
+                    this.lastBirth = born;
+                }
+                const end = from + part.index + part.segment.length;
+                const previous = this.births.at(-1);
+                if (previous && previous.born === born)
+                    previous.end = end;
+                else
+                    this.births.push({ end, born });
+            }
+        }
+        this.source = source;
+        this.enabled = enabled;
+        this.revision = revision;
+        this.hasLiveText = enabled && this.births.length > 0;
+    }
+    bornAt(offset) {
+        if (!this.enabled || offset < this.floor || this.births.length === 0)
+            return null;
+        let low = 0;
+        let high = this.births.length - 1;
+        while (low < high) {
+            const middle = (low + high) >>> 1;
+            if (this.births[middle].end <= offset)
+                low = middle + 1;
+            else
+                high = middle;
+        }
+        return this.births[low].born;
+    }
+    words(value, offset) {
+        // Atomic inline animation boxes must not turn commas into legal line starts
+        // or strand opening quotes at a line end. Keep source-offset identities when
+        // punctuation arrives in a later chunk, so the preceding word never replays.
+        // Already received text is one inert leaf, not thousands of React Words.
+        // Only the newly appended suffix needs word identities and birth times.
+        const prefixLength = Math.min(value.length, Math.max(0, this.floor - offset));
+        const prefix = prefixLength > 0
+            ? [{ key: offset, text: value.slice(0, prefixLength), born: null }]
+            : [];
+        const parts = [];
+        for (const segment of segmenter.segment(value.slice(prefixLength))) {
+            const part = { index: prefixLength + segment.index, segment: segment.segment };
+            const previous = parts.at(-1);
+            if (previous?.segment.trim() && (closingPunctuation.test(part.segment) || openingPunctuation.test(previous.segment))) {
+                previous.segment += part.segment;
+            }
+            else
+                parts.push({ index: part.index, segment: part.segment });
+        }
+        return prefix.concat(parts.map(part => {
+            const key = offset + part.index;
+            return { key, text: part.segment, born: this.bornAt(key) };
+        }));
+    }
+}
+//# sourceMappingURL=word-timeline.js.map

package/lib/types/client/word-timeline.js.map

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

package/lib/types/dsh-better-display.d.ts

@@ -0,0 +1,17 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { Context } from '@deepseek-ai/cordis';
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        webServer?: {
+            register: (route: {
+                kind: 'exact' | 'prefix';
+                path: string;
+                handler: (req: IncomingMessage, res: ServerResponse) => void | Promise<void>;
+            }) => () => void;
+        };
+    }
+}
+export declare const name = "@drscrewdriver/dsh-better-display";
+export declare const inject: string[];
+export declare function apply(ctx: Context): void;
+//# sourceMappingURL=dsh-better-display.d.ts.map

package/lib/types/dsh-better-display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsh-better-display.d.ts","sourceRoot":"","sources":["../../src/dsh-better-display.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAInD,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,SAAS,CAAC,EAAE;YACV,QAAQ,EAAE,CAAC,KAAK,EAAE;gBAChB,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;gBACzB,IAAI,EAAE,MAAM,CAAC;gBACb,OAAO,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;aAC9E,KAAK,MAAM,IAAI,CAAC;SAClB,CAAC;KACH;CACF;AAED,eAAO,MAAM,IAAI,sCAAsC,CAAC;AACxD,eAAO,MAAM,MAAM,UAAgB,CAAC;AAcpC,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CA0ExC"}

package/lib/types/dsh-better-display.js

@@ -0,0 +1,93 @@
+import { spawn } from 'node:child_process';
+import { scanGenerativeMcpappsStatus } from './skill-roots.js';
+import { skillsFromListResult, toPublicSkillStatus } from './skill-status.js';
+export const name = '@drscrewdriver/dsh-better-display';
+export const inject = ['webServer'];
+function writeJson(res, status, body) {
+    res.setHeader('Content-Type', 'application/json');
+    res.statusCode = status;
+    res.end(JSON.stringify(body));
+}
+function skillLister(ctx) {
+    const skills = ctx.get?.('skills');
+    if (typeof skills?.list !== 'function')
+        return undefined;
+    return async () => skillsFromListResult(await skills.list({}));
+}
+export function apply(ctx) {
+    console.log('[my-plugins/dsh-better-display] loaded');
+    if (ctx.webServer) {
+        ctx.effect(() => {
+            const disposeReveal = ctx.webServer.register({
+                kind: 'exact',
+                path: '/better-display/reveal',
+                handler: async (req, res) => {
+                    if (req.method !== 'POST') {
+                        res.statusCode = 405;
+                        res.end();
+                        return;
+                    }
+                    let body = '';
+                    req.on('data', chunk => { body += chunk; });
+                    req.on('end', () => {
+                        try {
+                            const data = JSON.parse(body);
+                            const targetPath = typeof data.path === 'string' ? data.path.trim() : '';
+                            if (!targetPath) {
+                                res.statusCode = 400;
+                                res.end(JSON.stringify({ ok: false, error: 'Empty path' }));
+                                return;
+                            }
+                            if (process.platform === 'darwin') {
+                                // Exact file reveal in macOS Finder with selection highlight
+                                spawn('open', ['-R', targetPath], { detached: true, stdio: 'ignore' });
+                            }
+                            else if (process.platform === 'win32') {
+                                // Exact file selection in Windows Explorer
+                                spawn('explorer.exe', [`/select,${targetPath}`], { detached: true, stdio: 'ignore' });
+                            }
+                            else {
+                                spawn('xdg-open', [targetPath], { detached: true, stdio: 'ignore' });
+                            }
+                            res.setHeader('Content-Type', 'application/json');
+                            res.statusCode = 200;
+                            res.end(JSON.stringify({ ok: true }));
+                        }
+                        catch (err) {
+                            res.statusCode = 400;
+                            res.end(JSON.stringify({ ok: false, error: String(err) }));
+                        }
+                    });
+                },
+            });
+            const disposeSkill = ctx.webServer.register({
+                kind: 'exact',
+                path: '/better-display/skill-status',
+                handler: async (req, res) => {
+                    if (req.method !== 'GET') {
+                        res.statusCode = 405;
+                        res.end();
+                        return;
+                    }
+                    try {
+                        const url = new URL(req.url ?? '', 'http://127.0.0.1');
+                        const cwd = url.searchParams.get('cwd') ?? undefined;
+                        const status = await scanGenerativeMcpappsStatus({
+                            cwd,
+                            listSkills: skillLister(ctx),
+                        });
+                        writeJson(res, 200, toPublicSkillStatus(status));
+                    }
+                    catch (err) {
+                        writeJson(res, 500, { ok: false, error: String(err) });
+                    }
+                },
+            });
+            return () => {
+                disposeReveal();
+                disposeSkill();
+            };
+        }, 'dsh-better-display: reveal and skill-status routes');
+    }
+}
+//# sourceMappingURL=dsh-better-display.js.map

package/lib/types/dsh-better-display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsh-better-display.js","sourceRoot":"","sources":["../../src/dsh-better-display.ts"],"names":[],"mappings":"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"}

package/lib/types/skill-roots.d.ts

@@ -0,0 +1,22 @@
+import { type HostSkillStatus, type SkillRootInfo } from './skill-status.js';
+export declare function expandHomePath(path: string, home?: string): string;
+/** `$DSH_HOME` or `~/.dsh`, matching official `resolveDshHome`. */
+export declare function resolveDshHome(env?: Record<string, string | undefined>, home?: string): string;
+/** `$DSH_AGENTS_HOME` or `~/.agents`. */
+export declare function resolveAgentsHome(env?: Record<string, string | undefined>, home?: string): string;
+export declare function userSkillRoots(env?: Record<string, string | undefined>, home?: string): readonly SkillRootInfo[];
+export declare function projectSkillRoots(projectRoot: string): readonly SkillRootInfo[];
+export declare function findProjectRoot(cwd: string): Promise<string>;
+export declare function rootHasGenerativeMcpapps(rootPath: string): Promise<boolean>;
+/** Resolve the plugin-shipped pack. This path is never treated as a skill root. */
+export declare function pluginSkillPackPath(moduleUrl?: string): string | undefined;
+export declare function scanGenerativeMcpappsStatus(options?: {
+    cwd?: string;
+    env?: Record<string, string | undefined>;
+    home?: string;
+    packPath?: string;
+    listSkills?: () => Promise<readonly {
+        readonly name?: string;
+    }[] | undefined>;
+}): Promise<HostSkillStatus>;
+//# sourceMappingURL=skill-roots.d.ts.map

package/lib/types/skill-roots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-roots.d.ts","sourceRoot":"","sources":["../../src/skill-roots.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAC;AAE3B,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAY,GAAG,MAAM,CAIrE;AAED,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,EAAE,IAAI,SAAY,GAAG,MAAM,CAI9G;AAED,yCAAyC;AACzC,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,EAAE,IAAI,SAAY,GAAG,MAAM,CAIjH;AAED,wBAAgB,cAAc,CAC5B,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,EACrD,IAAI,SAAY,GACf,SAAS,aAAa,EAAE,CAK1B;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,aAAa,EAAE,CAK/E;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQlE;AAED,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAqBjF;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,SAAS,SAAkB,GAAG,MAAM,GAAG,SAAS,CAQnF;AAED,wBAAsB,2BAA2B,CAAC,OAAO,GAAE;IACzD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,SAAS;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,SAAS,CAAC,CAAC;CAC1E,GAAG,OAAO,CAAC,eAAe,CAAC,CAqChC"}