@flyfish-group/file-viewer 1.0.6 → 1.0.8

package/README.md

@@ -2,15 +2,24 @@
 
 把 Word、Excel、PPT、PDF 和图片稳稳带进浏览器里。
 
-`@flyfish-group/file-viewer` 是一款基于 Vue 2.7、TypeScript 和 Vite 构建的纯前端文件预览组件。它不依赖后端转码服务，适合接入 OA、知识库、附件中心、流程系统和需要离线能力的业务场景。Vue3 用户可以使用 v3 分支和 `@flyfish-group/file-viewer3`，两条包线保持一致的格式能力、Demo 体验和文档说明。
+`@flyfish-group/file-viewer3` 是一款基于 Vue 3、TypeScript 和 Vite 构建的纯前端文件预览组件。Vue2.7 项目请使用同能力包 `@flyfish-group/file-viewer`。两条 npm 包线保持一致的格式覆盖、示例体验和 API 语义，在线 Demo 始终使用 `v3` 分支产物作为最新体验基准。
+
+它不依赖后端转码服务，适合接入 OA、知识库、附件中心、流程系统和需要离线能力的业务场景。这个项目的目标很直接: 让文档预览不再像临时拼出来的功能，而是像一个可以放心交付、能独立演示、能持续维护的产品模块。
 
 - 在线 Demo: [viewer.flyfish.dev](https://viewer.flyfish.dev)
 - 官方文档/组件主页: [doc.flyfish.dev](https://doc.flyfish.dev)
-- npm(Vue2): [@flyfish-group/file-viewer](https://www.npmjs.com/package/@flyfish-group/file-viewer)
 - npm(Vue3): [@flyfish-group/file-viewer3](https://www.npmjs.com/package/@flyfish-group/file-viewer3)
+- npm(Vue2): [@flyfish-group/file-viewer](https://www.npmjs.com/package/@flyfish-group/file-viewer)
 - 公开成品仓库: [github.com/flyfish-dev/file-viewer](https://github.com/flyfish-dev/file-viewer)
 - 源码自助开通: [dev.flyfish.group/shop](https://dev.flyfish.group/shop)
 
+## 当前发布版本
+
+| 技术栈 | npm 包 | 最新版本 | 推荐分支 | 说明 |
+| --- | --- | --- | --- | --- |
+| Vue3 | `@flyfish-group/file-viewer3` | `1.0.8` | `v3` | 主推版本，在线 Demo 与后续上线均以此为准 |
+| Vue2.7 | `@flyfish-group/file-viewer` | `1.0.8` | `main` | 兼容 Vue2 项目，格式能力与 Vue3 保持一致 |
+
 ![Flyfish Viewer demo](https://doc.flyfish.dev/_images/demo-main.png)
 
 ## 为什么值得接入
@@ -20,7 +29,7 @@
 - **按需异步加载。** PDF、OFD、CAD、Office、Markdown 和代码高亮渲染器都按需加载，重型解析依赖不会进入其他格式的首屏路径。
 - **阅读体验更像产品。** `.doc`、`.docx`、PDF 都保留灰色工作台、白色纸张、居中阅读和自适应缩放，避免“内容能打开但不好读”的落差。
 - **Demo 更适合验收。** 示例文件按文档、表格、图纸、代码、图片等类型分组展示，点击样例即可打开并自动收起选择器。
-- **Vue2 / Vue3 体验一致。** 主分支面向 Vue2.7，v3 分支面向 Vue3；两边共享完整格式覆盖、示例文件盒子、文档站和 iframe 集成体验。
+- **Vue2 / Vue3 体验一致。** `main` 分支面向 Vue2.7，`v3` 分支面向 Vue3；两边共享完整格式覆盖、示例文件盒子、文档站和 iframe 集成体验。
 - **组件和独立站两用。** 既支持在 Vue 项目里直接作为组件使用，也支持独立部署后通过 iframe 嵌入到任意系统，方便多业务线复用。
 - **适合成品交付。** 官方文档、在线 Demo、公开成品仓库、混淆压缩产物、npm tarball 和静态部署产物都一起维护，便于下载、验收和二次接入。
 
@@ -46,7 +55,37 @@
 
 ## 三条接入路线
 
-### 1. Vue 2 组件集成
+### 1. Vue 3 组件集成
+
+适合已经在 Vue 3 项目里开发，希望最短路径完成接入的团队。当前在线 Demo 和生产上线均以 `v3` 分支作为最终产物来源。
+
+```bash
+pnpm add @flyfish-group/file-viewer3
+```
+
+```ts
+import { createApp } from 'vue'
+import App from './App.vue'
+import FileViewer from '@flyfish-group/file-viewer3'
+
+createApp(App).use(FileViewer).mount('#app')
+```
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+
+const url = ref('https://example.com/demo.pdf')
+</script>
+
+<template>
+  <div style="height: 100vh">
+    <file-viewer :url="url" />
+  </div>
+</template>
+```
+
+### 2. Vue 2 组件集成
 
 适合仍在 Vue2.7 技术栈上，希望直接以内嵌组件方式完成接入的团队。
 
@@ -84,22 +123,6 @@ export default {
 </script>
 ```
 
-### 2. Vue 3 组件集成
-
-Vue3 用户使用 v3 分支对应包，API 和示例站能力保持一致:
-
-```bash
-pnpm add @flyfish-group/file-viewer3
-```
-
-```ts
-import { createApp } from 'vue'
-import App from './App.vue'
-import FileViewer from '@flyfish-group/file-viewer3'
-
-createApp(App).use(FileViewer).mount('#app')
-```
-
 ### 3. Iframe 嵌入
 
 适合多系统共用一套预览器、想把预览能力独立部署、或者不希望把解析依赖带进业务包的场景。
@@ -148,6 +171,13 @@ pnpm dev
 
 ## 打包发布
 
+Vue3 和 Vue2 发包时分别在对应分支执行同一套发布链路:
+
+| 包 | 分支 | npm 名称 |
+| --- | --- | --- |
+| Vue3 | `v3` | `@flyfish-group/file-viewer3` |
+| Vue2.7 | `main` | `@flyfish-group/file-viewer` |
+
 建议在发布前执行下面这组命令:
 
 ```bash
@@ -175,9 +205,12 @@ pnpm release:pack
 发布到 npm:
 
 ```bash
+npm publish --dry-run --access public
 npm publish --access public
 ```
 
+如果 npm 账号启用了 MFA，请使用交互式终端完成浏览器确认后再等待发布结果。
+
 公开 GitHub 仓库只提交可直接使用的构建产物、示例、文档和 npm tarball，不提交当前源码目录。需要源码、二开包或商业自助开通的用户，可以前往 [https://dev.flyfish.group/shop](https://dev.flyfish.group/shop)，付费 4.99 后自助开通。
 
 ## 文档导航
@@ -193,4 +226,4 @@ npm publish --access public
 
 本项目使用 `Apache-2.0` 许可证。
 
-二开或商用时，请按许可证要求保留版权、许可证和来源说明，并注明项目来源为 Flyfish Viewer / `@flyfish-group/file-viewer` 或 `@flyfish-group/file-viewer3`。如果你基于本项目修复了通用问题或增强了通用能力，也欢迎通过 issue / PR 一起贡献回来，让这套预览能力继续变得更稳。
+二开或商用时，请按许可证要求保留版权、许可证和来源说明，并注明项目来源为 Flyfish Viewer / `@flyfish-group/file-viewer3` 或 `@flyfish-group/file-viewer`。如果你基于本项目修复了通用问题或增强了通用能力，也欢迎通过 issue / PR 一起贡献回来，让这套预览能力继续变得更稳。

package/dist/components/CadViewer.js

@@ -1 +1 @@
-var a7=c;function c(b,d){b=b-0x97;var e=a();var f=e[b];return f;}(function(l,m){var a6=c,n=l();while(!![]){try{var o=-parseInt(a6(0xb5))/0x1+parseInt(a6(0xa4))/0x2*(parseInt(a6(0xa1))/0x3)+-parseInt(a6(0x9e))/0x4+-parseInt(a6(0xa0))/0x5+-parseInt(a6(0xb1))/0x6+parseInt(a6(0x9d))/0x7+-parseInt(a6(0xb4))/0x8*(-parseInt(a6(0xa8))/0x9);if(o===m)break;else n['push'](n['shift']());}catch(p){n['push'](n['shift']());}}}(a,0xe712e));var x=Object['defineProperty'],h=Object['defineProperties'],L=Object['getOwnPropertyDescriptors'],C=Object[a7(0x98)],A=Object['prototype']['hasOwnProperty'],B=Object['prototype']['propertyIsEnumerable'],b=(l,m,n)=>m in l?x(l,m,{'enumerable':!0x0,'configurable':!0x0,'writable':!0x0,'value':n}):l[m]=n,T=(l,m)=>{var a8=a7;for(var n in m||(m={}))A[a8(0xa2)](m,n)&&b(l,n,m[n]);if(C){for(var n of C(m))B['call'](m,n)&&b(l,n,m[n]);}return l;},D=(l,m)=>h(l,L(m)),v=(l,m,n)=>new Promise((o,p)=>{var a9=a7,u=I=>{try{H(n['next'](I));}catch(J){p(J);}},y=I=>{try{H(n['throw'](I));}catch(J){p(J);}},H=I=>I[a9(0xaa)]?o(I['value']):Promise[a9(0xaf)](I['value'])['then'](u,y);H((n=n['apply'](l,m))['next']());});function a(){var aj=['_setupProxy','done','exports','fitToView','layers','name','resolve','status','9879894SWmtBr','type','loading','20754728IBySEM','1530139VQFXWa','value','message','activeTool','getLayers','getOwnPropertySymbols','observe','cad-tools','CAD\x20图纸解析失败','error','9763089JTmVUB','3358568EqTxkd','div','446175WoJYgT','75FZWiDY','call','select','85046EahCZs','pan','measure','destroy','9uFWuaA'];a=function(){return aj;};return a();}import{defineComponent as d,ref as e,onMounted as g,onBeforeUnmount as i,nextTick as j}from'vue';import{n as k}from'./index.js';const $=d({'__name':'CadViewer','props':{'data':null,'type':null},'setup'(H){var aa=a7;const I=H,J=e(null),K=e([]),N=e('pan'),P=e('loading'),Q=e('');let S=null,U=null;const W={'dwg':'DWG\x20是专有\x20CAD\x20格式，当前\x20Apache\x20许可包未内置\x20GPL\x20转换器。请优先上传\x20DXF，或在业务侧转换为\x20DXF\x20后预览。'},X=a3=>a3 instanceof Error?a3[aa(0xb7)]:typeof a3=='string'?a3:JSON['stringify'](a3),Y=a3=>{N['value']=a3,S==null||S['setTool'](a3);},Z=()=>{S==null||S['resize'](),S==null||S['fitToView']();},a0=a3=>{var ab=aa;const a4=a3['isOff'];S==null||S['setLayerVisible'](a3[ab(0xae)],a4),K[ab(0xb6)]=K[ab(0xb6)]['map'](a5=>a5['name']===a3['name']?D(T({},a5),{'isOff':!a4}):a5);},a1=()=>v(this,null,function*(){var ac=aa;const a3=J['value'];if(a3){P[ac(0xb6)]=ac(0xb3),Q['value']='';try{const {CadViewer:a4}=yield import('./index2.js');S==null||S[ac(0xa7)](),S=new a4(a3,{'theme':'light','initialTool':N['value'],'worker':!0x1}),S['loadArrayBuffer'](I['data']),yield j(),Z(),K['value']=S[ac(0x97)](),P['value']='ready';}catch(a5){console['error'](a5),P['value']=ac(0x9c),Q['value']=X(a5)||ac(0x9b);}}}),a2=()=>v(this,null,function*(){var ad=aa;const a3=I[ad(0xb2)]['toLowerCase']();if(W[a3]){P['value']='error',Q['value']=W[a3];return;}yield a1();});return g(()=>{var ae=aa;a2();const a3=J['value'];a3&&(U=new ResizeObserver(()=>{S==null||S['resize'](),S==null||S['requestRender']();}),U[ae(0x99)](a3));}),i(()=>{U==null||U['disconnect'](),U=null,S==null||S['destroy'](),S=null;}),{'__sfc':!0x0,'props':I,'canvas':J,'layers':K,'activeTool':N,'status':P,'errorMessage':Q,'viewer':S,'resizeObserver':U,'unsupportedMessages':W,'normalizeError':X,'setTool':Y,'fitToView':Z,'toggleLayer':a0,'loadDxf':a1,'load':a2};}});var R=function(){var af=a7,l=this,m=l['_self']['_c'],o=l['_self'][af(0xa9)];return m(af(0x9f),{'staticClass':'cad-viewer'},[m('div',{'staticClass':'cad-toolbar'},[m(af(0x9f),{'staticClass':af(0x9a)},[m('button',{'class':{'active':o['activeTool']==='pan'},'attrs':{'type':'button'},'on':{'click':function(p){var ag=af;return o['setTool'](ag(0xa5));}}},[l['_v']('平移')]),m('button',{'class':{'active':o[af(0xb8)]===af(0xa3)},'attrs':{'type':'button'},'on':{'click':function(p){var ah=af;return o['setTool'](ah(0xa3));}}},[l['_v']('选择')]),m('button',{'class':{'active':o['activeTool']==='measure'},'attrs':{'type':'button'},'on':{'click':function(p){var ai=af;return o['setTool'](ai(0xa6));}}},[l['_v']('测量')]),m('button',{'attrs':{'type':'button'},'on':{'click':o[af(0xac)]}},[l['_v']('适配')])]),m('span',[l['_v'](l['_s'](l['type']['toUpperCase']()))])]),m('div',{'staticClass':'cad-body'},[o[af(0xad)]['length']?m('aside',{'staticClass':'cad-layers'},l['_l'](o['layers'],function(p){return m('button',{'key':p['name'],'class':{'muted':p['isOff']},'attrs':{'type':'button'},'on':{'click':function(r){return o['toggleLayer'](p);}}},[l['_v']('\x20'+l['_s'](p['name'])+'\x20')]);}),0x0):l['_e'](),m('div',{'staticClass':'cad-canvas-wrap'},[m('canvas',{'ref':'canvas'}),o[af(0xb0)]==='loading'?m('div',{'staticClass':'cad-state'},[l['_v']('正在解析\x20CAD...')]):o[af(0xb0)]==='error'?m('div',{'staticClass':'cad-state\x20error'},[l['_v'](l['_s'](o['errorMessage']))]):l['_e']()])])]);},w=[],G=k($,R,w,!0x1,null,'cf49f0f1',null,null);const q=G[a7(0xab)];export{q as default};
+var a7=c;function c(b,d){b=b-0x162;var e=a();var f=e[b];return f;}(function(l,m){var a6=c,n=l();while(!![]){try{var o=parseInt(a6(0x173))/0x1+parseInt(a6(0x171))/0x2+parseInt(a6(0x168))/0x3*(parseInt(a6(0x16e))/0x4)+parseInt(a6(0x174))/0x5*(-parseInt(a6(0x178))/0x6)+parseInt(a6(0x167))/0x7+-parseInt(a6(0x179))/0x8*(-parseInt(a6(0x16f))/0x9)+-parseInt(a6(0x16c))/0xa;if(o===m)break;else n['push'](n['shift']());}catch(p){n['push'](n['shift']());}}}(a,0xe8276));function a(){var ai=['length','154554GHmBji','2242264VeUjVg','toggleLayer','value','cad-state\x20error','defineProperties','pan','activeTool','done','then','stringify','5111764oeHvVw','807561Aqmfwf','button','next','_self','30097790WHidox','hasOwnProperty','16QjbEsW','54HmhySg','name','2063436xsXKez','getOwnPropertyDescriptors','135758BYjQHa','135DZQQAD','destroy','loading'];a=function(){return ai;};return a();}var x=Object['defineProperty'],h=Object[a7(0x17d)],L=Object[a7(0x172)],C=Object['getOwnPropertySymbols'],A=Object['prototype'][a7(0x16d)],B=Object['prototype']['propertyIsEnumerable'],b=(l,m,n)=>m in l?x(l,m,{'enumerable':!0x0,'configurable':!0x0,'writable':!0x0,'value':n}):l[m]=n,T=(l,m)=>{for(var n in m||(m={}))A['call'](m,n)&&b(l,n,m[n]);if(C){for(var n of C(m))B['call'](m,n)&&b(l,n,m[n]);}return l;},D=(l,m)=>h(l,L(m)),v=(l,m,n)=>new Promise((o,p)=>{var a9=a7,u=I=>{var a8=c;try{H(n[a8(0x16a)](I));}catch(J){p(J);}},y=I=>{try{H(n['throw'](I));}catch(J){p(J);}},H=I=>I[a9(0x164)]?o(I['value']):Promise['resolve'](I['value'])[a9(0x165)](u,y);H((n=n['apply'](l,m))['next']());});import{defineComponent as d,ref as e,onMounted as g,onBeforeUnmount as i,nextTick as j}from'vue';import{n as k}from'./index.js';const $=d({'__name':'CadViewer','props':{'data':null,'type':null},'setup'(H){var aa=a7;const I=H,J=e(null),K=e([]),N=e('pan'),P=e('loading'),Q=e('');let S=null,U=null;const W={'dwg':'DWG\x20是专有\x20CAD\x20格式，当前\x20Apache\x20许可包未内置\x20GPL\x20转换器。请优先上传\x20DXF，或在业务侧转换为\x20DXF\x20后预览。'},X=a3=>a3 instanceof Error?a3['message']:typeof a3=='string'?a3:JSON[aa(0x166)](a3),Y=a3=>{N['value']=a3,S==null||S['setTool'](a3);},Z=()=>{S==null||S['resize'](),S==null||S['fitToView']();},a0=a3=>{var ab=aa;const a4=a3['isOff'];S==null||S['setLayerVisible'](a3['name'],a4),K['value']=K[ab(0x17b)]['map'](a5=>a5['name']===a3['name']?D(T({},a5),{'isOff':!a4}):a5);},a1=()=>v(this,null,function*(){var ac=aa;const a3=J['value'];if(a3){P['value']='loading',Q['value']='';try{const {CadViewer:a4}=yield import('./index2.js');S==null||S['destroy'](),S=new a4(a3,{'theme':'light','initialTool':N['value'],'worker':!0x1}),S['loadArrayBuffer'](I['data']),yield j(),Z(),K[ac(0x17b)]=S['getLayers'](),P[ac(0x17b)]='ready';}catch(a5){console['error'](a5),P['value']='error',Q['value']=X(a5)||'CAD\x20图纸解析失败';}}}),a2=()=>v(this,null,function*(){var ad=aa;const a3=I['type']['toLowerCase']();if(W[a3]){P[ad(0x17b)]='error',Q['value']=W[a3];return;}yield a1();});return g(()=>{a2();const a3=J['value'];a3&&(U=new ResizeObserver(()=>{S==null||S['resize'](),S==null||S['requestRender']();}),U['observe'](a3));}),i(()=>{var ae=aa;U==null||U['disconnect'](),U=null,S==null||S[ae(0x175)](),S=null;}),{'__sfc':!0x0,'props':I,'canvas':J,'layers':K,'activeTool':N,'status':P,'errorMessage':Q,'viewer':S,'resizeObserver':U,'unsupportedMessages':W,'normalizeError':X,'setTool':Y,'fitToView':Z,'toggleLayer':a0,'loadDxf':a1,'load':a2};}});var R=function(){var af=a7,l=this,m=l[af(0x16b)]['_c'],o=l[af(0x16b)]['_setupProxy'];return m('div',{'staticClass':'cad-viewer'},[m('div',{'staticClass':'cad-toolbar'},[m('div',{'staticClass':'cad-tools'},[m('button',{'class':{'active':o['activeTool']===af(0x162)},'attrs':{'type':'button'},'on':{'click':function(p){return o['setTool']('pan');}}},[l['_v']('平移')]),m('button',{'class':{'active':o[af(0x163)]==='select'},'attrs':{'type':'button'},'on':{'click':function(p){return o['setTool']('select');}}},[l['_v']('选择')]),m('button',{'class':{'active':o['activeTool']==='measure'},'attrs':{'type':'button'},'on':{'click':function(p){return o['setTool']('measure');}}},[l['_v']('测量')]),m('button',{'attrs':{'type':af(0x169)},'on':{'click':o['fitToView']}},[l['_v']('适配')])]),m('span',[l['_v'](l['_s'](l['type']['toUpperCase']()))])]),m('div',{'staticClass':'cad-body'},[o['layers'][af(0x177)]?m('aside',{'staticClass':'cad-layers'},l['_l'](o['layers'],function(p){var ag=af;return m('button',{'key':p[ag(0x170)],'class':{'muted':p['isOff']},'attrs':{'type':ag(0x169)},'on':{'click':function(r){var ah=ag;return o[ah(0x17a)](p);}}},[l['_v']('\x20'+l['_s'](p['name'])+'\x20')]);}),0x0):l['_e'](),m('div',{'staticClass':'cad-canvas-wrap'},[m('canvas',{'ref':'canvas'}),o['status']===af(0x176)?m('div',{'staticClass':'cad-state'},[l['_v']('正在解析\x20CAD...')]):o['status']==='error'?m('div',{'staticClass':af(0x17c)},[l['_v'](l['_s'](o['errorMessage']))]):l['_e']()])])]);},w=[],G=k($,R,w,!0x1,null,'cf49f0f1',null,null);const q=G['exports'];export{q as default};