@ibiz-template-plugin/ibiz-file-previewer 0.0.23 → 0.0.25

package/dist/types/src/controller/file-preview-item/file-preview-image-controller.d.ts

@@ -4,7 +4,7 @@ import { FilePreviewItemController } from './file-preview-item-controller';
 /**
  * 图片预览控制器
  */
-export declare class FilePreviewImageController<S extends IFilePreviewImageState = IFilePreviewImageState> extends FilePreviewItemController<S> {
+export declare class FilePreviewImageController<S extends IFilePreviewImageState = IFilePreviewImageState, E extends Record<string, any> = Record<string, any>> extends FilePreviewItemController<S, E> {
     protected initState(): void;
     /**
      * 获取内容

package/dist/types/src/controller/file-preview-item/file-preview-image-group-controller.d.ts

@@ -1,9 +1,9 @@
-import { IFilePreviewImageGroupState } from '../../interface';
+import { IFilePreviewImageGroupEvents, IFilePreviewImageGroupState } from '../../interface';
 import { FilePreviewImageController } from './file-preview-image-controller';
 /**
  * 图片组预览
  */
-export declare class FilePreviewImageGroupController<S extends IFilePreviewImageGroupState = IFilePreviewImageGroupState> extends FilePreviewImageController<S> {
+export declare class FilePreviewImageGroupController<S extends IFilePreviewImageGroupState = IFilePreviewImageGroupState, E extends Record<string, any> = IFilePreviewImageGroupEvents> extends FilePreviewImageController<S, E> {
     protected initState(): void;
     /**
      * 获取内容
@@ -13,6 +13,13 @@ export declare class FilePreviewImageGroupController<S extends IFilePreviewImage
      * 切换缩略图面板
      */
     switchThumbnailPanel(): void;
+    /**
+     * 跳转至指定页（0-based）
+     * - 越界或内容未加载时静默忽略
+     * - 同步更新 currentPage，并派发 goToPage 事件由组件执行滚动
+     * @param page 目标页索引
+     */
+    goToPage(page: number): void;
     /**
      * 处理旋转角度改变
      * @param value

package/dist/types/src/controller/file-preview-item/file-preview-item-controller.d.ts

@@ -1,19 +1,28 @@
 import { Signal } from '@preact/signals';
 import { IFilePreviewItemState, IFilePreviewItemController, IFilePreviewShellController } from '../../interface';
+import { EventEmitter } from '../../util';
 /**
  * 文件预览项控制器
  */
-export declare class FilePreviewItemController<S extends IFilePreviewItemState = IFilePreviewItemState> implements IFilePreviewItemController {
+export declare class FilePreviewItemController<S extends IFilePreviewItemState = IFilePreviewItemState, E extends Record<string, any> = Record<string, any>> implements IFilePreviewItemController {
     filePreviewShell: IFilePreviewShellController;
     /**
      * 状态
      */
     state: Signal<S>;
+    /**
+     * 事件对象，用于向组件派发瞬时动作事件
+     */
+    events: EventEmitter<E>;
     /**
      * 构造函数
      * @param filePreviewShell
      */
     constructor(filePreviewShell: IFilePreviewShellController);
+    /**
+     * 工具栏容器唯一 id（代理自 shell controller）
+     */
+    get controlsId(): string;
     /**
      * 更新状态
      * - 所有的状态更新必须调用该方法，以便界面响应

package/dist/types/src/controller/file-preview-shell-controller.d.ts

@@ -18,6 +18,11 @@ export declare class FilePreviewShellController implements IFilePreviewShellCont
      * 文件预览控制器
      */
     preViewController: IFilePreviewItemController | undefined;
+    /**
+     * 当前实例工具栏容器唯一 id（不带 #）
+     * - 构造时确定，生命周期内不变
+     */
+    readonly controlsId: string;
     /**
      * 文件预览器状态对象
      */
@@ -94,4 +99,11 @@ export declare class FilePreviewShellController implements IFilePreviewShellCont
      * @param engineType
      */
     switchEngineType(engineType: EngineType): Promise<void>;
+    /**
+     * 跳转至目标页
+     * - 仅对图片组场景生效，其它场景忽略
+     * - 页码为 0-based
+     * @param page 目标页索引
+     */
+    goToPage(page: number): void;
 }

package/dist/types/src/interface/i-file-preview-item-controller.d.ts

@@ -1,5 +1,6 @@
 import { ComponentType } from 'preact';
 import { FileType, ImageMode } from '../const';
+import { EventEmitter } from '../util';
 import { IFilePreviewShellController } from './i-file-preview-shell-controller';
 /**
  * 文件预览项状态
@@ -84,6 +85,14 @@ export interface IFilePreviewItemController {
      * 状态
      */
     state: Record<string, any>;
+    /**
+     * 当前实例工具栏容器唯一 id（不带 #），由 shell controller 提供
+     */
+    controlsId: string;
+    /**
+     * 事件对象，用于控制器向组件派发瞬时动作事件
+     */
+    events: EventEmitter;
     /**
      * 初始化
      */

package/dist/types/src/interface/i-file-preview-item-events.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 图片组控制器事件
+ */
+export interface IFilePreviewImageGroupEvents {
+    /**
+     * 跳转至目标页（payload 为 0-based 页码）
+     */
+    goToPage: number;
+}

package/dist/types/src/interface/i-file-preview-shell-controller.d.ts

@@ -49,6 +49,11 @@ export interface IFilePreviewShellState {
  * 文件预览壳控制器接口
  */
 export interface IFilePreviewShellController {
+    /**
+     * 当前实例工具栏容器的唯一 DOM id（不带 #）
+     * - 供 shell 渲染容器 id，item 组件 Teleport 时拼接为选择器
+     */
+    controlsId: string;
     /**
      * 更新视图
      * @param data

package/dist/types/src/interface/i-file-previewer-option.d.ts

@@ -123,6 +123,13 @@ export interface IFilePreviewerOption {
      * @param type
      */
     actionSuccessCallBack(type: string): Promise<void>;
+    /**
+     * 预览初始化完成回调
+     * - item 组件挂载完成、预览就绪时触发
+     * - 每次 updateView 或 switchEngineType 后的预览就绪都会触发
+     * - 需要当前预览详情时，在回调内调用 shellController.getState() 获取
+     */
+    onInitialized?: () => void;
 }
 /**
  * 文件预览组件配置项

package/dist/types/src/interface/index.d.ts

@@ -1,3 +1,4 @@
 export type { IFilePreviewerData, IFilePreviewerOption, } from './i-file-previewer-option';
 export type { IFilePreviewShellState, IFilePreviewShellController, } from './i-file-preview-shell-controller';
 export type { PreviewItemComponent, IFilePreviewItemState, IFilePreviewImageState, IFilePreviewImageGroupState, IFilePreviewItemController, IFilePreviewItemConstructor, } from './i-file-preview-item-controller';
+export type { IFilePreviewImageGroupEvents } from './i-file-preview-item-events';

package/dist/types/src/util/event-emitter.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 事件处理函数
+ */
+type EventHandler<T = any> = (payload: T) => void;
+/**
+ * 极简类型安全事件发射器
+ * - on 返回 unsubscribe 函数，便于在 useEffect 中直接 return 清理
+ */
+export declare class EventEmitter<E extends Record<string, any> = Record<string, any>> {
+    private handlers;
+    /**
+     * 订阅事件
+     * @param event 事件名
+     * @param handler 处理函数
+     * @returns 取消订阅函数
+     */
+    on<K extends keyof E>(event: K, handler: EventHandler<E[K]>): () => void;
+    /**
+     * 取消订阅事件
+     * @param event 事件名
+     * @param handler 处理函数
+     */
+    off<K extends keyof E>(event: K, handler: EventHandler<E[K]>): void;
+    /**
+     * 派发事件
+     * @param event 事件名
+     * @param payload 载荷
+     */
+    emit<K extends keyof E>(event: K, payload: E[K]): void;
+}
+export {};

package/dist/types/src/util/index.d.ts

@@ -1,2 +1,3 @@
 export { fileNameToFileType, throttle } from './util';
 export { StaticResource } from './static-resource';
+export { EventEmitter } from './event-emitter';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ibiz-template-plugin/ibiz-file-previewer",
-  "version": "0.0.23",
+  "version": "0.0.25",
   "description": "iBiz文件预览器",
   "type": "module",
   "main": "dist/index.es.js",

package/dist/vditor/dist/css/content-theme/ant-design.css

@@ -1,210 +0,0 @@
-/*!
- * Vditor - A markdown editor written in TypeScript.
- *
- * MIT License
- *
- * Copyright (c) 2018-present B3log 开源, b3log.org
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- *
- */
-
-.vditor-reset {
-    color: rgba(0, 0, 0, .85);
-    font-size: 14px;
-    line-height: 2;
-}
-
-.vditor-reset img {
-    max-width: calc(100% - 32px);
-}
-
-.vditor-reset p > img {
-    margin: 34px 0;
-    box-shadow: 0 8px 20px rgba(143, 168, 191, 0.35);
-}
-
-.vditor-reset h1 {
-    margin-bottom: 20px;
-    color: rgba(0, 0, 0, .85);
-    font-weight: 500;
-    font-size: 30px;
-    font-family: Avenir, -apple-system, BlinkMacSystemFont, segoe ui, Roboto, helvetica neue, Arial, noto sans, sans-serif, apple color emoji, segoe ui emoji, segoe ui symbol, noto color emoji, sans-serif;
-    line-height: 38px
-}
-
-.vditor-reset h2 {
-    font-size: 24px;
-    line-height: 32px;
-}
-
-.vditor-reset h2,
-.vditor-reset h3,
-.vditor-reset h4,
-.vditor-reset h5,
-.vditor-reset h6 {
-    clear: both;
-    margin: 1.6em 0 .6em;
-    color: rgba(0, 0, 0, .85);
-    font-weight: 500;
-    font-family: Avenir, -apple-system, BlinkMacSystemFont, segoe ui, Roboto, helvetica neue, Arial, noto sans, sans-serif, apple color emoji, segoe ui emoji, segoe ui symbol, noto color emoji, sans-serif
-}
-
-.vditor-reset h3 {
-    font-size: 18px;
-}
-
-.vditor-reset h4 {
-    font-size: 16px;
-}
-
-.vditor-reset h5 {
-    font-size: 14px;
-}
-
-.vditor-reset h6 {
-    font-size: 12px;
-}
-
-.vditor-reset hr {
-    clear: both;
-    height: 1px;
-    margin: 56px 0;
-    background: #f0f0f0;
-    border: 0;
-}
-
-.vditor-reset p,
-.vditor-reset pre {
-    margin: 1em 0;
-}
-
-.vditor-reset ul > li {
-    margin-left: 20px;
-    padding-left: 4px;
-    list-style-type: circle;
-}
-
-.vditor-reset ol > li {
-    margin-left: 20px;
-    padding-left: 4px;
-    list-style-type: decimal;
-}
-
-.vditor-reset ul > li > p,
-.vditor-reset ol > li > p {
-    margin: 0.2em 0;
-}
-
-.vditor-reset code {
-    margin: 0 1px;
-    padding: .2em .4em;
-    font-size: .9em;
-    border-radius: 3px;
-    border: 1px solid #f0f0f0;
-    font-family: sfmono-regular, Consolas, liberation mono, Menlo, Courier, monospace;
-}
-
-.vditor-reset code:not(.hljs):not(.highlight-chroma) {
-    background: #f2f4f5;
-    color: rgba(0, 0, 0, .65);
-}
-
-.vditor-reset pre {
-    font-family: sfmono-regular, Consolas, liberation mono, Menlo, Courier, monospace;
-    border-radius: 2px;
-}
-
-.vditor-reset .language-abc svg,
-.vditor-reset .language-abc path {
-    fill: currentColor;
-    color: rgba(0, 0, 0, .85);
-}
-
-.vditor-reset .language-graphviz polygon {
-    fill: transparent;
-}
-
-.vditor-reset strong,
-.vditor-reset b {
-    font-weight: 500;
-}
-
-.vditor-reset > table {
-    width: 100%;
-    margin: 8px 0 16px;
-    direction: ltr;
-    empty-cells: show;
-    border: 1px solid #f0f0f0;
-    border-collapse: collapse;
-    border-spacing: 0
-}
-
-.vditor-reset > table th {
-    color: #5c6b77;
-    font-weight: 500;
-    white-space: nowrap;
-    background: rgba(0, 0, 0, .02)
-}
-
-.vditor-reset > table th, .vditor-reset > table td {
-    padding: 16px 24px;
-    text-align: left;
-    border: 1px solid #f0f0f0
-}
-
-.vditor-reset blockquote {
-    margin: 1em 0;
-    padding-left: .8em;
-    color: rgba(0, 0, 0, .45);
-    font-size: 90%;
-    border-left: 4px solid #f0f0f0
-}
-
-.vditor-reset blockquote p {
-    margin: 0;
-}
-
-.vditor-reset .vditor-anchor {
-    margin-left: 8px;
-    opacity: 0;
-    transition: opacity 0.3s;
-}
-
-.vditor-reset h1:hover .vditor-anchor,
-.vditor-reset h2:hover .vditor-anchor,
-.vditor-reset h3:hover .vditor-anchor,
-.vditor-reset h4:hover .vditor-anchor,
-.vditor-reset h5:hover .vditor-anchor,
-.vditor-reset h6:hover .vditor-anchor {
-    display: inline-block;
-    opacity: 1;
-}
-
-.vditor-reset > br,
-.vditor-reset > p > br {
-    clear: both;
-}
-
-.vditor-reset a, .vditor-ir__link {
-    color: #1890ff;
-    text-decoration: none;
-    outline: none;
-    cursor: pointer;
-}

package/dist/vditor/dist/css/content-theme/dark.css

@@ -1,123 +0,0 @@
-/*!
- * Vditor - A markdown editor written in TypeScript.
- *
- * MIT License
- *
- * Copyright (c) 2018-present B3log 开源, b3log.org
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- *
- */
-.vditor-reset {
-    color: #d1d5da;
-}
-
-.vditor-reset a, .vditor-ir__link {
-    color: #4285f4;
-}
-
-.vditor-reset h1, .vditor-reset h2 {
-    padding-bottom: 0.3em;
-    border-bottom: 1px solid #d1d5da
-}
-
-.vditor-reset hr {
-    background-color: #d1d5da
-}
-
-.vditor-reset blockquote {
-    padding: 0 1em;
-    color: #b9b9b9;
-    border-left: .25em solid #d1d5da
-}
-
-.vditor-reset iframe {
-    border: 1px solid #141414
-}
-
-.vditor-reset table tr {
-    background-color: #2f363d
-}
-
-.vditor-reset table td, .vditor-reset table th {
-    border: 1px solid #dfe2e5
-}
-
-.vditor-reset table tbody tr:nth-child(2n) {
-    background-color: #24292e
-}
-
-.vditor-reset code:not(.hljs):not(.highlight-chroma) {
-    background-color: rgba(66, 133, 244, .36);
-}
-
-.vditor-reset .language-abc svg,
-.vditor-reset .language-abc path {
-    fill: currentColor;
-    color: #d1d5da;
-}
-
-.language-graphviz polygon {
-    fill: rgba(66, 133, 244, .36);
-}
-
-.vditor-reset kbd {
-    color: #d1d5da;
-    background-color: #2f363d;
-    border: 1px solid #141414;
-    box-shadow: inset 0 -1px 0 #141414
-}
-
-.vditor-copy svg {
-    color: #b9b9b9
-}
-
-.vditor-speech {
-    background-color: #1d2125;
-    border: 1px solid #141414;
-    color: #b9b9b9
-}
-
-.vditor-speech--current, .vditor-speech:hover {
-    color: #fff
-}
-
-.vditor-linkcard a {
-    background-color: #1d2125;
-}
-
-.vditor-linkcard a:visited .vditor-linkcard__abstract {
-    color: hsla(0, 0%, 72.5%, .36)
-}
-
-.vditor-linkcard__title {
-    color: #d1d5da
-}
-
-.vditor-linkcard__abstract {
-    color: #b9b9b9
-}
-
-.vditor-linkcard__site {
-    color: #fff
-}
-
-.vditor-linkcard__image {
-    background-color: hsla(0, 0%, 72.5%, .36)
-}

package/dist/vditor/dist/css/content-theme/light.css

@@ -1,101 +0,0 @@
-/*!
- * Vditor - A markdown editor written in TypeScript.
- *
- * MIT License
- *
- * Copyright (c) 2018-present B3log 开源, b3log.org
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- *
- */
-.vditor-reset h1, .vditor-reset h2 {
-    padding-bottom: 0.3em;
-    border-bottom: 1px solid #eaecef;
-}
-
-.vditor-reset hr {
-    background-color: #eaecef;
-}
-
-.vditor-reset blockquote {
-    color: #6a737d;
-    border-left: .25em solid #eaecef
-}
-
-.vditor-reset iframe {
-    border: 1px solid #d1d5da
-}
-
-.vditor-reset table tr {
-    border-top: 1px solid #c6cbd1;
-    background-color: #fafbfc
-}
-
-.vditor-reset table td, .vditor-reset table th {
-    border: 1px solid #dfe2e5
-}
-
-.vditor-reset table tbody tr:nth-child(2n) {
-    background-color: #fff
-}
-
-.vditor-reset code:not(.hljs):not(.highlight-chroma) {
-    background-color: rgba(27, 31, 35, .05);
-}
-
-.vditor-reset kbd {
-    color: #24292e;
-    background-color: #fafbfc;
-    border: solid 1px #d1d5da;
-    box-shadow: inset 0 -1px 0 #d1d5da;
-}
-
-.vditor-speech {
-    background-color: #f6f8fa;
-    border: 1px solid #d1d5da;
-    color: #586069;
-}
-
-.vditor-speech--current, .vditor-speech:hover {
-    color: #4285f4;
-}
-
-.vditor-linkcard a {
-    background-color: #f6f8fa;
-}
-
-.vditor-linkcard a:visited .vditor-linkcard__abstract {
-    color: rgba(88, 96, 105, 0.36);
-}
-
-.vditor-linkcard__title {
-    color: #24292e;
-}
-
-.vditor-linkcard__abstract {
-    color: #586069;
-}
-
-.vditor-linkcard__site {
-    color: #4285f4;
-}
-
-.vditor-linkcard__image {
-    background-color: rgba(88, 96, 105, 0.36);
-}