@7niao/doc-previewer 0.0.0-stage → 0.1.1

package/dist/types/renderers/XlsxRenderer.vue.d.ts

@@ -0,0 +1,16 @@
+import type { FileViewerOptions, PreviewSource } from '../types';
+type __VLS_Props = {
+    source: PreviewSource;
+    options: FileViewerOptions;
+    viewportWidth?: number;
+    viewportHeight?: number;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    error: (message: string) => any;
+    ready: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onError?: ((message: string) => any) | undefined;
+    onReady?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/types.d.ts

@@ -0,0 +1,51 @@
+/** 可预览的文件类别 */
+export type PreviewKind = 'image' | 'video' | 'audio' | 'pdf' | 'word' | 'excel' | 'ppt' | 'ofd' | 'archive' | 'cad' | 'model3d' | 'gis' | 'text' | 'unsupported';
+/** 预览器可配置项 */
+export interface FileViewerOptions {
+    /** 组件高度，默认 640px */
+    height?: string;
+    /** 是否显示顶部工具栏，默认 true */
+    toolbar?: boolean;
+    /** 是否显示文件名与格式信息，默认 true */
+    showFileInfo?: boolean;
+    /** 缩放范围与倍率 */
+    zoom?: {
+        min?: number;
+        max?: number;
+        step?: number;
+    };
+    /** GIS 底图瓦片地址模板，默认不加载在线底图 */
+    mapTiles?: string | false;
+    /** CAD 线条颜色，默认 #1f2937 */
+    cadLineColor?: string;
+    /** 文本预览最大字符数，默认 2MB */
+    textMaxLength?: number;
+}
+/** 交给渲染器使用的统一文件描述 */
+export interface PreviewSource {
+    name: string;
+    ext: string;
+    mime: string;
+    size: number;
+    url: string;
+    /** 获取 Blob；远程地址会按需下载 */
+    getBlob: () => Promise<Blob>;
+    /** 获取 ArrayBuffer */
+    getArrayBuffer: () => Promise<ArrayBuffer>;
+    /** 获取文本内容 */
+    getText: () => Promise<string>;
+}
+/** 渲染器对外暴露的原生视图操作，用于 3D / GIS / CAD */
+export interface RendererApi {
+    zoomIn?: () => void;
+    zoomOut?: () => void;
+    resetZoom?: () => void;
+    rotate?: (delta: number) => void;
+    print?: () => void | Promise<void>;
+}
+/** 压缩包条目的预览请求 */
+export interface ArchiveEntryRequest {
+    file: File;
+    path: string;
+}
+export declare const KIND_LABELS: Record<PreviewKind, string>;

package/dist/types/utils/detect.d.ts

@@ -0,0 +1,10 @@
+import type { PreviewKind } from '../types';
+/** 取小写扩展名（无扩展名时返回空串） */
+export declare function getExtension(name: string): string;
+/** 根据文件名 / MIME 推断预览类型 */
+export declare function detectKind(name: string, mime?: string, override?: PreviewKind): PreviewKind;
+/** 由 MIME 反推一个常用扩展名，用于 Blob 没有文件名时 */
+export declare function guessExtension(mime: string): string;
+export declare function mimeForExtension(ext: string): string;
+/** 常见格式的 MIME，用于文件选择器的 accept 属性 */
+export declare const PREVIEW_ACCEPT: string;

package/dist/types/utils/dom.d.ts

@@ -0,0 +1,13 @@
+/** 字节数转可读文本 */
+export declare function formatBytes(bytes: number): string;
+/** 触发浏览器下载 */
+export declare function downloadBlob(blob: Blob, name: string): void;
+/** 打印任意预览 DOM（图片、Office、OFD、文本、压缩包列表、GIS 矢量等） */
+export declare function printElement(element: HTMLElement, options?: {
+    title?: string;
+    resetTransform?: boolean;
+}): void;
+/** 打印 PDF：交给浏览器内置 PDF 阅读器 */
+export declare function printPdfUrl(url: string): void;
+/** 打印画布快照（3D / CAD） */
+export declare function printImageDataUrl(dataUrl: string, title?: string): void;

package/dist/types/vendor/asn1js-stub.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `@lapo/asn1js` 1.x 是 UMD 包，内部的相对 require 在浏览器预打包后无法解析，
+ * 会导致 ofd-tools 整个模块加载失败。OFD 渲染本身不依赖该库（它仅用于电子签章验签），
+ * 这里提供一个最小替身，保证普通 OFD 能正常渲染；涉及签章验签的能力会在调用时明确报错。
+ */
+declare const _default: {
+    decode(input: string | Uint8Array): Uint8Array;
+    unarmor(input: string): Uint8Array;
+};
+export default _default;

package/package.json

@@ -1,6 +1,80 @@
 {
   "name": "@7niao/doc-previewer",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "开箱即用的 Vue 3 文件预览组件，支持图片、音视频、PDF、Word、Excel、PPT、OFD、CAD、3D 模型、GIS 与压缩包",
+  "keywords": [
+    "vue",
+    "vue3",
+    "file-preview",
+    "document-preview",
+    "pdf",
+    "docx",
+    "xlsx",
+    "pptx",
+    "ofd",
+    "dwg",
+    "gltf",
+    "gis",
+    "archive"
+  ],
+  "license": "ISC",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/types/index.d.ts",
+  "style": "./dist/style.css",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./style.css": "./dist/style.css",
+    "./package.json": "./package.json"
+  },
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "peerDependencies": {
+    "vue": "^3.4.0"
+  },
+  "devDependencies": {
+    "@lucide/vue": "^1.66.0",
+    "@tmcw/togeojson": "^7.1.3",
+    "@types/leaflet": "^1.9.22",
+    "@types/node": "^24.19.2",
+    "@types/three": "^0.187.0",
+    "@vitejs/plugin-vue": "^6.0.10",
+    "@vue/tsconfig": "^0.9.1",
+    "docx": "^9.15.1",
+    "docx-preview": "^0.4.1",
+    "dwg2dxf": "^2.0.3",
+    "dxf-parser": "^1.1.2",
+    "fflate": "^0.8.3",
+    "leaflet": "^1.9.4",
+    "libarchive.js": "^2.0.2",
+    "ofd-tools": "^1.0.3",
+    "pdf-lib": "^1.17.1",
+    "pdfjs-dist": "^6.4.299",
+    "pptx-preview": "^1.0.7",
+    "pptxgenjs": "^4.0.1",
+    "shpjs": "^6.2.0",
+    "three": "^0.187.0",
+    "typescript": "~6.0.3",
+    "vite": "^8.3.5",
+    "vue": "^3.5.44",
+    "vue-tsc": "^3.3.13",
+    "xlsx": "^0.18.5"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "pnpm build:lib",
+    "build:lib": "vite build --config vite.lib.config.ts && vue-tsc -p tsconfig.lib.json && cp -R public/libarchive dist/libarchive",
+    "build:demo": "vue-tsc -b && vite build",
+    "typecheck": "vue-tsc -b",
+    "preview": "vite preview --outDir dist-demo",
+    "publish:lib": "pnpm publish --access public"
+  }
 }