dsh-plugin-core 0.31.0 → 0.33.0

package/dist/adv/explorer/picker-placement.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 选文件弹窗的锚定定位（**纯函数、零 DOM**）：给定锚点矩形 + 视口 + 方位，算出面板盒子。
+ *
+ * 八档方位 + `auto`（用户 2026-11-03 定，8 档就是他点的规格）：
+ *
+ * | 值 | 面板落点 |
+ * |---|---|
+ * | `bottom-start` | 下方，左缘对齐（默认那档「向右下」） |
+ * | `bottom-end`   | 下方，右缘对齐（向左下） |
+ * | `top-start`    | 上方，左缘对齐（向右上） |
+ * | `top-end`      | 上方，右缘对齐（向左上） |
+ * | `right-start`  | 按钮右侧，**顶边与按钮顶边齐平**（向右展开） |
+ * | `right-end`    | 按钮右侧，**底边与按钮底边齐平**（向右展开、底部对齐） |
+ * | `left-start`   | 按钮左侧，顶边齐平（向左展开） |
+ * | `left-end`     | 按钮左侧，底边齐平（向左展开、底部对齐） |
+ * | `auto`         | 旧行为：优先下方，下方不够翻上方，横向夹紧 |
+ *
+ * 关键口径（用户 2026-11-03 两轮拍板）：
+ *
+ * 1. 指定方位 = **优先方位**。该侧放得下就照它（按钮贴定宽区右边界时传 `bottom-end` /
+ *    `left-start`，面板不会再向右溢出）；
+ * 2. 该侧放不下、**对侧放得下 ⇒ 自动翻边**（bottom↔top、left↔right，对齐轴保持 start/end 不变）；
+ * 3. 两侧都放不下 ⇒ 仍按所给方位落位，再**夹紧进视口**（绝不溢出）。
+ */
+/** 展开方位。 */
+export type PickPlacement = 'auto' | 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'left-start' | 'left-end';
+/** 锚点矩形（`getBoundingClientRect()` 的结构子集）。 */
+export interface AnchorRect {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+}
+/** 视口尺寸（`window.innerWidth / innerHeight`）。 */
+export interface Viewport {
+    width: number;
+    height: number;
+}
+/** 面板盒子（直接喂 `position: fixed` 的四个内联值）。 */
+export interface PickerBox {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+/** 弹窗宽度（源实现 480，用户 2026-09-29 微调定值）。 */
+export declare const PICKER_WIDTH = 480;
+/** 弹窗高度上限：空间全够时默认 480×480（用户 2026-11-03 定，原 660）。 */
+export declare const PICKER_MAX_H = 480;
+/** 判定「下方放得下」的最小高度：低于它就翻到上方（仅 `auto` 用）。 */
+export declare const PICKER_MIN_H = 240;
+/** 硬地板：锚点上下都极窄时也要给出一个能滚动的高度（此时以夹紧进视口优先）。 */
+export declare const PICKER_MIN_FLOOR = 160;
+/** 左右展开时的宽度地板（可用宽度再窄也要能看清内容）。 */
+export declare const PICKER_MIN_W = 240;
+/** 面板与锚点之间的间距。 */
+export declare const PICKER_GAP = 12;
+/** 面板与视口边缘的最小留白。 */
+export declare const VIEWPORT_EDGE = 12;
+/**
+ * 算面板盒子。
+ *
+ * @param anchor 锚点矩形（按钮的 `getBoundingClientRect()`）。
+ * @param viewport 视口尺寸。
+ * @param placement 展开方位，默认 `'auto'`（= 旧行为，不破坏既有调用）。
+ * @returns 四舍五入到整数像素的 `{ left, top, width, height }`。
+ */
+export declare function placePicker(anchor: AnchorRect, viewport: Viewport, placement?: PickPlacement): PickerBox;
+//# sourceMappingURL=picker-placement.d.ts.map

package/dist/adv/explorer/picker-placement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"picker-placement.d.ts","sourceRoot":"","sources":["../../../src/adv/explorer/picker-placement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,YAAY;AACZ,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,cAAc,GAAG,YAAY,GAC7B,WAAW,GAAG,SAAS,GACvB,aAAa,GAAG,WAAW,GAC3B,YAAY,GAAG,UAAU,CAAA;AAE7B,6CAA6C;AAC7C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,+CAA+C;AAC/C,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,0CAA0C;AAC1C,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,wCAAwC;AACxC,eAAO,MAAM,YAAY,MAAM,CAAA;AAC/B,qDAAqD;AACrD,eAAO,MAAM,YAAY,MAAM,CAAA;AAC/B,2CAA2C;AAC3C,eAAO,MAAM,YAAY,MAAM,CAAA;AAC/B,4CAA4C;AAC5C,eAAO,MAAM,gBAAgB,MAAM,CAAA;AACnC,iCAAiC;AACjC,eAAO,MAAM,YAAY,MAAM,CAAA;AAC/B,kBAAkB;AAClB,eAAO,MAAM,UAAU,KAAK,CAAA;AAC5B,oBAAoB;AACpB,eAAO,MAAM,aAAa,KAAK,CAAA;AAqB/B;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,QAAQ,EAClB,SAAS,GAAE,aAAsB,GAChC,SAAS,CA6DX"}

package/dist/adv/explorer/picker-placement.js

@@ -0,0 +1,122 @@
+/**
+ * 选文件弹窗的锚定定位（**纯函数、零 DOM**）：给定锚点矩形 + 视口 + 方位，算出面板盒子。
+ *
+ * 八档方位 + `auto`（用户 2026-11-03 定，8 档就是他点的规格）：
+ *
+ * | 值 | 面板落点 |
+ * |---|---|
+ * | `bottom-start` | 下方，左缘对齐（默认那档「向右下」） |
+ * | `bottom-end`   | 下方，右缘对齐（向左下） |
+ * | `top-start`    | 上方，左缘对齐（向右上） |
+ * | `top-end`      | 上方，右缘对齐（向左上） |
+ * | `right-start`  | 按钮右侧，**顶边与按钮顶边齐平**（向右展开） |
+ * | `right-end`    | 按钮右侧，**底边与按钮底边齐平**（向右展开、底部对齐） |
+ * | `left-start`   | 按钮左侧，顶边齐平（向左展开） |
+ * | `left-end`     | 按钮左侧，底边齐平（向左展开、底部对齐） |
+ * | `auto`         | 旧行为：优先下方，下方不够翻上方，横向夹紧 |
+ *
+ * 关键口径（用户 2026-11-03 两轮拍板）：
+ *
+ * 1. 指定方位 = **优先方位**。该侧放得下就照它（按钮贴定宽区右边界时传 `bottom-end` /
+ *    `left-start`，面板不会再向右溢出）；
+ * 2. 该侧放不下、**对侧放得下 ⇒ 自动翻边**（bottom↔top、left↔right，对齐轴保持 start/end 不变）；
+ * 3. 两侧都放不下 ⇒ 仍按所给方位落位，再**夹紧进视口**（绝不溢出）。
+ */
+/** 弹窗宽度（源实现 480，用户 2026-09-29 微调定值）。 */
+export const PICKER_WIDTH = 480;
+/** 弹窗高度上限：空间全够时默认 480×480（用户 2026-11-03 定，原 660）。 */
+export const PICKER_MAX_H = 480;
+/** 判定「下方放得下」的最小高度：低于它就翻到上方（仅 `auto` 用）。 */
+export const PICKER_MIN_H = 240;
+/** 硬地板：锚点上下都极窄时也要给出一个能滚动的高度（此时以夹紧进视口优先）。 */
+export const PICKER_MIN_FLOOR = 160;
+/** 左右展开时的宽度地板（可用宽度再窄也要能看清内容）。 */
+export const PICKER_MIN_W = 240;
+/** 面板与锚点之间的间距。 */
+export const PICKER_GAP = 12;
+/** 面板与视口边缘的最小留白。 */
+export const VIEWPORT_EDGE = 12;
+function clamp(value, low, high) {
+    // high 可能小于 low（视口比面板还小时）：以 low 为准，宁可贴边也不反向。
+    return Math.min(Math.max(value, low), Math.max(low, high));
+}
+/**
+ * 决定最终落在哪一侧：优先侧够用就守，够不上但对侧更宽敞就翻过去，两边都窄就守原侧交给夹紧。
+ *
+ * @param preferred 是否落在「正方向」（下方 / 右侧）。
+ * @param own 优先那侧的可用空间。
+ * @param other 对侧的可用空间。
+ * @param min 该侧「够用」的门槛（竖向是 `PICKER_MIN_H`，横向是 `PICKER_MIN_W`）。
+ * @returns 最终是否落在正方向。
+ */
+function flipSide(preferred, own, other, min) {
+    if (own >= min)
+        return preferred;
+    return other > own ? !preferred : preferred;
+}
+/**
+ * 算面板盒子。
+ *
+ * @param anchor 锚点矩形（按钮的 `getBoundingClientRect()`）。
+ * @param viewport 视口尺寸。
+ * @param placement 展开方位，默认 `'auto'`（= 旧行为，不破坏既有调用）。
+ * @returns 四舍五入到整数像素的 `{ left, top, width, height }`。
+ */
+export function placePicker(anchor, viewport, placement = 'auto') {
+    const vw = viewport.width;
+    const vh = viewport.height;
+    const GAP = PICKER_GAP;
+    const EDGE = VIEWPORT_EDGE;
+    const fullWidth = Math.min(PICKER_WIDTH, Math.max(vw - 2 * EDGE, 0));
+    if (placement === 'auto') {
+        // 旧行为逐字保留：先量上下剩余空间决定展向，高度跟着所选那侧走，横向夹紧。
+        const availBelow = vh - EDGE - (anchor.bottom + GAP);
+        const availAbove = anchor.top - GAP - EDGE;
+        const below = flipSide(true, availBelow, availAbove, PICKER_MIN_H);
+        const height = Math.max(Math.min(PICKER_MAX_H, below ? availBelow : availAbove), PICKER_MIN_FLOOR);
+        const left = clamp(anchor.left, EDGE, vw - EDGE - fullWidth);
+        const top = below
+            ? clamp(Math.min(anchor.bottom + GAP, vh - EDGE - height), EDGE, vh - EDGE - height)
+            : clamp(anchor.top - GAP - height, EDGE, vh - EDGE - height);
+        return round({ left, top, width: fullWidth, height });
+    }
+    const vertical = placement.startsWith('bottom') || placement.startsWith('top');
+    if (vertical) {
+        const belowAvail = vh - EDGE - (anchor.bottom + GAP);
+        const aboveAvail = anchor.top - GAP - EDGE;
+        const startAligned = placement.endsWith('start');
+        // 优先方位放不下、对侧放得下 ⇒ 翻边；两侧都窄就守住原方位，交给下面的夹紧兜底。
+        const prefersBelow = placement.startsWith('bottom');
+        const below = flipSide(prefersBelow, prefersBelow ? belowAvail : aboveAvail, prefersBelow ? aboveAvail : belowAvail, PICKER_MIN_H);
+        const avail = below ? belowAvail : aboveAvail;
+        const height = Math.max(Math.min(PICKER_MAX_H, avail), PICKER_MIN_FLOOR);
+        const rawLeft = startAligned ? anchor.left : anchor.right - fullWidth;
+        const left = clamp(rawLeft, EDGE, vw - EDGE - fullWidth);
+        const rawTop = below ? anchor.bottom + GAP : anchor.top - GAP - height;
+        const top = clamp(rawTop, EDGE, vh - EDGE - height);
+        return round({ left, top, width: fullWidth, height });
+    }
+    // 左右展开：宽度跟着那一侧的实际空间走，高度取视口高度（上下各留 EDGE）。
+    const startAligned = placement.endsWith('start');
+    const rightAvail = vw - EDGE - (anchor.right + GAP);
+    const leftAvail = anchor.left - GAP - EDGE;
+    const prefersRight = placement.startsWith('right');
+    const toRight = flipSide(prefersRight, prefersRight ? rightAvail : leftAvail, prefersRight ? leftAvail : rightAvail, PICKER_MIN_W);
+    const availW = toRight ? rightAvail : leftAvail;
+    const width = Math.max(Math.min(PICKER_WIDTH, availW), Math.min(PICKER_MIN_W, Math.max(vw - 2 * EDGE, 0)));
+    const height = Math.min(PICKER_MAX_H, Math.max(vh - 2 * EDGE, 0));
+    const rawLeft = toRight ? anchor.right + GAP : anchor.left - GAP - width;
+    const left = clamp(rawLeft, EDGE, vw - EDGE - width);
+    const rawTop = startAligned ? anchor.top : anchor.bottom - height;
+    const top = clamp(rawTop, EDGE, vh - EDGE - height);
+    return round({ left, top, width, height });
+}
+function round(box) {
+    return {
+        left: Math.round(box.left),
+        top: Math.round(box.top),
+        width: Math.round(box.width),
+        height: Math.round(box.height),
+    };
+}
+//# sourceMappingURL=picker-placement.js.map

package/dist/adv/explorer/picker-placement.js.map

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

package/dist/adv/explorer/preview/BytesPreview.d.ts

@@ -0,0 +1,12 @@
+import { createElement as h } from 'react';
+import { type Translate } from '../../../utils/i18n.js';
+import type { FsFace } from '../fs-face.js';
+export interface BytesPreviewProps {
+    files: FsFace;
+    path: string;
+    kind: 'image' | 'pdf';
+    mime: string;
+    translate?: Translate;
+}
+export declare function BytesPreview(props: BytesPreviewProps): ReturnType<typeof h>;
+//# sourceMappingURL=BytesPreview.d.ts.map

package/dist/adv/explorer/preview/BytesPreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BytesPreview.d.ts","sourceRoot":"","sources":["../../../../src/adv/explorer/preview/BytesPreview.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,IAAI,CAAC,EAAuB,MAAM,OAAO,CAAA;AAC/D,OAAO,EAAK,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAE1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAI3C,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,OAAO,GAAG,KAAK,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAoD3E"}

package/dist/adv/explorer/preview/BytesPreview.js

@@ -0,0 +1,60 @@
+// 二进制预览体：图片（<img>）/ PDF（iframe 原生渲染）。
+// readBytes 读全量（受部署 maxFileBytes 封顶，超出抛 too-large ⇒ 错误态）。
+import { createElement as h, useEffect, useState } from 'react';
+import { t } from '../../../utils/i18n.js';
+import { bytesOf, errView, isAborted } from '../types.js';
+import { ensureComponentStyles } from '../../../ui/infra/css.js';
+import { EXPLORER_CSS } from '../explorer-css.js';
+export function BytesPreview(props) {
+    ensureComponentStyles('explorer', EXPLORER_CSS);
+    const tt = props.translate ?? t;
+    const [url, setUrl] = useState(null);
+    const [failed, setFailed] = useState(null);
+    useEffect(() => {
+        // 切文件 / 卸载即取消：signal 是真取消（官方 remote 声明了 cancellation 形参），
+        // 不必等它读完再丢弃；被取消的结果一律静默（不 setState、不出错误态）。
+        const controller = new AbortController();
+        let objectUrl = null;
+        setUrl(null);
+        setFailed(null);
+        props.files
+            .readBytes(props.path, {}, controller.signal)
+            .then((res) => {
+            if (controller.signal.aborted)
+                return;
+            const data = bytesOf(res);
+            if (data === null) {
+                console.warn('[dsh-plugin-core:explorer] readBytes 返回体无法解析为字节', props.path, res);
+                setFailed({ key: 'previewBadPayload' });
+                return;
+            }
+            if ('failed' in data) {
+                setFailed(errView(data.failed));
+                return;
+            }
+            // 复制一份：TS 5.9 下 Uint8Array<ArrayBufferLike> 不是合法的 BlobPart
+            const blob = new Blob([new Uint8Array(data)], { type: props.mime });
+            objectUrl = URL.createObjectURL(blob);
+            setUrl(objectUrl);
+        })
+            .catch((error) => {
+            if (isAborted(controller.signal, error))
+                return;
+            setFailed(errView(error));
+        });
+        return () => {
+            controller.abort();
+            if (objectUrl !== null)
+                URL.revokeObjectURL(objectUrl);
+        };
+    }, [props.files, props.path, props.mime]);
+    if (failed !== null)
+        return h('div', { className: 'dshpc-fb__note' }, tt(failed.key, failed.params));
+    if (url === null)
+        return h('div', { className: 'dshpc-fb__note' }, tt('explorerLoading'));
+    if (props.kind === 'image') {
+        return h('img', { className: 'dshpc-fb__image', src: url, alt: props.path });
+    }
+    return h('div', { className: 'dshpc-fb__fill' }, h('iframe', { className: 'dshpc-fb__frame', src: url, title: props.path }));
+}
+//# sourceMappingURL=BytesPreview.js.map

package/dist/adv/explorer/preview/BytesPreview.js.map

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

package/dist/adv/explorer/preview/HtmlPreview.d.ts

@@ -0,0 +1,17 @@
+import { createElement as h } from 'react';
+import { type Translate } from '../../../utils/i18n.js';
+import type { FsFace } from '../fs-face.js';
+/**
+ * 把 HTML 字节做成官方同款的静态预览文档：剔除禁用标签/属性、head 首项插 CSP。
+ * 真正的兜底是 iframe `sandbox=""`（禁脚本执行）+ CSP（禁一切外链）。
+ */
+export declare function buildStaticHtml(data: Uint8Array): string | undefined;
+export interface HtmlPreviewProps {
+    files: FsFace;
+    path: string;
+    /** true = 源码态（走 TextPreview + 256K 截断）。 */
+    sourceView: boolean;
+    translate?: Translate;
+}
+export declare function HtmlPreview(props: HtmlPreviewProps): ReturnType<typeof h>;
+//# sourceMappingURL=HtmlPreview.d.ts.map

package/dist/adv/explorer/preview/HtmlPreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HtmlPreview.d.ts","sourceRoot":"","sources":["../../../../src/adv/explorer/preview/HtmlPreview.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,IAAI,CAAC,EAAuB,MAAM,OAAO,CAAA;AAC/D,OAAO,EAAK,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAE1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAY3C;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CA6BpE;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,2CAA2C;IAC3C,UAAU,EAAE,OAAO,CAAA;IACnB,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CA2DzE"}

package/dist/adv/explorer/preview/HtmlPreview.js

@@ -0,0 +1,113 @@
+// HTML 静态预览：官方同款安全处理（禁标签 / 禁属性 / CSP + sandbox=""）后 iframe 渲染；
+// 源码态走 TextPreview 并按 256K 截断。降级路径（无 DOM 能力时）直接出错误态，不猜。
+import { createElement as h, useEffect, useState } from 'react';
+import { t } from '../../../utils/i18n.js';
+import { bytesOf, errView, isAborted, SOURCE_MAX_BYTES } from '../types.js';
+import { TextPreview } from './TextPreview.js';
+import { ensureComponentStyles } from '../../../ui/infra/css.js';
+import { EXPLORER_CSS } from '../explorer-css.js';
+/** 官方 CSP 原文（documentpreview lib/client.js 同款，不多开不少关）。 */
+const HTML_CSP = "default-src 'none'; script-src 'none'; style-src 'unsafe-inline'; img-src data:; font-src data:; media-src data:";
+/** 禁用标签（官方清单）。 */
+const HTML_FORBID_TAGS = ['noscript', 'base', 'link', 'meta', 'iframe', 'frame', 'object', 'embed', 'set', 'animate', 'animatemotion', 'animatetransform'];
+/** 禁用属性（官方清单）。 */
+const HTML_FORBID_ATTRS = ['href', 'xlink:href'];
+/**
+ * 把 HTML 字节做成官方同款的静态预览文档：剔除禁用标签/属性、head 首项插 CSP。
+ * 真正的兜底是 iframe `sandbox=""`（禁脚本执行）+ CSP（禁一切外链）。
+ */
+export function buildStaticHtml(data) {
+    if (typeof DOMParser === 'undefined')
+        return undefined;
+    let source;
+    try {
+        source = new TextDecoder('utf-8', { fatal: false }).decode(data);
+    }
+    catch {
+        return undefined;
+    }
+    let doc;
+    try {
+        doc = new DOMParser().parseFromString(source, 'text/html');
+    }
+    catch {
+        return undefined;
+    }
+    for (const tag of HTML_FORBID_TAGS) {
+        for (const el of Array.from(doc.querySelectorAll(tag)))
+            el.remove();
+    }
+    // ⚠️ 禁用属性只能「遍历元素逐个 removeAttribute」，不能拼 `[${attr}]` 选择器：
+    // `xlink:href` 带命名空间冒号，不是合法 CSS 选择器 —— querySelectorAll 会直接抛
+    // SyntaxError（真机 2026-10-22：源码能读出来、预览区却报「加载失败」，就是它）。
+    for (const el of Array.from(doc.querySelectorAll('*'))) {
+        for (const attr of HTML_FORBID_ATTRS)
+            el.removeAttribute(attr);
+    }
+    const csp = doc.createElement('meta');
+    csp.setAttribute('http-equiv', 'Content-Security-Policy');
+    csp.setAttribute('content', HTML_CSP);
+    const head = doc.head ?? doc.documentElement;
+    head.insertBefore(csp, head.firstChild);
+    return `<!DOCTYPE html>\n${doc.documentElement.outerHTML}`;
+}
+export function HtmlPreview(props) {
+    ensureComponentStyles('explorer', EXPLORER_CSS);
+    const tt = props.translate ?? t;
+    const [doc, setDoc] = useState(null);
+    const [failed, setFailed] = useState(null);
+    useEffect(() => {
+        if (props.sourceView)
+            return;
+        const controller = new AbortController();
+        setDoc(null);
+        setFailed(null);
+        props.files
+            .readBytes(props.path, {}, controller.signal)
+            .then((res) => {
+            if (controller.signal.aborted)
+                return;
+            const data = bytesOf(res);
+            if (data === null) {
+                // 形状不对要说「返回数据不符合预期」，不能混进「加载失败」——混了就永远查不出是谁的锅。
+                console.warn('[dsh-plugin-core:explorer] readBytes 返回体无法解析为字节', props.path, res);
+                setFailed({ key: 'previewBadPayload' });
+                return;
+            }
+            if ('failed' in data) {
+                setFailed(errView(data.failed));
+                return;
+            }
+            const html = buildStaticHtml(data);
+            if (html === undefined) {
+                setFailed({ key: 'previewRenderFailed' });
+                return;
+            }
+            setDoc(html);
+        })
+            .catch((error) => {
+            if (isAborted(controller.signal, error))
+                return;
+            setFailed(errView(error));
+        });
+        return () => {
+            controller.abort();
+        };
+    }, [props.files, props.path, props.sourceView]);
+    if (props.sourceView) {
+        return h(TextPreview, {
+            files: props.files,
+            path: props.path,
+            markdown: false,
+            sourceView: true,
+            maxBytes: SOURCE_MAX_BYTES,
+            translate: tt,
+        });
+    }
+    if (failed !== null)
+        return h('div', { className: 'dshpc-fb__note' }, tt(failed.key, failed.params));
+    if (doc === null)
+        return h('div', { className: 'dshpc-fb__note' }, tt('explorerLoading'));
+    return h('div', { className: 'dshpc-fb__fill' }, h('iframe', { className: 'dshpc-fb__frame', sandbox: '', srcDoc: doc, title: props.path }));
+}
+//# sourceMappingURL=HtmlPreview.js.map

package/dist/adv/explorer/preview/HtmlPreview.js.map

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

package/dist/adv/explorer/preview/OfficePreview.d.ts

@@ -0,0 +1,12 @@
+import { createElement as h } from 'react';
+import { type Translate } from '../../../utils/i18n.js';
+import { type OfficeToPdfFace } from '../types.js';
+export interface OfficePreviewProps {
+    officeToPdf: OfficeToPdfFace | null;
+    /** 会话可省：缺省按宿主工作区快照挑「最近有会话」那条（授权探针只要求一条有效会话）。 */
+    sessionId?: string;
+    path: string;
+    translate?: Translate;
+}
+export declare function OfficePreview(props: OfficePreviewProps): ReturnType<typeof h>;
+//# sourceMappingURL=OfficePreview.d.ts.map

package/dist/adv/explorer/preview/OfficePreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OfficePreview.d.ts","sourceRoot":"","sources":["../../../../src/adv/explorer/preview/OfficePreview.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,IAAI,CAAC,EAAuB,MAAM,OAAO,CAAA;AAC/D,OAAO,EAAK,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAoD,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AAKpG,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,eAAe,GAAG,IAAI,CAAA;IACnC,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAiD7E"}

package/dist/adv/explorer/preview/OfficePreview.js

@@ -0,0 +1,63 @@
+// Office 预览体：宿主 remote.officeToPdf 转 PDF ⇒ iframe 渲染。
+// officeToPdf 未注入（宿主没装 dsh-office-to-pdf）⇒ 「预览不可用」空态，不发起请求、不崩。
+import { createElement as h, useEffect, useState } from 'react';
+import { t } from '../../../utils/i18n.js';
+import { bytesOf, errView, isAborted, pickWorkspaceAnchor } from '../types.js';
+import { workspaceList } from '../../../ui/infra/host-data.js';
+import { ensureComponentStyles } from '../../../ui/infra/css.js';
+import { EXPLORER_CSS } from '../explorer-css.js';
+export function OfficePreview(props) {
+    ensureComponentStyles('explorer', EXPLORER_CSS);
+    const tt = props.translate ?? t;
+    const [url, setUrl] = useState(null);
+    const [failed, setFailed] = useState(null);
+    useEffect(() => {
+        const controller = new AbortController();
+        let objectUrl = null;
+        setUrl(null);
+        setFailed(null);
+        const face = props.officeToPdf;
+        if (face === null)
+            return;
+        // 懒取会话：浏览本身不吃会话，只有这一种格式要（授权探针要一条有效会话，不要求文件在工作区内）。
+        const sessionId = props.sessionId ?? pickWorkspaceAnchor(workspaceList.getSnapshot())?.sessionId;
+        if (sessionId === undefined || sessionId === '') {
+            setFailed({ key: 'previewOfficeNoSession' });
+            return;
+        }
+        // 转换慢也不能让它挡路：切文件即 abort（官方实现按「最后一个读者取消」释放共享转换）。
+        face
+            .render(sessionId, props.path, 'foreground', controller.signal)
+            .then((res) => {
+            if (controller.signal.aborted)
+                return;
+            const data = bytesOf(res);
+            if (data === null || 'failed' in data) {
+                setFailed(errView(data === null ? undefined : data.failed));
+                return;
+            }
+            const blob = new Blob([new Uint8Array(data)], { type: 'application/pdf' });
+            objectUrl = URL.createObjectURL(blob);
+            setUrl(objectUrl);
+        })
+            .catch((error) => {
+            if (isAborted(controller.signal, error))
+                return;
+            setFailed(errView(error));
+        });
+        return () => {
+            controller.abort();
+            if (objectUrl !== null)
+                URL.revokeObjectURL(objectUrl);
+        };
+    }, [props.officeToPdf, props.sessionId, props.path]);
+    if (props.officeToPdf === null) {
+        return h('div', { className: 'dshpc-fb__note' }, tt('previewOfficeUnavailable'));
+    }
+    if (failed !== null)
+        return h('div', { className: 'dshpc-fb__note' }, tt(failed.key, failed.params));
+    if (url === null)
+        return h('div', { className: 'dshpc-fb__note' }, tt('explorerLoading'));
+    return h('iframe', { className: 'dshpc-fb__frame', src: url, title: props.path });
+}
+//# sourceMappingURL=OfficePreview.js.map

package/dist/adv/explorer/preview/OfficePreview.js.map

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

package/dist/adv/explorer/preview/TextPreview.d.ts

@@ -0,0 +1,18 @@
+import { createElement as h } from 'react';
+import { type Translate } from '../../../utils/i18n.js';
+import type { FsFace } from '../fs-face.js';
+export interface TextPreviewProps {
+    files: FsFace;
+    path: string;
+    /** 是否 md（决定默认渲染态）。 */
+    markdown: boolean;
+    /** true = 源码态（md/html 由面板工具条切换）。 */
+    sourceView: boolean;
+    /** 字节上限：超出即截断 + 横幅，且不出「加载更多」（HTML 源码态用）。 */
+    maxBytes?: number;
+    /** 打开即定位到这一行（1 起）：首屏没读到就自动续翻，最多 {@link FOCUS_MAX_PAGES} 页。 */
+    focusLine?: number;
+    translate?: Translate;
+}
+export declare function TextPreview(props: TextPreviewProps): ReturnType<typeof h>;
+//# sourceMappingURL=TextPreview.d.ts.map

package/dist/adv/explorer/preview/TextPreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextPreview.d.ts","sourceRoot":"","sources":["../../../../src/adv/explorer/preview/TextPreview.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,aAAa,IAAI,CAAC,EAA4C,MAAM,OAAO,CAAA;AAIpF,OAAO,EAAK,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAE1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAM3C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,sBAAsB;IACtB,QAAQ,EAAE,OAAO,CAAA;IACjB,oCAAoC;IACpC,UAAU,EAAE,OAAO,CAAA;IACnB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAKD,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CA8GzE"}