openxiangda 1.0.152 → 1.0.154

package/README.md

@@ -299,7 +299,19 @@ const file = await api.uploadPublicFile(imageFile, "public-assets")
 
 图片字段和附件字段支持浏览器端压缩图。对用户上传的大图，可以在 `ImageField` 或 `AttachmentField` 上启用 `imageCompression`，运行时会保留原图 `url`，并额外上传缩略图和预览图，保存到 `thumbUrl`、`previewUrl` 和 `variants`。非图片、GIF、SVG、小于阈值的图片，以及浏览器不支持 canvas 压缩时会自动退回原上传流程。
 
-图片和附件预览由运行时统一处理：图片点击后进入同组弹窗画廊，视频、音频和文档在站内弹窗中打开；`AttachmentField` 只在平台 capability API 确认可预览时展示预览动作。默认覆盖 PDF、常见媒体、文本、DOCX 和 XLSX，更多 DOC/XLS/PPT、ODF 格式由部署侧 ONLYOFFICE 配置决定。自定义页需要可分享的预览链接时，通过 PageSdk `sdk.createFileAccessTicket(..., "preview", { appType })` 获取并打开 `previewPageUrl`，不要直接打开文件内容流 `previewUrl`。
+图片和附件预览由运行时统一处理：图片点击后进入同组弹窗画廊，视频、音频和文档在站内弹窗中打开；预览动作只在平台 capability API 返回 `canPreview: true` 时展示。表单上下文继续使用 `ImageField` 和 `AttachmentField`；自定义 React SPA 页面展示任意业务数据里的文件时，直接使用 `ImagePreviewGrid`、`AttachmentPreviewList`，或用 `useFilePreview` 接入自定义卡片和表格。不要为只读附件伪造 `FormProvider`，也不要自行维护扩展名白名单。
+
+```tsx
+import {
+  AttachmentPreviewList,
+  ImagePreviewGrid,
+} from "openxiangda/runtime/react"
+
+<AttachmentPreviewList items={record.attachments || []} />
+<ImagePreviewGrid items={record.photos || []} />
+```
+
+这些独立 API 必须在模板默认提供的 `OpenXiangdaProvider` 和 `OpenXiangdaPageProvider` 内使用。它们会从 PageSdk 获取当前 `appType`，并统一处理 preview ticket、metadata 和二进制文件响应。默认覆盖 PDF、常见媒体、文本、DOCX 和 XLSX，更多 DOC/XLS/PPT、ODF 格式由部署侧 ONLYOFFICE 配置决定。只有在需要复制、分享或新窗口打开预览页时，才通过 PageSdk `sdk.createFileAccessTicket(..., "preview", { appType })` 获取并打开 `previewPageUrl`；不要直接打开文件内容流 `previewUrl`。
 
 ```tsx
 import { ImageField } from "openxiangda"

package/openxiangda-skills/SKILL.md

@@ -58,7 +58,7 @@ OpenXiangda supports two workspace modes. Classic `sy-lowcode-app-workspace` pub
 - ✅ For form-entry UX, pick components in this order: OpenXiangda platform form components → `antd` / `antd-mobile` wrappers → custom component only when neither exists.
 - ✅ In React SPA apps, keep imports on public package entrypoints such as `openxiangda`, `openxiangda/runtime`, and `openxiangda/runtime/react`. The default template already groups large vendor chunks; if a bundle is too large, use route-level lazy loading and Vite `manualChunks`, not `openxiangda/packages/sdk/dist/...` internal paths.
 - ✅ For image thumbnails or lightweight previews, use `imageCompression` on `ImageField` or `AttachmentField`. Keep the original `url` for the source file and use `thumbUrl` / `previewUrl` / `variants` for smaller images.
-- ✅ Let `ImageField` and `AttachmentField` own preview UX and capability checks. Images use an in-page gallery; media and documents use an in-page dialog; `AttachmentField` only shows preview after the platform returns `canPreview: true`. Do not maintain app-local extension allowlists.
+- ✅ In form context, let `ImageField` and `AttachmentField` own preview UX. In standalone React SPA pages, use `AttachmentPreviewList`, `ImagePreviewGrid`, or `useFilePreview` from `openxiangda/runtime/react`; do not create a fake form context or import internal `FilePreviewContent` / `useFilePreviewController`. All paths must honor platform capability checks, and apps must not maintain local previewable-extension allowlists.
 - ✅ For data delivery with files, use `openxiangda form export <formCode> --mode xlsx|xlsx-images|package --profile <name>`. `package` writes a zip with `data.xlsx`, `attachments/`, and `manifest.json`; do not hand-write export URLs or stream binary content to stdout.
 - ✅ List pages, linked options, remote selectors, and report drill-downs must use paginated server-side queries with explicit searchable fields. Do not fetch a large page and filter in local state.
 - ✅ Treat workflow forms as an exception. Ordinary ticket/order/task/asset lifecycles use status fields, state machines, action logs, permissions, and automations; workflows are for real approval tasks.

package/openxiangda-skills/references/component-guide.md

@@ -87,7 +87,16 @@ OSS 浏览器直传所需的 CORS 规则在 `src/resources/storage/<code>.json`
 
 `AttachmentField` 和 `ImageField` 都可设置 `imageCompression`。启用后只压缩图片文件，保存值会额外包含 `thumbUrl`、`previewUrl` 和 `variants`，用于列表缩略图、小图预览或详情页轻量展示；原图 `url` 仍保留用于下载和高清预览。
 
-预览能力也由组件统一接管：`ImageField` 点击图片后打开同组弹窗画廊；`AttachmentField` 先调用平台 capability API，只为 `canPreview: true` 的文件显示预览动作，并在站内弹窗中打开视频、音频、PDF、DOCX、XLSX、文本等内容。不要在应用代码中维护扩展名白名单，也不要把文件流 URL 当成页面入口。DOC/XLS/PPT、ODF 等格式是否可预览由部署侧 ONLYOFFICE 配置决定。
+预览能力也由运行时统一接管：表单上下文使用 `ImageField` / `AttachmentField`；自定义 React SPA 页面展示任意业务数据中的只读附件时，从 `openxiangda/runtime/react` 使用 `ImagePreviewGrid` / `AttachmentPreviewList`，或使用 `useFilePreview({ items })` 接入自定义卡片、表格和详情操作。不要为只读附件伪造 `FormProvider`。
+
+```tsx
+import { AttachmentPreviewList, ImagePreviewGrid } from "openxiangda/runtime/react"
+
+<AttachmentPreviewList items={record.attachments || []} />
+<ImagePreviewGrid items={record.photos || []} />
+```
+
+这些 API 先调用平台 capability，只为 `canPreview: true` 的文件显示或执行预览，并在站内弹窗中打开图片画廊、视频、音频、PDF、DOCX、XLSX、文本等内容。不要在应用代码中维护扩展名白名单，不要直接引用内部 `FilePreviewContent` / `useFilePreviewController`，也不要把文件流 URL 当成页面入口。DOC/XLS/PPT、ODF 等格式是否可预览由部署侧 ONLYOFFICE 配置决定。
 
 声明式 OSS 文件需要 bucket CORS 允许应用域名读取对象，浏览器端 DOCX/XLSX/HEIC 解析才能工作；平台私有附件由 ticket 文件流处理，不直接暴露对象地址。
 

package/openxiangda-skills/references/pages/page-sdk.md

@@ -16,7 +16,7 @@ Guidelines:
 - Use `sdk.function.invoke(code, { input })` for reusable backend business logic declared under `src/resources/functions/` and `src/functions/`. Do not implement multi-form orchestration, connector fan-out, notification orchestration, or permission-sensitive backend rules directly in a page component.
 - Use `sdk.connector.invoke`, `sdk.connector.call("connector.api")`, or `sdk.connector.download` for external services. The SDK calls the platform runtime connector endpoint; it must not call third-party domains directly.
 - Use `sdk.notification.sendByType` and `batchSendByType` for reusable business messages. Custom notification types must be declared in `src/resources/notifications/` and published with `openxiangda resource publish`.
-- Use `sdk.createFileAccessTicket(bucketName, objectName, fileName, "preview", { appType })` when a custom React SPA page needs a user-openable attachment preview link. `appType` defaults to the current page context. Open `response.result.previewPageUrl`; do not use `previewUrl` or `/service/file/preview-by-ticket/:ticket` as the page entry.
+- Use `AttachmentPreviewList`, `ImagePreviewGrid`, or `useFilePreview` from `openxiangda/runtime/react` for in-page attachment previews in a custom React SPA page. They use the current PageSdk context and enforce the platform capability and ticket contracts. Use `sdk.createFileAccessTicket(bucketName, objectName, fileName, "preview", { appType })` only when the page needs a shareable or new-window preview link. `appType` defaults to the current page context. Open `response.result.previewPageUrl`; do not use `previewUrl` or `/service/file/preview-by-ticket/:ticket` as the page entry.
 - Use `sdk.organization.departments.*` and `sdk.organization.accounts.*` only for admin-style app pages that intentionally manage platform departments/accounts. The current user needs `app:organization:manage` on the app. Do not call legacy `/user` or `/department` write endpoints from pages.
 - Use `sdk.workCenter.listItems({ boxType })` and `sdk.workCenter.getStats()` for current-user work center lists and counts. `boxType` is one of `todo`, `done`, `cc`, or `initiated`. This is the end-user task/handled/cc/initiated surface; do not build todo pages by reading workflow operation logs, automation logs, or raw process-task tables.
 - `sdk.form.create` returns identifiers and generated serial number values only. Treat `formInstId` / `formInstanceId` as the required success contract; `serialNumber` / `serialNumbers` are present only when the form has `SerialNumberField`. Do not expect the save response to contain the full row, formula results, or other server-generated field values. Call `sdk.form.getDetail` explicitly after create when those values are needed.
@@ -101,7 +101,40 @@ const response = await sdk.dataSource.run("tickets", {
 
 Data view filters, having, and fields use output aliases such as `customerName` or `ticketCount`, not source references such as `customer.name`. For option-like fields, prefer scalar aliases such as `statusValue` in the view definition and page filters. If the page only needs one form, prefer `sdk.form.advancedSearch`. If the page only needs a simple one-form dropdown, prefer linkedForm options.
 
-File preview ticket:
+Standalone in-page file preview:
+
+```tsx
+import { EyeOutlined } from "@ant-design/icons"
+import { Button } from "antd"
+import {
+  AttachmentPreviewList,
+  ImagePreviewGrid,
+  useFilePreview,
+} from "openxiangda/runtime/react"
+
+export function RecordFiles({ record }) {
+  const files = record.attachments || []
+  const preview = useFilePreview({ items: files })
+  const primary = files[0]
+
+  return (
+    <>
+      <AttachmentPreviewList items={files} />
+      <ImagePreviewGrid items={record.photos || []} />
+      {primary && preview.canPreview(primary) ? (
+        <Button icon={<EyeOutlined />} onClick={() => void preview.open(primary)}>
+          Preview primary file
+        </Button>
+      ) : null}
+      {preview.host}
+    </>
+  )
+}
+```
+
+These APIs must render below `OpenXiangdaProvider` and `OpenXiangdaPageProvider`. `useFilePreview` returns `canPreview`, `getCapability`, `open`, `download`, `isOpening`, and `host`. Render `host` once in the component tree. Do not import the internal `FilePreviewContent` or `useFilePreviewController`, create a fake `FormProvider`, or keep a local previewable-extension list.
+
+Shareable file preview ticket:
 
 ```ts
 const ticketResponse = await sdk.createFileAccessTicket(

package/openxiangda-skills/references/troubleshooting.md

@@ -14,12 +14,25 @@
 | 6 | Tailwind 样式被清除（PurgeCSS） | 生产构建后样式丢失 |
 | 7 | React 多实例冲突 | `Invalid hook call` |
 | 8 | 移动端 antd-mobile 组件样式不生效 | 组件渲染但无样式 |
-| 9 | 数据格式理解错误导致展示异常 | 页面显示 `[object Object]` |
-| 10 | workspace publish 环境变量缺失 | `OPENXIANGDA_ACCESS_TOKEN is not set` |
+| 9 | 数据格式理解错误导致展示异常 | 页面显示 `[object Object]` |
+| 10 | workspace publish 环境变量缺失 | `OPENXIANGDA_ACCESS_TOKEN is not set` |
+| 11 | DOCX 响应是 Base64 文本 | 文件流以 `UEsDB` 开头，`docx-preview` 无法解包 |
 
----
-
-## 问题：antd/antd-mobile 弹层样式丢失
+---
+
+## 问题：DOCX 响应是 Base64 文本
+
+**症状**：ticket metadata 正常返回 `renderMode: "docx-html"` 和 `canPreview: true`，`/service/file/preview-by-ticket/:ticket` 也是 HTTP 200，但响应内容以 `UEsDB` 开头，Word 预览仍然解析失败。
+
+**根因**：DOCX 本质是 ZIP。原始二进制应以 `PK`（十六进制 `50 4B 03 04`）开头；`UEsDB` 是这个 ZIP 内容再次经过 Base64 编码后的文本，不能直接交给 `docx-preview`。这不是 MIME、ticket 或 ONLYOFFICE 配置问题。
+
+**解决方案**：升级平台服务端和 OpenXiangda SDK 到包含 Base64 Office 兼容解码的版本。服务端会对历史 Base64 DOCX 对象做严格 ZIP 魔数校验后恢复原始二进制，并按解码后的长度返回 Range；SDK 对旧服务端和直连文件流保留同样的浏览器端兜底。不要在业务页面自行调用 `atob` 或复制一套文件类型判断。
+
+**验证方式**：修复后的响应字节应以 `PK` 开头，`Content-Length` 应是解码后的二进制长度。若下载后的 DOCX 仍以可见文本 `UEsDB` 开头，说明服务端尚未升级或请求仍命中了旧节点。
+
+---
+
+## 问题：antd/antd-mobile 弹层样式丢失
 
 **症状**：Select / Dropdown / Popup / Modal 等组件的弹出层没有样式，直接跑到屏幕外，或呈现为无样式的裸 HTML。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda",
-  "version": "1.0.152",
+  "version": "1.0.154",
   "description": "OpenXiangda CLI, workspace build tools, runtime SDK, and form components.",
   "private": false,
   "bin": {

package/packages/sdk/dist/{ProcessPreview-B_HqjU7v.d.mts → ProcessPreview-DMkzccq4.d.mts}

@@ -1188,6 +1188,60 @@ interface StatusMeta {
     tone: 'brand' | 'success' | 'danger' | 'neutral' | 'warning';
 }
 
+type FilePreviewType = 'image' | 'video' | 'audio' | 'pdf' | 'spreadsheet' | 'text' | 'office' | 'download';
+type FilePreviewRenderMode = 'inline' | 'image-transcode' | 'image-heic' | 'pdfjs' | 'excel-basic' | 'excel-client' | 'text' | 'text-client' | 'docx-html' | 'onlyoffice' | 'office-text' | 'download';
+type FilePreviewSurface = 'media' | 'document' | 'download';
+type FilePreviewProvider = 'browser' | 'platform' | 'onlyoffice' | 'none';
+interface FilePreviewCapability {
+    key?: string;
+    extension?: string;
+    previewType?: FilePreviewType;
+    renderMode?: FilePreviewRenderMode;
+    previewSurface?: FilePreviewSurface;
+    previewProvider?: FilePreviewProvider;
+    canPreview?: boolean;
+    canDownload?: boolean;
+    unsupportedReason?: string;
+}
+interface FilePreviewMetadata extends FilePreviewCapability {
+    capabilityVersion?: number;
+    ticket?: string;
+    appType?: string;
+    fileName?: string;
+    bucketName?: string;
+    objectName?: string;
+    size?: number;
+    contentType?: string;
+    downloadUrl?: string;
+    previewUrl?: string;
+    previewPageUrl?: string;
+    metadataUrl?: string;
+    imagePreviewUrl?: string;
+    excelPreviewUrl?: string;
+    textPreviewUrl?: string;
+    officeTextPreviewUrl?: string;
+    onlyofficeConfigUrl?: string;
+    onlyofficeEnabled?: boolean;
+    expiresIn?: number;
+}
+interface PreparedFilePreview {
+    item: AttachmentItem;
+    metadata: FilePreviewMetadata;
+    direct: boolean;
+}
+type FilePreviewRequest = FormRuntimeApi['request'];
+interface FilePreviewCapabilityBatch {
+    capabilityVersion?: number;
+    onlyofficeEnabled?: boolean;
+    items?: FilePreviewCapability[];
+}
+interface PreviewImageItem {
+    key: string;
+    src: string;
+    name: string;
+    revokeOnClose?: boolean;
+}
+
 interface ApprovalTimelineProps {
     tasks: ProcessTask[];
     className?: string;
@@ -1207,4 +1261,4 @@ interface ProcessPreviewProps {
 }
 declare const ProcessPreview: React__default.FC<ProcessPreviewProps>;
 
-export { type FormInstanceData as $, type AddressFieldProps as A, type BaseFieldProps as B, type CascadeDateFieldProps as C, type DataFilter as D, type DepartmentSearchParams as E, type DepartmentSearchResult as F, type DepartmentSearchScope as G, type DepartmentSelectFieldProps as H, type DepartmentTreeNode as I, type DigitalSignatureFieldProps as J, type DigitalSignatureValue as K, type EditorChoiceOption as L, type EditorFieldProps as M, type EditorToolbarAction as N, type FieldBehavior as O, type FieldDefinition as P, type FieldLayoutNode as Q, type FieldValueSyncConfig as R, type FormAppearanceConfig as S, type FormDataDeleteParams as T, type FormDataQueryParams as U, type FormEffect as V, type FormEffectAction as W, type FormEffectCondition as X, type FormEffectConditionOperator as Y, type FormEngineConfig as Z, type FormEngineMode as _, type AddressValue as a, type StandardFormPageMode as a$, type FormLayoutNode as a0, type FormRuntimeApi as a1, type FormRuntimeApiConfig as a2, type FormRuntimeConfig as a3, type FormSchema as a4, FormSection as a5, type FormSectionProps as a6, type FormSubmitBehavior as a7, type FormTemplateConfig as a8, type GridLayoutCell as a9, type ProcessAction as aA, type ProcessBasicInfo as aB, type ProcessDefinition as aC, type ProcessNodeType as aD, ProcessPreview as aE, type ProcessPreviewProps as aF, type ProcessRoute as aG, type ProcessStatus as aH, type ProcessTask as aI, type RadioFieldProps as aJ, type ResubmitParams as aK, type ReturnParams as aL, type ReturnPolicy as aM, type ReturnableNode as aN, type ReturnableNodeResult as aO, type RuntimeAuthHeadersProvider as aP, type RuntimeDataQueryParams as aQ, type RuntimeDataQueryResult as aR, type RuntimeRequestConfig as aS, type RuntimeResponse as aT, type RuntimeUploadOptions as aU, type RuntimeUploadProvider as aV, type SaveTaskParams as aW, type SectionLayoutNode as aX, type SelectFieldProps as aY, type SerialNumberFieldProps as aZ, type SignaturePoint as a_, type GridLayoutNode as aa, type ImageCompressionConfig as ab, type ImageCompressionVariantConfig as ac, type ImageFieldProps as ad, type ImageVariant as ae, type InitiatorSelectCandidate as af, type InitiatorSelectRequirement as ag, type InitiatorSelectScope as ah, type InitiatorSelectedApprovers as ai, type JSONFieldProps as aj, type LayoutVisibleWhen as ak, type LinkedFormOptionConfig as al, type LocationFieldProps as am, type LocationValue as an, type LowcodePageMeta as ao, type LowcodePageNode as ap, type LowcodePageNodeType as aq, type LowcodePageSchema as ar, type MultiSelectFieldProps as as, type NumberFieldProps as at, type OptionItem as au, type OptionSourceConfig as av, type OptionSourceType as aw, type PeopleShortcutConfig as ax, type PeopleShortcutType as ay, type PreviewParams as az, type ApprovalActionType as b, type StatusMeta as b0, type StepLayoutItem as b1, type StepsLayoutNode as b2, type SubFormColumn as b3, type SubFormFieldProps as b4, type TabLayoutItem as b5, type TabsLayoutNode as b6, type TaskStatus as b7, type TextAreaFieldProps as b8, type TextFieldProps as b9, type TextShortcutConfig as ba, type TextShortcutType as bb, type TransferParams as bc, type UserDisplayFormat as bd, type UserItem as be, type UserSelectFieldProps as bf, type ValidationPreset as bg, type ValidationRule as bh, type ViewPermissionQueryParams as bi, type ViewPermissionSummary as bj, type WithdrawParams as bk, type ApprovalPermission as c, ApprovalTimeline as d, type ApprovalTimelineProps as e, type ApproveParams as f, type AssociationFormConfig as g, type AssociationFormFieldProps as h, type AssociationValue as i, type AttachmentFieldProps as j, type AttachmentImageVariants as k, type AttachmentItem as l, type BaseLayoutNode as m, type CascadeSelectFieldProps as n, type ChangeRecord as o, type ChangeRecordListResponse as p, type ChangeRecordQueryParams as q, type CheckboxFieldProps as r, type DataLinkageCondition as s, type DataLinkageConfig as t, type DateFieldProps as u, type DateRangeRestriction as v, type DateRestrictionConfig as w, type DateShortcutConfig as x, type DateShortcutType as y, type DefaultValueLinkageConfig as z };
+export { type FormDataDeleteParams as $, type AddressFieldProps as A, type BaseFieldProps as B, type CascadeDateFieldProps as C, type DataFilter as D, type DepartmentSearchParams as E, type DepartmentSearchResult as F, type DepartmentSearchScope as G, type DepartmentSelectFieldProps as H, type DepartmentTreeNode as I, type DigitalSignatureFieldProps as J, type DigitalSignatureValue as K, type EditorChoiceOption as L, type EditorFieldProps as M, type EditorToolbarAction as N, type FieldBehavior as O, type FieldDefinition as P, type FieldLayoutNode as Q, type FieldValueSyncConfig as R, type FilePreviewCapability as S, type FilePreviewCapabilityBatch as T, type FilePreviewMetadata as U, type FilePreviewProvider as V, type FilePreviewRenderMode as W, type FilePreviewRequest as X, type FilePreviewSurface as Y, type FilePreviewType as Z, type FormAppearanceConfig as _, type AddressValue as a, type RuntimeDataQueryResult as a$, type FormDataQueryParams as a0, type FormEffect as a1, type FormEffectAction as a2, type FormEffectCondition as a3, type FormEffectConditionOperator as a4, type FormEngineConfig as a5, type FormEngineMode as a6, type FormInstanceData as a7, type FormLayoutNode as a8, type FormRuntimeApi as a9, type MultiSelectFieldProps as aA, type NumberFieldProps as aB, type OptionItem as aC, type OptionSourceConfig as aD, type OptionSourceType as aE, type PeopleShortcutConfig as aF, type PeopleShortcutType as aG, type PreparedFilePreview as aH, type PreviewImageItem as aI, type PreviewParams as aJ, type ProcessAction as aK, type ProcessBasicInfo as aL, type ProcessDefinition as aM, type ProcessNodeType as aN, ProcessPreview as aO, type ProcessPreviewProps as aP, type ProcessRoute as aQ, type ProcessStatus as aR, type ProcessTask as aS, type RadioFieldProps as aT, type ResubmitParams as aU, type ReturnParams as aV, type ReturnPolicy as aW, type ReturnableNode as aX, type ReturnableNodeResult as aY, type RuntimeAuthHeadersProvider as aZ, type RuntimeDataQueryParams as a_, type FormRuntimeApiConfig as aa, type FormRuntimeConfig as ab, type FormSchema as ac, FormSection as ad, type FormSectionProps as ae, type FormSubmitBehavior as af, type FormTemplateConfig as ag, type GridLayoutCell as ah, type GridLayoutNode as ai, type ImageCompressionConfig as aj, type ImageCompressionVariantConfig as ak, type ImageFieldProps as al, type ImageVariant as am, type InitiatorSelectCandidate as an, type InitiatorSelectRequirement as ao, type InitiatorSelectScope as ap, type InitiatorSelectedApprovers as aq, type JSONFieldProps as ar, type LayoutVisibleWhen as as, type LinkedFormOptionConfig as at, type LocationFieldProps as au, type LocationValue as av, type LowcodePageMeta as aw, type LowcodePageNode as ax, type LowcodePageNodeType as ay, type LowcodePageSchema as az, type ApprovalActionType as b, type RuntimeRequestConfig as b0, type RuntimeResponse as b1, type RuntimeUploadOptions as b2, type RuntimeUploadProvider as b3, type SaveTaskParams as b4, type SectionLayoutNode as b5, type SelectFieldProps as b6, type SerialNumberFieldProps as b7, type SignaturePoint as b8, type StandardFormPageMode as b9, type StatusMeta as ba, type StepLayoutItem as bb, type StepsLayoutNode as bc, type SubFormColumn as bd, type SubFormFieldProps as be, type TabLayoutItem as bf, type TabsLayoutNode as bg, type TaskStatus as bh, type TextAreaFieldProps as bi, type TextFieldProps as bj, type TextShortcutConfig as bk, type TextShortcutType as bl, type TransferParams as bm, type UserDisplayFormat as bn, type UserItem as bo, type UserSelectFieldProps as bp, type ValidationPreset as bq, type ValidationRule as br, type ViewPermissionQueryParams as bs, type ViewPermissionSummary as bt, type WithdrawParams as bu, type ApprovalPermission as c, ApprovalTimeline as d, type ApprovalTimelineProps as e, type ApproveParams as f, type AssociationFormConfig as g, type AssociationFormFieldProps as h, type AssociationValue as i, type AttachmentFieldProps as j, type AttachmentImageVariants as k, type AttachmentItem as l, type BaseLayoutNode as m, type CascadeSelectFieldProps as n, type ChangeRecord as o, type ChangeRecordListResponse as p, type ChangeRecordQueryParams as q, type CheckboxFieldProps as r, type DataLinkageCondition as s, type DataLinkageConfig as t, type DateFieldProps as u, type DateRangeRestriction as v, type DateRestrictionConfig as w, type DateShortcutConfig as x, type DateShortcutType as y, type DefaultValueLinkageConfig as z };

package/packages/sdk/dist/{ProcessPreview-B_HqjU7v.d.ts → ProcessPreview-DMkzccq4.d.ts}

@@ -1188,6 +1188,60 @@ interface StatusMeta {
     tone: 'brand' | 'success' | 'danger' | 'neutral' | 'warning';
 }
 
+type FilePreviewType = 'image' | 'video' | 'audio' | 'pdf' | 'spreadsheet' | 'text' | 'office' | 'download';
+type FilePreviewRenderMode = 'inline' | 'image-transcode' | 'image-heic' | 'pdfjs' | 'excel-basic' | 'excel-client' | 'text' | 'text-client' | 'docx-html' | 'onlyoffice' | 'office-text' | 'download';
+type FilePreviewSurface = 'media' | 'document' | 'download';
+type FilePreviewProvider = 'browser' | 'platform' | 'onlyoffice' | 'none';
+interface FilePreviewCapability {
+    key?: string;
+    extension?: string;
+    previewType?: FilePreviewType;
+    renderMode?: FilePreviewRenderMode;
+    previewSurface?: FilePreviewSurface;
+    previewProvider?: FilePreviewProvider;
+    canPreview?: boolean;
+    canDownload?: boolean;
+    unsupportedReason?: string;
+}
+interface FilePreviewMetadata extends FilePreviewCapability {
+    capabilityVersion?: number;
+    ticket?: string;
+    appType?: string;
+    fileName?: string;
+    bucketName?: string;
+    objectName?: string;
+    size?: number;
+    contentType?: string;
+    downloadUrl?: string;
+    previewUrl?: string;
+    previewPageUrl?: string;
+    metadataUrl?: string;
+    imagePreviewUrl?: string;
+    excelPreviewUrl?: string;
+    textPreviewUrl?: string;
+    officeTextPreviewUrl?: string;
+    onlyofficeConfigUrl?: string;
+    onlyofficeEnabled?: boolean;
+    expiresIn?: number;
+}
+interface PreparedFilePreview {
+    item: AttachmentItem;
+    metadata: FilePreviewMetadata;
+    direct: boolean;
+}
+type FilePreviewRequest = FormRuntimeApi['request'];
+interface FilePreviewCapabilityBatch {
+    capabilityVersion?: number;
+    onlyofficeEnabled?: boolean;
+    items?: FilePreviewCapability[];
+}
+interface PreviewImageItem {
+    key: string;
+    src: string;
+    name: string;
+    revokeOnClose?: boolean;
+}
+
 interface ApprovalTimelineProps {
     tasks: ProcessTask[];
     className?: string;
@@ -1207,4 +1261,4 @@ interface ProcessPreviewProps {
 }
 declare const ProcessPreview: React__default.FC<ProcessPreviewProps>;
 
-export { type FormInstanceData as $, type AddressFieldProps as A, type BaseFieldProps as B, type CascadeDateFieldProps as C, type DataFilter as D, type DepartmentSearchParams as E, type DepartmentSearchResult as F, type DepartmentSearchScope as G, type DepartmentSelectFieldProps as H, type DepartmentTreeNode as I, type DigitalSignatureFieldProps as J, type DigitalSignatureValue as K, type EditorChoiceOption as L, type EditorFieldProps as M, type EditorToolbarAction as N, type FieldBehavior as O, type FieldDefinition as P, type FieldLayoutNode as Q, type FieldValueSyncConfig as R, type FormAppearanceConfig as S, type FormDataDeleteParams as T, type FormDataQueryParams as U, type FormEffect as V, type FormEffectAction as W, type FormEffectCondition as X, type FormEffectConditionOperator as Y, type FormEngineConfig as Z, type FormEngineMode as _, type AddressValue as a, type StandardFormPageMode as a$, type FormLayoutNode as a0, type FormRuntimeApi as a1, type FormRuntimeApiConfig as a2, type FormRuntimeConfig as a3, type FormSchema as a4, FormSection as a5, type FormSectionProps as a6, type FormSubmitBehavior as a7, type FormTemplateConfig as a8, type GridLayoutCell as a9, type ProcessAction as aA, type ProcessBasicInfo as aB, type ProcessDefinition as aC, type ProcessNodeType as aD, ProcessPreview as aE, type ProcessPreviewProps as aF, type ProcessRoute as aG, type ProcessStatus as aH, type ProcessTask as aI, type RadioFieldProps as aJ, type ResubmitParams as aK, type ReturnParams as aL, type ReturnPolicy as aM, type ReturnableNode as aN, type ReturnableNodeResult as aO, type RuntimeAuthHeadersProvider as aP, type RuntimeDataQueryParams as aQ, type RuntimeDataQueryResult as aR, type RuntimeRequestConfig as aS, type RuntimeResponse as aT, type RuntimeUploadOptions as aU, type RuntimeUploadProvider as aV, type SaveTaskParams as aW, type SectionLayoutNode as aX, type SelectFieldProps as aY, type SerialNumberFieldProps as aZ, type SignaturePoint as a_, type GridLayoutNode as aa, type ImageCompressionConfig as ab, type ImageCompressionVariantConfig as ac, type ImageFieldProps as ad, type ImageVariant as ae, type InitiatorSelectCandidate as af, type InitiatorSelectRequirement as ag, type InitiatorSelectScope as ah, type InitiatorSelectedApprovers as ai, type JSONFieldProps as aj, type LayoutVisibleWhen as ak, type LinkedFormOptionConfig as al, type LocationFieldProps as am, type LocationValue as an, type LowcodePageMeta as ao, type LowcodePageNode as ap, type LowcodePageNodeType as aq, type LowcodePageSchema as ar, type MultiSelectFieldProps as as, type NumberFieldProps as at, type OptionItem as au, type OptionSourceConfig as av, type OptionSourceType as aw, type PeopleShortcutConfig as ax, type PeopleShortcutType as ay, type PreviewParams as az, type ApprovalActionType as b, type StatusMeta as b0, type StepLayoutItem as b1, type StepsLayoutNode as b2, type SubFormColumn as b3, type SubFormFieldProps as b4, type TabLayoutItem as b5, type TabsLayoutNode as b6, type TaskStatus as b7, type TextAreaFieldProps as b8, type TextFieldProps as b9, type TextShortcutConfig as ba, type TextShortcutType as bb, type TransferParams as bc, type UserDisplayFormat as bd, type UserItem as be, type UserSelectFieldProps as bf, type ValidationPreset as bg, type ValidationRule as bh, type ViewPermissionQueryParams as bi, type ViewPermissionSummary as bj, type WithdrawParams as bk, type ApprovalPermission as c, ApprovalTimeline as d, type ApprovalTimelineProps as e, type ApproveParams as f, type AssociationFormConfig as g, type AssociationFormFieldProps as h, type AssociationValue as i, type AttachmentFieldProps as j, type AttachmentImageVariants as k, type AttachmentItem as l, type BaseLayoutNode as m, type CascadeSelectFieldProps as n, type ChangeRecord as o, type ChangeRecordListResponse as p, type ChangeRecordQueryParams as q, type CheckboxFieldProps as r, type DataLinkageCondition as s, type DataLinkageConfig as t, type DateFieldProps as u, type DateRangeRestriction as v, type DateRestrictionConfig as w, type DateShortcutConfig as x, type DateShortcutType as y, type DefaultValueLinkageConfig as z };
+export { type FormDataDeleteParams as $, type AddressFieldProps as A, type BaseFieldProps as B, type CascadeDateFieldProps as C, type DataFilter as D, type DepartmentSearchParams as E, type DepartmentSearchResult as F, type DepartmentSearchScope as G, type DepartmentSelectFieldProps as H, type DepartmentTreeNode as I, type DigitalSignatureFieldProps as J, type DigitalSignatureValue as K, type EditorChoiceOption as L, type EditorFieldProps as M, type EditorToolbarAction as N, type FieldBehavior as O, type FieldDefinition as P, type FieldLayoutNode as Q, type FieldValueSyncConfig as R, type FilePreviewCapability as S, type FilePreviewCapabilityBatch as T, type FilePreviewMetadata as U, type FilePreviewProvider as V, type FilePreviewRenderMode as W, type FilePreviewRequest as X, type FilePreviewSurface as Y, type FilePreviewType as Z, type FormAppearanceConfig as _, type AddressValue as a, type RuntimeDataQueryResult as a$, type FormDataQueryParams as a0, type FormEffect as a1, type FormEffectAction as a2, type FormEffectCondition as a3, type FormEffectConditionOperator as a4, type FormEngineConfig as a5, type FormEngineMode as a6, type FormInstanceData as a7, type FormLayoutNode as a8, type FormRuntimeApi as a9, type MultiSelectFieldProps as aA, type NumberFieldProps as aB, type OptionItem as aC, type OptionSourceConfig as aD, type OptionSourceType as aE, type PeopleShortcutConfig as aF, type PeopleShortcutType as aG, type PreparedFilePreview as aH, type PreviewImageItem as aI, type PreviewParams as aJ, type ProcessAction as aK, type ProcessBasicInfo as aL, type ProcessDefinition as aM, type ProcessNodeType as aN, ProcessPreview as aO, type ProcessPreviewProps as aP, type ProcessRoute as aQ, type ProcessStatus as aR, type ProcessTask as aS, type RadioFieldProps as aT, type ResubmitParams as aU, type ReturnParams as aV, type ReturnPolicy as aW, type ReturnableNode as aX, type ReturnableNodeResult as aY, type RuntimeAuthHeadersProvider as aZ, type RuntimeDataQueryParams as a_, type FormRuntimeApiConfig as aa, type FormRuntimeConfig as ab, type FormSchema as ac, FormSection as ad, type FormSectionProps as ae, type FormSubmitBehavior as af, type FormTemplateConfig as ag, type GridLayoutCell as ah, type GridLayoutNode as ai, type ImageCompressionConfig as aj, type ImageCompressionVariantConfig as ak, type ImageFieldProps as al, type ImageVariant as am, type InitiatorSelectCandidate as an, type InitiatorSelectRequirement as ao, type InitiatorSelectScope as ap, type InitiatorSelectedApprovers as aq, type JSONFieldProps as ar, type LayoutVisibleWhen as as, type LinkedFormOptionConfig as at, type LocationFieldProps as au, type LocationValue as av, type LowcodePageMeta as aw, type LowcodePageNode as ax, type LowcodePageNodeType as ay, type LowcodePageSchema as az, type ApprovalActionType as b, type RuntimeRequestConfig as b0, type RuntimeResponse as b1, type RuntimeUploadOptions as b2, type RuntimeUploadProvider as b3, type SaveTaskParams as b4, type SectionLayoutNode as b5, type SelectFieldProps as b6, type SerialNumberFieldProps as b7, type SignaturePoint as b8, type StandardFormPageMode as b9, type StatusMeta as ba, type StepLayoutItem as bb, type StepsLayoutNode as bc, type SubFormColumn as bd, type SubFormFieldProps as be, type TabLayoutItem as bf, type TabsLayoutNode as bg, type TaskStatus as bh, type TextAreaFieldProps as bi, type TextFieldProps as bj, type TextShortcutConfig as bk, type TextShortcutType as bl, type TransferParams as bm, type UserDisplayFormat as bn, type UserItem as bo, type UserSelectFieldProps as bp, type ValidationPreset as bq, type ValidationRule as br, type ViewPermissionQueryParams as bs, type ViewPermissionSummary as bt, type WithdrawParams as bu, type ApprovalPermission as c, ApprovalTimeline as d, type ApprovalTimelineProps as e, type ApproveParams as f, type AssociationFormConfig as g, type AssociationFormFieldProps as h, type AssociationValue as i, type AttachmentFieldProps as j, type AttachmentImageVariants as k, type AttachmentItem as l, type BaseLayoutNode as m, type CascadeSelectFieldProps as n, type ChangeRecord as o, type ChangeRecordListResponse as p, type ChangeRecordQueryParams as q, type CheckboxFieldProps as r, type DataLinkageCondition as s, type DataLinkageConfig as t, type DateFieldProps as u, type DateRangeRestriction as v, type DateRestrictionConfig as w, type DateShortcutConfig as x, type DateShortcutType as y, type DefaultValueLinkageConfig as z };

package/packages/sdk/dist/components/index.cjs

@@ -139,6 +139,8 @@ __export(components_exports, {
   normalizeDataManagementList: () => normalizeDataManagementList,
   normalizeFieldBehaviors: () => normalizeFieldBehaviors,
   normalizeOperation: () => normalizeOperation,
+  normalizePreviewBlobContent: () => normalizePreviewBlobContent,
+  normalizePreviewBlobResponse: () => normalizePreviewBlobResponse,
   normalizeRichTextHtml: () => normalizeRichTextHtml,
   prepareFilePreview: () => prepareFilePreview,
   previewProcess: () => previewProcess,
@@ -3371,6 +3373,64 @@ var TEXT_EXTENSIONS = /* @__PURE__ */ new Set([
   "vue"
 ]);
 var unwrapFilePreviewPayload = (payload) => payload?.data ?? payload?.result ?? payload;
+var getBinaryResponseMessage = (response) => String(
+  response?.message || response?.error || response?.errorMessage || response?.data?.message || response?.data?.error || response?.result?.message || ""
+).trim();
+var normalizePreviewBlobResponse = (response) => {
+  const payload = response;
+  const candidates = [
+    response,
+    payload?.blob,
+    payload?.data,
+    payload?.data?.blob,
+    payload?.result,
+    payload?.result?.blob
+  ];
+  const blob = candidates.find(
+    (candidate) => typeof Blob !== "undefined" && candidate instanceof Blob
+  );
+  if (blob) return blob;
+  throw new Error(getBinaryResponseMessage(payload) || "\u6587\u4EF6\u5185\u5BB9\u54CD\u5E94\u4E0D\u662F\u4E8C\u8FDB\u5236\u6570\u636E");
+};
+var isZipBytes = (bytes) => bytes.length >= 4 && bytes[0] === 80 && bytes[1] === 75 && (bytes[2] === 3 && bytes[3] === 4 || bytes[2] === 5 && bytes[3] === 6 || bytes[2] === 7 && bytes[3] === 8);
+var decodeBase64ZipBlob = async (blob) => {
+  const prefix = (await blob.slice(0, 96).text()).replace(/^\uFEFF/, "").replace(/\s+/g, "");
+  if (!prefix.startsWith("UEsDB")) return blob;
+  if (blob.size > 32 * 1024 * 1024) {
+    throw new Error("Base64 \u6587\u4EF6\u8D85\u8FC7\u6D4F\u89C8\u5668\u517C\u5BB9\u89E3\u7801\u4E0A\u9650");
+  }
+  const base64 = (await blob.text()).replace(/^\uFEFF/, "").replace(/\s+/g, "");
+  if (!/^[A-Za-z0-9+/]+={0,2}$/.test(base64)) {
+    throw new Error("\u6587\u4EF6\u5185\u5BB9\u662F\u65E0\u6548\u7684 Base64 \u4E8C\u8FDB\u5236\u6570\u636E");
+  }
+  let binary = "";
+  try {
+    binary = globalThis.atob(base64);
+  } catch {
+    throw new Error("\u6587\u4EF6\u5185\u5BB9\u662F\u65E0\u6548\u7684 Base64 \u4E8C\u8FDB\u5236\u6570\u636E");
+  }
+  const bytes = new Uint8Array(binary.length);
+  for (let index = 0; index < binary.length; index += 1) {
+    bytes[index] = binary.charCodeAt(index);
+  }
+  if (!isZipBytes(bytes)) {
+    throw new Error("Base64 \u6587\u4EF6\u89E3\u7801\u540E\u4E0D\u662F\u6709\u6548\u7684 Office \u6587\u6863");
+  }
+  if (globalThis.btoa(binary).replace(/=+$/, "") !== base64.replace(/=+$/, "")) {
+    throw new Error("\u6587\u4EF6\u5185\u5BB9\u662F\u65E0\u6548\u7684 Base64 \u4E8C\u8FDB\u5236\u6570\u636E");
+  }
+  return new Blob([bytes], { type: blob.type || "application/zip" });
+};
+var normalizePreviewBlobContent = async (response) => {
+  const blob = normalizePreviewBlobResponse(response);
+  if (String(blob.type || "").toLowerCase().includes("application/json")) {
+    const payload = await blob.text().then((value) => JSON.parse(value)).catch(() => null);
+    if (payload) {
+      throw new Error(getBinaryResponseMessage(payload) || "\u6587\u4EF6\u5185\u5BB9\u8BF7\u6C42\u5931\u8D25");
+    }
+  }
+  return decodeBase64ZipBlob(blob);
+};
 var isDirectStorageItem = (item) => item.provider === "oss" || item.uploadProvider === "oss" || item.uploadProvider === "builtin-oss" || Boolean(item.storageCode);
 var getPreviewItemKey = (item, index = 0) => getAttachmentItemIdentity(item) || item.id || item.uid || `${item.name || "file"}-${index}`;
 var getPreviewSourceUrl = (item) => item.previewUrl || item.publicUrl || item.url || "";
@@ -3544,10 +3604,7 @@ var prepareFilePreview = async (options) => {
 };
 var loadPreviewBlob = async (request, url) => {
   const response = await request({ url, method: "get", responseType: "blob" });
-  if (!(response instanceof Blob)) {
-    throw new Error("\u6587\u4EF6\u5185\u5BB9\u54CD\u5E94\u4E0D\u662F\u4E8C\u8FDB\u5236\u6570\u636E");
-  }
-  return response;
+  return normalizePreviewBlobContent(response);
 };
 var convertHeicPreview = async (request, url) => {
   const source = await loadPreviewBlob(request, url);
@@ -21392,14 +21449,18 @@ function createRuntimeRequest(context) {
         }
       });
     }
-    const method = config.responseType === "blob" ? "transport.download" : "transport.request";
-    return context.bridge?.invoke?.(method, {
-      path: config.url,
-      method: config.method || "get",
-      query: search?.toString(),
-      body: config.data,
-      headers: config.headers
-    });
+    const isBinary = config.responseType === "blob";
+    const response = await context.bridge?.invoke?.(
+      isBinary ? "transport.download" : "transport.request",
+      {
+        path: config.url,
+        method: config.method || "get",
+        query: search?.toString(),
+        body: config.data,
+        headers: config.headers
+      }
+    );
+    return isBinary ? normalizePreviewBlobResponse(response) : response;
   };
 }
 function LowcodePageRenderer({ schema, context }) {