bridgerte 0.9.21 → 0.9.23

package/dist/webview.d.ts

@@ -455,6 +455,9 @@ export type EditorCommand = {
     type: 'media.pickImage';
 } | {
     type: 'media.pickVideo';
+} | {
+    type: 'media.view';
+    assetId: string;
 } | {
     type: 'media.retry';
     assetId: string;
@@ -677,7 +680,7 @@ export type PayloadPanelSchemaConfig = {
 /**
  * 参数面板配置表。
  *
- * 第一层 key 使用 `PayloadPanelSchema.id`，让 toolbar、hoverbar、code block header、
+ * 第一层 key 使用 `PayloadPanelSchema.id`，让 toolbar、hoverbar、code block 语言 controls、
  * WebView 和业务自绘都能对同一份 panel schema 做一致裁剪。
  */
 export type PayloadPanelConfig = Record<string, PayloadPanelSchemaConfig>;
@@ -723,7 +726,7 @@ export type PayloadPanelRequest = PayloadPanelOpenRequest & {
  * 解析参数面板 schema。
  *
  * 这个纯函数只处理 schema 数据，不理解 DOM、Lexical 或具体命令；toolbar、hoverbar、
- * code block header 和 WebView host request 都应先走这里，保证默认 UI 和业务自绘同源。
+ * code block 语言 controls 和 WebView host request 都应先走这里，保证默认 UI 和业务自绘同源。
  */
 export declare const resolvePayloadPanelSchema: (panel: PayloadPanelSchema, config?: PayloadPanelConfig) => PayloadPanelSchema;
 
@@ -758,6 +761,103 @@ export type FloatingMenusConfig = {
  * 原生菜单可以忽略这个字段并用同一个 key 映射平台 icon。
  */
 export type RichTextEditorIcons = Partial<Record<string, string>>;
+/**
+ * 自绘菜单提交目标。
+ *
+ * 业务侧通常只需要回传 `MenuItem.id`；保留完整 `MenuItem` 是为了 PC/H5 自绘层在同进程内
+ * 直接复用 request.items 中的对象，WebView bridge 仍只通过 id 回传。
+ */
+export type MenuControlSubmitTarget = string | MenuItem;
+export type MenuControlButtonItem = {
+    type: 'button';
+    item: MenuItem;
+    active: boolean;
+    disabled: boolean;
+};
+export type MenuControlSeparatorItem = {
+    type: 'separator';
+    key: string;
+};
+export type MenuControlGroupItem = {
+    type: 'group';
+    key: string;
+    title: string;
+    icon?: string;
+    items: MenuControlButtonItem[];
+};
+/**
+ * 自绘菜单的跨端显示协议。
+ *
+ * DOM 默认 UI、PC/H5 自绘和 RN/Flutter 原生菜单都消费解析后的同一份结构；
+ * 这里不携带 DOM 节点、SVG 字符串或定位实现，只保留 schema/config 解析结果和状态。
+ */
+export type MenuControlDisplayItem = MenuControlButtonItem | MenuControlSeparatorItem | MenuControlGroupItem;
+export type HoverbarMenuRequest = {
+    id: string;
+    items: MenuControlDisplayItem[];
+    commandStates: CommandState[];
+    readonly: boolean;
+    anchorRect?: PayloadPanelOpenRequest['anchorRect'];
+    /**
+     * 订阅这次菜单请求被编辑器侧关闭或替换。
+     *
+     * 宿主自绘菜单可以据此清理自己的浮层；WebView runtime 也用它通知 RN/Flutter
+     * 旧 request 已失效，避免晚到提交命中悬空菜单。
+     */
+    subscribeDismiss(listener: () => void): () => void;
+    submit(target: MenuControlSubmitTarget): void;
+    cancel(): void;
+};
+export type MediaControlsRequest = {
+    id: string;
+    assetId: string;
+    mediaType: 'image' | 'video';
+    status: string;
+    displayWidthPercent: MediaDisplayWidthPercent;
+    align: MediaAlign;
+    items: MenuControlDisplayItem[];
+    readonly: boolean;
+    anchorRect?: PayloadPanelOpenRequest['anchorRect'];
+    /**
+     * 媒体资源 URL。
+     *
+     * 从 DOM 读取，可用于业务自绘层的预览、下载或分享。
+     */
+    url?: string;
+    title?: string;
+    alt?: string;
+    poster?: string;
+    width?: number;
+    height?: number;
+    /** 视频时长（秒），仅 video 节点 loadedmetadata 后可读。 */
+    duration?: number;
+    /** 媒体 MIME 类型，DOM 不保证一定可读。 */
+    mimeType?: string;
+    /** 文件大小（字节），DOM 不保证一定可读。 */
+    size?: number;
+    /**
+     * 订阅这次菜单请求被编辑器侧关闭或替换。
+     *
+     * 媒体节点切换、点击正文或节点销毁都会让旧自绘菜单失效；监听方需要同步关闭外部 UI。
+     */
+    subscribeDismiss(listener: () => void): () => void;
+    submit(target: MenuControlSubmitTarget): void;
+    cancel(): void;
+};
+export type TableControlsRequest = {
+    id: string;
+    items: MenuControlDisplayItem[];
+    readonly: boolean;
+    anchorRect?: PayloadPanelOpenRequest['anchorRect'];
+    /**
+     * 订阅这次菜单请求被编辑器侧关闭或替换。
+     *
+     * 表格激活态变化时会触发 dismiss，保证业务自绘和 DOM 内部 controls 生命周期一致。
+     */
+    subscribeDismiss(listener: () => void): () => void;
+    submit(target: MenuControlSubmitTarget): void;
+    cancel(): void;
+};
 export type RichTextEditorOptions = {
     value?: Partial<EditorContent>;
     readonly?: boolean;
@@ -847,6 +947,26 @@ export type RichTextEditorOptions = {
     slashCommandProvider?: SlashCommandProvider;
     slashCommandMenuConfig?: SlashCommandMenuConfig;
     onSlashCommandMenuRequest?: (request: SlashCommandMenuRequest) => boolean | void;
+    /**
+     * 选中文本 hoverbar 自绘接管。
+     *
+     * 返回 true 时 DOM 不渲染默认 hoverbar；业务侧需要调用 request.submit(id) 执行菜单，
+     * 或调用 request.cancel() 关闭这次自绘菜单。
+     */
+    onHoverbarMenuRequest?: (request: HoverbarMenuRequest) => boolean | void;
+    /**
+     * 图片/视频 overlay controls 自绘接管。
+     *
+     * 返回 true 时 DOM 不渲染默认媒体浮条；同一份 items 可用于 PC/H5 浮窗或 RN/Flutter
+     * 原生面板，提交时回传菜单 id 即可。
+     */
+    onMediaControlsRequest?: (request: MediaControlsRequest) => boolean | void;
+    /**
+     * 表格 controls 自绘接管。
+     *
+     * 返回 true 时 DOM 不渲染默认表格浮条，业务菜单提交后仍复用 BridgeRTE 内部表格命令执行。
+     */
+    onTableControlsRequest?: (request: TableControlsRequest) => boolean | void;
     placeholder?: string;
     maxLength?: number;
     /**
@@ -972,6 +1092,53 @@ export type PayloadPanelRequestPayload = PayloadPanelOpenRequest & {
     id: string;
     readonly: boolean;
 };
+export type MenuRequestKind = 'hoverbar' | 'mediaControls' | 'tableControls';
+export type BaseMenuRequestPayload = {
+    id: string;
+    kind: MenuRequestKind;
+    items: MenuControlDisplayItem[];
+    readonly: boolean;
+    anchorRect?: PayloadPanelOpenRequest['anchorRect'];
+};
+export type HoverbarMenuRequestPayload = BaseMenuRequestPayload & {
+    kind: 'hoverbar';
+    commandStates: HoverbarMenuRequest['commandStates'];
+};
+export type MediaControlsRequestPayload = BaseMenuRequestPayload & {
+    kind: 'mediaControls';
+    assetId: string;
+    mediaType: MediaControlsRequest['mediaType'];
+    status: string;
+    displayWidthPercent: MediaControlsRequest['displayWidthPercent'];
+    align: MediaControlsRequest['align'];
+    /** 媒体资源 URL，可用于原生侧预览、下载或分享。 */
+    url?: string;
+    title?: string;
+    alt?: string;
+    poster?: string;
+    width?: number;
+    height?: number;
+    duration?: number;
+    mimeType?: string;
+    size?: number;
+};
+export type TableControlsRequestPayload = BaseMenuRequestPayload & {
+    kind: 'tableControls';
+};
+/**
+ * 编辑器请求原生侧自绘的菜单。
+ *
+ * payload 不携带 submit/cancel 函数；RN/Flutter 通过 editor.menuResolved 或
+ * editor.menuCanceled 把结果回传给 WebView runtime。
+ */
+export type MenuRequestPayload = HoverbarMenuRequestPayload | MediaControlsRequestPayload | TableControlsRequestPayload;
+export type MenuResolvedPayload = {
+    requestId: string;
+    menuItemId: string;
+};
+export type MenuCanceledPayload = {
+    requestId: string;
+};
 /**
  * 编辑器 ready 后回传给原生侧的初始化结果。
  */
@@ -1012,6 +1179,14 @@ export type NativeToEditorMessage = {
     id: string;
     type: 'editor.payloadPanelCanceled';
     payload: PayloadPanelCanceledPayload;
+} | {
+    id: string;
+    type: 'editor.menuResolved';
+    payload: MenuResolvedPayload;
+} | {
+    id: string;
+    type: 'editor.menuCanceled';
+    payload: MenuCanceledPayload;
 } | {
     id: string;
     type: 'editor.uploadResolved';
@@ -1048,6 +1223,14 @@ export type EditorToNativeMessage = {
     id?: string;
     type: 'editor.payloadPanelRequest';
     payload: PayloadPanelRequestPayload;
+} | {
+    id?: string;
+    type: 'editor.menuRequest';
+    payload: MenuRequestPayload;
+} | {
+    id?: string;
+    type: 'editor.menuCanceled';
+    payload: MenuCanceledPayload;
 } | {
     id?: string;
     type: 'editor.uploadRequest';
@@ -1126,6 +1309,10 @@ export type PendingNativeUpload = {
 export type PendingNativePayloadPanelRequest = {
     request: PayloadPanelRequest;
 };
+export type PendingNativeMenuRequest = {
+    request: HoverbarMenuRequest | MediaControlsRequest | TableControlsRequest;
+    unsubscribeDismiss: () => void;
+};
 /**
  * 原生上传完成消息。
  *

package/dist/webview.js

@@ -1,4 +1,4 @@
-import { b as i } from "./index-BJMFpGLi.js";
+import { b as i } from "./index-CBjqWsRZ.js";
 export {
   i as createWebViewBridgeRuntime
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bridgerte",
-  "version": "0.9.21",
+  "version": "0.9.23",
   "description": "Cross-platform rich text editor with WebView bridge support.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -54,7 +54,7 @@
   "dependencies": {
     "@floating-ui/dom": "^1.7.0",
     "@lexical/code": "^0.45.0",
-    "@lexical/code-shiki": "0.45.0",
+    "@lexical/code-core": "0.45.0",
     "@lexical/history": "^0.45.0",
     "@lexical/html": "^0.45.0",
     "@lexical/link": "^0.45.0",
@@ -63,7 +63,11 @@
     "@lexical/selection": "^0.45.0",
     "@lexical/table": "^0.45.0",
     "@lexical/utils": "^0.45.0",
-    "lexical": "^0.45.0"
+    "@shikijs/core": "4.2.0",
+    "@shikijs/engine-javascript": "4.2.0",
+    "@shikijs/types": "4.2.0",
+    "lexical": "^0.45.0",
+    "shiki": "4.2.0"
   },
   "keywords": [
     "rich-text-editor",