@khorsheed/dsh-file-preview 0.3.2 → 0.4.0

package/lib/types/client/locales.js

@@ -0,0 +1,177 @@
+/** `filePreview` namespace dictionaries (right-Sidebar tab + document renderer + turn card copy). */
+/** Dictionary namespace owned by this plugin. */
+export const NS = 'filePreview';
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export const zh = {
+    'open': '产物',
+    'view.search.placeholder': '搜索文件…',
+    'view.search.noMatch': '没有匹配的文件',
+    'preview.search.placeholder': '搜索文件内容…',
+    'preview.search.noMatch': '没有匹配内容',
+    'preview.search.prev': '上一个匹配',
+    'preview.search.next': '下一个匹配',
+    'preview.htmlToggle': 'HTML 视图',
+    'preview.htmlSource': '源码',
+    'preview.htmlRender': '渲染',
+    'preview.htmlScript': '运行脚本',
+    'preview.htmlScriptStop': '停止运行',
+    'preview.scriptConfirm': '此文件含脚本，将在隔离沙箱中运行（无网络、无法访问宿主）',
+    'preview.scriptRun': '运行',
+    'preview.scriptCancel': '取消',
+    'preview.slowHint': '渲染超时——文档可能过大，可切源码视图或在浏览器中打开',
+    'preview.fullscreen': '全屏',
+    'preview.exitFullscreen': '退出全屏',
+    'preview.staticHint': '静态预览：此页面含脚本，脚本不会运行——点右上角「运行脚本」可交互',
+    'turn.count': '{count} 个产物',
+    'json.copyValue': '复制值',
+    'json.copyJson': '复制 JSON',
+    'json.copyPath': '复制属性路径',
+    'json.copyPrettyJson': '复制格式化 JSON',
+    'json.copyCompactJson': '复制紧凑 JSON',
+    'json.copied': '已复制',
+    'json.copyFailed': '复制失败',
+    'json.collapseNode': '折叠 JSON 节点',
+    'json.expandNode': '展开 JSON 节点',
+    'json.copyButtonTitle': '{action}；右键查看更多复制选项',
+    'json.treeLabel': 'JSON 结构',
+    'markdown.copy': '复制',
+    'markdown.copied': '已复制',
+    'markdown.footnotes': '脚注',
+    'diff.copy': '复制差异',
+    'diff.copied': '已复制',
+    'diff.collapse': '收起',
+    'diff.collapseAria': '收起差异',
+    'diff.expand': '展开其余 {count} 行',
+    'diff.expandAria': '展开其余 {count} 行',
+    'diff.files': '{count} 个文件',
+    'diff.code': '代码块',
+    'diff.wrap': '自动换行',
+    'diff.unwrap': '取消自动换行',
+    'guide.title': '会话产物',
+    'guide.description': '会话写过的每个文件：看内容，也看每一次改动',
+    'list.empty': '这个会话还没有写过文件',
+    'list.error': '文件列表加载失败',
+    'list.loading': '加载中…',
+    'list.outsideWorkspace': '位于工作区外，无内容预览',
+    'list.refresh': '刷新',
+    'history.empty': '该文件没有记录到改动内容',
+    'history.step': '第 {turn} 轮 · 第 {step} 步',
+    'history.step.count': '修改 {current}/{total}',
+    'history.step.latest': '最新',
+    'history.step.older': '查看更早的修改',
+    'history.step.newer': '查看更新的修改',
+    'detail.back': '返回产物列表',
+    'mention.open': '在侧边栏打开 {name}',
+    // The shared content pane's keys (see the header note above).
+    'action.chooseIDE': '选择 IDE',
+    'action.copy': '复制',
+    'action.copied': '已复制',
+    'action.copyPath': '复制路径',
+    'action.openFolder': '打开目录',
+    'action.openIDE': '在 IDE 中打开',
+    'action.reload': '重新加载',
+    'detail.content': '内容',
+    'detail.deleted': '文件已删除',
+    'detail.diff': '改动',
+    'detail.noSelection': '选择一个文件查看详情',
+    'detail.preview': '预览',
+    'detail.source': '源码',
+    'local.binary': '二进制文件，无法预览文本',
+    'local.noSelection': '选择一个文件预览内容',
+    'local.tooLarge': '文件过大，未载入预览',
+    'local.unreadable': '无法读取该文件',
+    'search.hit': '匹配 {current}/{total}',
+    'search.next': '下一个匹配',
+    'search.noMatch': '无匹配',
+    'search.placeholder': '在内容中搜索…',
+    'search.prev': '上一个匹配',
+    'state.error': '加载失败：{message}',
+    'state.loading': '加载中…',
+};
+/** English dictionary. */
+export const en = {
+    'open': 'Produced',
+    'view.search.placeholder': 'Search files…',
+    'view.search.noMatch': 'No matching files',
+    'preview.search.placeholder': 'Search file content…',
+    'preview.search.noMatch': 'No matching content',
+    'preview.search.prev': 'Previous match',
+    'preview.search.next': 'Next match',
+    'preview.htmlToggle': 'HTML view',
+    'preview.htmlSource': 'Source',
+    'preview.htmlRender': 'Render',
+    'preview.htmlScript': 'Run scripts',
+    'preview.htmlScriptStop': 'Stop',
+    'preview.scriptConfirm': 'This file contains scripts; they will run in an isolated sandbox (no network, no host access)',
+    'preview.scriptRun': 'Run',
+    'preview.scriptCancel': 'Cancel',
+    'preview.slowHint': 'Render timed out — the document may be too large; try the source view or open it in a browser',
+    'preview.fullscreen': 'Fullscreen',
+    'preview.exitFullscreen': 'Exit fullscreen',
+    'preview.staticHint': 'Static preview: this page contains scripts, which do not run here — use "Run scripts" above for interactivity',
+    'turn.count': '{count} products',
+    'json.copyValue': 'Copy value',
+    'json.copyJson': 'Copy JSON',
+    'json.copyPath': 'Copy property path',
+    'json.copyPrettyJson': 'Copy pretty JSON',
+    'json.copyCompactJson': 'Copy compact JSON',
+    'json.copied': 'Copied',
+    'json.copyFailed': 'Copy failed',
+    'json.collapseNode': 'Collapse JSON node',
+    'json.expandNode': 'Expand JSON node',
+    'json.copyButtonTitle': '{action}; right-click for copy options',
+    'json.treeLabel': 'JSON structure',
+    'markdown.copy': 'Copy',
+    'markdown.copied': 'Copied',
+    'markdown.footnotes': 'Footnotes',
+    'diff.copy': 'Copy diff',
+    'diff.copied': 'Copied',
+    'diff.collapse': 'Collapse',
+    'diff.collapseAria': 'Collapse the diff',
+    'diff.expand': 'Show {count} more lines',
+    'diff.expandAria': 'Show {count} more lines',
+    'diff.files': '{count} files',
+    'diff.code': 'Code block',
+    'diff.wrap': 'Wrap lines',
+    'diff.unwrap': 'Do not wrap lines',
+    'guide.title': 'Session products',
+    'guide.description': 'Every file the session wrote — its content and each change',
+    'list.empty': 'This session has not written any files yet',
+    'list.error': 'Failed to load the file list',
+    'list.loading': 'Loading…',
+    'list.outsideWorkspace': 'Outside the workspace — no content preview',
+    'list.refresh': 'Refresh',
+    'history.empty': 'No change content recorded for this file',
+    'history.step': 'Turn {turn} · Step {step}',
+    'history.step.count': 'Change {current}/{total}',
+    'history.step.latest': 'latest',
+    'history.step.older': 'View an earlier change',
+    'history.step.newer': 'View a newer change',
+    'detail.back': 'Back to products',
+    'mention.open': 'Open {name} in the sidebar',
+    // The shared content pane's keys (see the header note above).
+    'action.chooseIDE': 'Choose IDE',
+    'action.copy': 'Copy',
+    'action.copied': 'Copied',
+    'action.copyPath': 'Copy path',
+    'action.openFolder': 'Open folder',
+    'action.openIDE': 'Open in IDE',
+    'action.reload': 'Reload',
+    'detail.content': 'Content',
+    'detail.deleted': 'File deleted',
+    'detail.diff': 'Changes',
+    'detail.noSelection': 'Select a file to view',
+    'detail.preview': 'Preview',
+    'detail.source': 'Source',
+    'local.binary': 'Binary file — text preview unavailable',
+    'local.noSelection': 'Select a file to preview',
+    'local.tooLarge': 'File too large — not loaded into preview',
+    'local.unreadable': 'This file could not be read',
+    'search.hit': 'Match {current}/{total}',
+    'search.next': 'Next match',
+    'search.noMatch': 'No matches',
+    'search.placeholder': 'Search in content…',
+    'search.prev': 'Previous match',
+    'state.error': 'Failed to load: {message}',
+    'state.loading': 'Loading…',
+};

package/lib/types/client/mentions-wrap.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Mention open-route unification (S1 tail): the official ui-deliverables
+ * `chatFileMentions` routes clicks on files delivered through the `present`
+ * tool to the native default application (`opener.open`), while undelivered
+ * files open in the right sidebar (`owner.openFile`). This plugin wants every
+ * prose mention to open in this package's detail view, so the provided
+ * service's `forClosing` is WRAPPED IN PLACE: the original implementation
+ * keeps its claim logic (which paths link), while every resolved mention gets
+ * a new `open` (the detail view through the injected reroute, falling back to
+ * `owner.openFile` — the official openResource route, which the file-preview
+ * tab type claims for known products — when the reroute throws) and a new
+ * label (the official text for present-delivered files says "open in the
+ * default app", which is no longer true).
+ *
+ * Why in-place mutation: `ctx.provide` rejects a second provider and
+ * `ctx.set` rejects any fiber but the provider's own ("cannot set property in
+ * multiple fibers", vendor/cordis reflect.ts) — no official cross-plugin
+ * replacement seam exists (the open-direction override is the S1 tail
+ * registered in docs/upstream-seam-registry.md). The mutated object is the
+ * exact reference the chat view reads per call
+ * (`ctx.get('chatFileMentions')?.forClosing(...)`), so the wrap takes effect
+ * without a remount. Ordering rides the dsh.client.inject package edge on
+ * ui-deliverables (compose order = apply order). If the deliverables fiber
+ * ever reloads (HMR), its fresh provide discards this wrap — accepted; the
+ * original behavior (native open for presented files) simply returns.
+ *
+ * The resolved path is recovered from the mention's `title`, which the
+ * official builder sets to the path (producedFileMentions, 0.1.5-rc.1) — a
+ * structural assumption re-checked on every host upgrade.
+ *
+ * @module @khorsheed/dsh-file-preview
+ */
+import type { ChatFileMentions } from '@deepseek-ai/dsh-client-ui-chat/client';
+/** The open behavior and label the wrap substitutes for every resolved mention. */
+export interface MentionReroute {
+    /**
+     * Open one resolved path in this package's own surface (the detail view).
+     * Takes the viewed session so the open can name the canonical
+     * `dsh-resource://file/session/<id>/<path>` address — the same tab the
+     * deliverables card's open reveals (one file, one tab). May throw (no
+     * mounted sidebar surface); the wrap then falls back to the owner's
+     * official `openFile`.
+     */
+    open(sessionId: string, path: string): void;
+    /**
+     * The mention's action label.
+     * @param path - the resolved path (the hit's title).
+     * @returns the visible label.
+     */
+    label(path: string): string;
+}
+/**
+ * Wrap the provided chatFileMentions service so every resolved mention opens
+ * in this package's detail view instead of the native default application.
+ * Idempotent: a second wrap of the same object is a no-op.
+ * @param mentions - the live service object ui-deliverables provided.
+ * @param reroute - the substituted open behavior and label.
+ */
+export declare function wrapChatFileMentions(mentions: ChatFileMentions, reroute: MentionReroute): void;
+//# sourceMappingURL=mentions-wrap.d.ts.map

package/lib/types/client/mentions-wrap.js

@@ -0,0 +1,42 @@
+/**
+ * Wrap the provided chatFileMentions service so every resolved mention opens
+ * in this package's detail view instead of the native default application.
+ * Idempotent: a second wrap of the same object is a no-op.
+ * @param mentions - the live service object ui-deliverables provided.
+ * @param reroute - the substituted open behavior and label.
+ */
+export function wrapChatFileMentions(mentions, reroute) {
+    if (WRAP_MARK in mentions)
+        return;
+    const original = mentions.forClosing.bind(mentions);
+    mentions.forClosing = (owner, sessionId) => {
+        const resolved = original(owner, sessionId);
+        if (resolved === undefined)
+            return undefined;
+        return {
+            resolve(value) {
+                const hit = resolved.resolve(value);
+                if (hit === undefined)
+                    return undefined;
+                // hit.title is the resolved path (official builder contract).
+                return {
+                    ...hit,
+                    label: reroute.label(hit.title),
+                    open: () => {
+                        try {
+                            reroute.open(sessionId, hit.title);
+                        }
+                        catch {
+                            // No mounted sidebar surface (or a lost race): the official
+                            // openFile still lands the file in the right sidebar.
+                            owner.openFile(hit.title);
+                        }
+                    },
+                };
+            },
+        };
+    };
+    Object.defineProperty(mentions, WRAP_MARK, { value: true });
+}
+/** Non-enumerable marker making the in-place wrap idempotent. */
+const WRAP_MARK = Symbol.for('dsh.file-preview.mentionsWrapped');

package/lib/types/client/open-in-app.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Browser face of the official open-in-app capability (host 0.1.5,
+ * `@deepseek-ai/dsh-host-open-in-app`): a once-per-page probe of the apps
+ * route decides whether the products tab's folder/IDE gestures render, and
+ * the folder fallback POSTs the open route. Mirrors local-files'
+ * `open-in-app.ts` (the client bundle purity gate forbids a cross-plugin
+ * value import); the route constants and wire payloads mirror the official
+ * `./shared` module verbatim — a mirrored constant degrades to "gestures
+ * hidden" rather than a boot failure if the host routes ever move. A host
+ * without open-in-app answers the probe with 404 (or the request fails
+ * outright), which reads exactly like "no apps": the gestures stay hidden,
+ * silently.
+ *
+ * @module @khorsheed/dsh-file-preview
+ */
+import { type SnapshotStore } from '@deepseek-ai/dsh-client-store';
+/** GET route serving the probed application ids (official shared.ts). */
+export declare const OPEN_IN_APP_APPS_ROUTE = "/open-in-app/apps";
+/** POST route launching one application on one directory (official shared.ts). */
+export declare const OPEN_IN_APP_OPEN_ROUTE = "/open-in-app/open";
+/** Apps-route response: catalog ids probed as installed, in menu order. */
+export interface OpenInAppAppsPayload {
+    readonly apps: readonly string[];
+}
+/** Open-route request body (directories only — the route 404s a file path). */
+export interface OpenInAppOpenPayload {
+    readonly app: string;
+    readonly path: string;
+}
+/**
+ * The file-manager catalog id for the "open folder" gesture.
+ * @param apps - probed app ids in the host's menu order.
+ * @returns the chosen catalog id, or undefined when no file manager resolved.
+ */
+export declare function pickFileManager(apps: readonly string[]): string | undefined;
+/**
+ * The editor/IDE catalog id for the "open in IDE" gesture.
+ * @param apps - probed app ids in the host's menu order.
+ * @returns the chosen catalog id, or undefined when no IDE resolved.
+ */
+export declare function pickIde(apps: readonly string[]): string | undefined;
+/** One probed IDE entry for the split button's menu. */
+export interface IdeChoice {
+    readonly id: string;
+    readonly label: string;
+}
+/**
+ * Every probed IDE in catalog order, nameable ones only (a catalog id without
+ * a known label stays invisible rather than showing a raw id — the official
+ * OpenInAppAction's rule).
+ * @param apps - probed app ids in the host's menu order.
+ */
+export declare function listIdes(apps: readonly string[]): readonly IdeChoice[];
+type Fetch = (input: string | URL, init?: RequestInit) => Promise<Response>;
+/**
+ * Owns the once-per-page apps probe and the folder-fallback POST. The probe
+ * publishes through a snapshot store: null until the host answered, the
+ * probed id list after. A failed read publishes an empty list, which hides
+ * the gestures — the same degrade the official header split button renders.
+ */
+export declare class OpenInAppProbe {
+    private readonly fetcher;
+    /** Installed app ids in host menu order; null until the host answered. */
+    readonly apps: SnapshotStore<readonly string[] | null>;
+    private loading;
+    /**
+     * @param fetcher - HTTP carrier for the apps read and the folder POST.
+     */
+    constructor(fetcher?: Fetch);
+    /**
+     * Read availability once per probe life; concurrent calls share the read.
+     * @returns after availability is published.
+     */
+    load(): Promise<void>;
+    /**
+     * Launch one installed app on a directory.
+     * @param appId - catalog id from the availability list.
+     * @param path - an absolute directory path (the open route refuses files).
+     * @returns true when the host acknowledged the launch, false on any failure.
+     */
+    open(appId: string, path: string): Promise<boolean>;
+    private run;
+}
+export {};
+//# sourceMappingURL=open-in-app.d.ts.map

package/lib/types/client/open-in-app.js

@@ -0,0 +1,146 @@
+/**
+ * Browser face of the official open-in-app capability (host 0.1.5,
+ * `@deepseek-ai/dsh-host-open-in-app`): a once-per-page probe of the apps
+ * route decides whether the products tab's folder/IDE gestures render, and
+ * the folder fallback POSTs the open route. Mirrors local-files'
+ * `open-in-app.ts` (the client bundle purity gate forbids a cross-plugin
+ * value import); the route constants and wire payloads mirror the official
+ * `./shared` module verbatim — a mirrored constant degrades to "gestures
+ * hidden" rather than a boot failure if the host routes ever move. A host
+ * without open-in-app answers the probe with 404 (or the request fails
+ * outright), which reads exactly like "no apps": the gestures stay hidden,
+ * silently.
+ *
+ * @module @khorsheed/dsh-file-preview
+ */
+import { createSnapshotStore } from '@deepseek-ai/dsh-client-store';
+/** GET route serving the probed application ids (official shared.ts). */
+export const OPEN_IN_APP_APPS_ROUTE = '/open-in-app/apps';
+/** POST route launching one application on one directory (official shared.ts). */
+export const OPEN_IN_APP_OPEN_ROUTE = '/open-in-app/open';
+/**
+ * Catalog ids (official catalog.ts) that open a directory in the host's file
+ * manager. In catalog order, so the first present id is the platform's own
+ * manager (Finder / Explorer / the Linux default handler).
+ */
+const FILE_MANAGER_IDS = ['finder', 'explorer', 'filemanager'];
+/** Catalog ids (official catalog.ts) that open a directory in an editor or IDE, in catalog order. */
+const IDE_IDS = [
+    'cursor', 'vscode', 'vscodeinsiders', 'windsurf', 'zed', 'sublimetext', 'xcode',
+    'androidstudio', 'intellij', 'pycharm', 'webstorm', 'phpstorm', 'goland', 'rider', 'rustrover',
+];
+/**
+ * The file-manager catalog id for the "open folder" gesture.
+ * @param apps - probed app ids in the host's menu order.
+ * @returns the chosen catalog id, or undefined when no file manager resolved.
+ */
+export function pickFileManager(apps) {
+    return FILE_MANAGER_IDS.find(id => apps.includes(id));
+}
+/**
+ * The editor/IDE catalog id for the "open in IDE" gesture.
+ * @param apps - probed app ids in the host's menu order.
+ * @returns the chosen catalog id, or undefined when no IDE resolved.
+ */
+export function pickIde(apps) {
+    return IDE_IDS.find(id => apps.includes(id));
+}
+/** Display names per IDE catalog id (official catalog naming; proper nouns, not localized). */
+const IDE_LABELS = {
+    cursor: 'Cursor',
+    vscode: 'Visual Studio Code',
+    vscodeinsiders: 'Visual Studio Code - Insiders',
+    windsurf: 'Windsurf',
+    zed: 'Zed',
+    sublimetext: 'Sublime Text',
+    xcode: 'Xcode',
+    androidstudio: 'Android Studio',
+    intellij: 'IntelliJ IDEA',
+    pycharm: 'PyCharm',
+    webstorm: 'WebStorm',
+    phpstorm: 'PhpStorm',
+    goland: 'GoLand',
+    rider: 'Rider',
+    rustrover: 'RustRover',
+};
+/**
+ * Every probed IDE in catalog order, nameable ones only (a catalog id without
+ * a known label stays invisible rather than showing a raw id — the official
+ * OpenInAppAction's rule).
+ * @param apps - probed app ids in the host's menu order.
+ */
+export function listIdes(apps) {
+    return IDE_IDS.filter(id => apps.includes(id) && IDE_LABELS[id] !== undefined)
+        .map(id => ({ id, label: IDE_LABELS[id] }));
+}
+/** Resolve the browser's Host base with the connection carrier's null-origin fallback. */
+function hostBase() {
+    const origin = globalThis.location?.origin;
+    return origin !== undefined && origin !== 'null' ? origin : 'http://dsh.internal';
+}
+/**
+ * Owns the once-per-page apps probe and the folder-fallback POST. The probe
+ * publishes through a snapshot store: null until the host answered, the
+ * probed id list after. A failed read publishes an empty list, which hides
+ * the gestures — the same degrade the official header split button renders.
+ */
+export class OpenInAppProbe {
+    fetcher;
+    /** Installed app ids in host menu order; null until the host answered. */
+    apps = createSnapshotStore(null);
+    loading;
+    /**
+     * @param fetcher - HTTP carrier for the apps read and the folder POST.
+     */
+    constructor(fetcher = (input, init) => fetch(input, init)) {
+        this.fetcher = fetcher;
+    }
+    /**
+     * Read availability once per probe life; concurrent calls share the read.
+     * @returns after availability is published.
+     */
+    load() {
+        this.loading ??= this.run();
+        return this.loading;
+    }
+    /**
+     * Launch one installed app on a directory.
+     * @param appId - catalog id from the availability list.
+     * @param path - an absolute directory path (the open route refuses files).
+     * @returns true when the host acknowledged the launch, false on any failure.
+     */
+    async open(appId, path) {
+        try {
+            const body = { app: appId, path };
+            const response = await this.fetcher(new URL(OPEN_IN_APP_OPEN_ROUTE, hostBase()), {
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                body: JSON.stringify(body),
+            });
+            return response.ok;
+        }
+        catch {
+            // Swallows network failures: a host that accepted the probe can still
+            // vanish mid-session; the native app surfaces its own launch errors.
+            return false;
+        }
+    }
+    async run() {
+        let apps = [];
+        try {
+            const response = await this.fetcher(new URL(OPEN_IN_APP_APPS_ROUTE, hostBase()), {
+                headers: { accept: 'application/json' },
+            });
+            if (response.ok) {
+                const payload = await response.json();
+                if (Array.isArray(payload.apps))
+                    apps = payload.apps.filter(id => typeof id === 'string');
+            }
+        }
+        catch {
+            // Swallows network failures: a host without open-in-app (404) or an
+            // unreachable host reads as no apps, and the gestures simply stay hidden.
+        }
+        this.apps.set(apps);
+    }
+}

package/lib/types/client/path-utils.d.ts

@@ -0,0 +1,53 @@
+/** Pure path display helpers for the file-preview tab. */
+import type { FilePreviewEntry } from '../types.ts';
+/** The last path segment; the path itself when it has no separator. */
+export declare function basename(path: string): string;
+/** Everything before the last path separator ('' when the path has none). */
+export declare function parentPath(path: string): string;
+/**
+ * Sort touched files by their last recorded activity, newest first. The fold
+ * keeps first-seen order; the view presents latest-first so the agent's most
+ * recent work is at the top.
+ * @param entries - the fold's first-seen entries.
+ * @returns a new array sorted by descending last-occurrence seq.
+ */
+export declare function sortByLatest(entries: readonly FilePreviewEntry[]): FilePreviewEntry[];
+/**
+ * Case-insensitive substring match of a search query against a file's display
+ * path (the whole path, so a directory name matches too). Empty and
+ * whitespace-only queries match nothing deliberately — the view treats them as
+ * "no search" and shows the unfiltered list.
+ * @param path - the entry's display path.
+ * @param query - the trimmed search term.
+ * @returns whether the path contains the query, ignoring case.
+ */
+export declare function matchesQuery(path: string, query: string): boolean;
+/**
+ * Split a file name into [before, match, after] for the first case-insensitive
+ * occurrence of `query`, so the view can highlight the matched substring.
+ * @param name - the display name to search.
+ * @param query - the trimmed search term.
+ * @returns the three parts, or null when the name does not contain the query.
+ */
+export declare function highlightMatch(name: string, query: string): readonly [string, string, string] | null;
+/** Strip a workspace root prefix for compact display; the path stands when unrelated. */
+export declare function relativeToCwd(path: string, cwd: string | undefined): string;
+/**
+ * Whether the official document tab can render this path: the `file` resource
+ * is workspace-scoped (the host answers outside-workspace stats with
+ * `workspace-file/outside-workspace`), so only workspace-rooted paths get a
+ * `dsh-resource://file/...` open. Relative paths qualify (the host resolves
+ * them against the session root); an absolute path qualifies when the session
+ * cwd is known and contains it, or when the cwd is unknown — the host's own
+ * failure line is the honest answer there.
+ * @param cwd - the session's workspace root, when known.
+ * @param path - the recorded display path (absolute or workspace-relative).
+ * @returns whether `openResource` stands a chance of rendering the file.
+ */
+export declare function isWithinWorkspace(cwd: string | undefined, path: string): boolean;
+/** Whether a path names an HTML document (`.html`/`.htm`), offered a
+ * sandboxed render view alongside the source view. */
+export declare function isHtmlPath(path: string): boolean;
+/** The prism language name for a path's extension, or undefined for auto-detection. */
+export declare function languageFor(path: string): string | undefined;
+//# sourceMappingURL=path-utils.d.ts.map