bridgerte 0.9.0 → 0.9.2

package/dist/bridge.d.ts

@@ -170,8 +170,8 @@ export type PasteHook = (request: PasteRequest) => PasteHookResult | Promise<Pas
 /**
  * toolbar JSON 配置里的菜单组。
  *
- * `menuKeys` 使用菜单 schema 的稳定 id，DOM 先按简单横向分组渲染；
- * 后续需要下拉菜单时，可以继续复用这份结构。
+ * `menuKeys` 使用菜单 schema 的稳定 id，DOM 渲染为一个分组入口，
+ * 点击后打开纵向收纳菜单；RN/Flutter/WebView 可按同一结构自绘平台菜单。
  */
 export type ToolbarGroupConfig = {
     key: string;
@@ -756,7 +756,6 @@ export type RichTextEditorIcons = Partial<Record<string, string>>;
 export type RichTextEditorOptions = {
     value?: Partial<EditorContent>;
     readonly?: boolean;
-    platform?: 'pc' | 'h5' | 'webview';
     uploadAdapter?: UploadAdapter;
     /**
      * 媒体节点没有显式 displayWidthPercent 时的默认展示比例。
@@ -764,14 +763,23 @@ export type RichTextEditorOptions = {
      * 默认值是 50；业务可以按产品形态改成 20 或 100，内置 UI 仍只提供固定预设。
      */
     mediaDefaultWidthPercent?: MediaDisplayWidthPercent;
+    /**
+     * @deprecated createRichTextEditor 永远只创建编辑器内容实例。
+     * toolbar/tabbar 请使用 createRichTextToolbar 或原生侧单独渲染；该字段保留为兼容 no-op。
+     */
     toolbarMode?: 'top' | 'bottom' | 'none' | 'native';
     /**
-     * DOM 内置 toolbar/tabbar/hoverbar 使用的菜单 schema。
+     * DOM 内置 hoverbar、slash command 等菜单运行时使用的菜单 schema。
      *
-     * 自定义菜单必须先进入 schema，再由 `toolbarConfig` 或 `hoverbarConfig` 引用；
+     * 自定义菜单必须先进入 schema，再由独立 toolbar 的 `toolbarConfig`、`hoverbarConfig`
+     * 或 slash command 配置引用；
      * 这里不接收 SVG，图标展示仍通过 `icons` 按稳定 icon key 覆盖。
      */
     menuSchema?: MenuItem[];
+    /**
+     * @deprecated editor 不再自动创建 toolbar/tabbar，该字段在 createRichTextEditor 中是 no-op。
+     * 请把 toolbarConfig 传给 createRichTextToolbar(container, { editor, toolbarConfig })。
+     */
     toolbarConfig?: ToolbarConfig;
     /**
      * DOM 内置 hoverbar 的显示结构配置。
@@ -796,7 +804,7 @@ export type RichTextEditorOptions = {
     slashCommandConfig?: ToolbarConfig;
     icons?: RichTextEditorIcons;
     /**
-     * DOM 内置 toolbar/tabbar/hoverbar 的菜单 label 覆盖。
+     * DOM 内置 hoverbar、slash command 以及独立 toolbar/tabbar 的菜单 label 覆盖。
      *
      * key 使用 `MenuItem.id`，只影响按钮文本、tooltip 和 aria-label，不改变命令语义。
      */
@@ -912,7 +920,7 @@ export type BridgeEventTiming = {
  *
  * 只保留可序列化且跨端稳定的字段，避免把函数或宿主对象塞进 bridge。
  */
-export type EditorInitOptions = Pick<RichTextEditorOptions, 'readonly' | 'platform' | 'toolbarMode' | 'placeholder' | 'maxLength' | 'codeBlockLanguagePanel'> & {
+export type EditorInitOptions = Pick<RichTextEditorOptions, 'readonly' | 'placeholder' | 'maxLength' | 'codeBlockLanguagePanel'> & {
     value?: Partial<EditorContent>;
 };
 /**

package/dist/core.d.ts

@@ -170,8 +170,8 @@ export type PasteHook = (request: PasteRequest) => PasteHookResult | Promise<Pas
 /**
  * toolbar JSON 配置里的菜单组。
  *
- * `menuKeys` 使用菜单 schema 的稳定 id，DOM 先按简单横向分组渲染；
- * 后续需要下拉菜单时，可以继续复用这份结构。
+ * `menuKeys` 使用菜单 schema 的稳定 id，DOM 渲染为一个分组入口，
+ * 点击后打开纵向收纳菜单；RN/Flutter/WebView 可按同一结构自绘平台菜单。
  */
 export type ToolbarGroupConfig = {
     key: string;
@@ -756,7 +756,6 @@ export type RichTextEditorIcons = Partial<Record<string, string>>;
 export type RichTextEditorOptions = {
     value?: Partial<EditorContent>;
     readonly?: boolean;
-    platform?: 'pc' | 'h5' | 'webview';
     uploadAdapter?: UploadAdapter;
     /**
      * 媒体节点没有显式 displayWidthPercent 时的默认展示比例。
@@ -764,14 +763,23 @@ export type RichTextEditorOptions = {
      * 默认值是 50；业务可以按产品形态改成 20 或 100，内置 UI 仍只提供固定预设。
      */
     mediaDefaultWidthPercent?: MediaDisplayWidthPercent;
+    /**
+     * @deprecated createRichTextEditor 永远只创建编辑器内容实例。
+     * toolbar/tabbar 请使用 createRichTextToolbar 或原生侧单独渲染；该字段保留为兼容 no-op。
+     */
     toolbarMode?: 'top' | 'bottom' | 'none' | 'native';
     /**
-     * DOM 内置 toolbar/tabbar/hoverbar 使用的菜单 schema。
+     * DOM 内置 hoverbar、slash command 等菜单运行时使用的菜单 schema。
      *
-     * 自定义菜单必须先进入 schema，再由 `toolbarConfig` 或 `hoverbarConfig` 引用；
+     * 自定义菜单必须先进入 schema，再由独立 toolbar 的 `toolbarConfig`、`hoverbarConfig`
+     * 或 slash command 配置引用；
      * 这里不接收 SVG，图标展示仍通过 `icons` 按稳定 icon key 覆盖。
      */
     menuSchema?: MenuItem[];
+    /**
+     * @deprecated editor 不再自动创建 toolbar/tabbar，该字段在 createRichTextEditor 中是 no-op。
+     * 请把 toolbarConfig 传给 createRichTextToolbar(container, { editor, toolbarConfig })。
+     */
     toolbarConfig?: ToolbarConfig;
     /**
      * DOM 内置 hoverbar 的显示结构配置。
@@ -796,7 +804,7 @@ export type RichTextEditorOptions = {
     slashCommandConfig?: ToolbarConfig;
     icons?: RichTextEditorIcons;
     /**
-     * DOM 内置 toolbar/tabbar/hoverbar 的菜单 label 覆盖。
+     * DOM 内置 hoverbar、slash command 以及独立 toolbar/tabbar 的菜单 label 覆盖。
      *
      * key 使用 `MenuItem.id`，只影响按钮文本、tooltip 和 aria-label，不改变命令语义。
      */

package/dist/dom.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-BDgKCpty.cjs");exports.createFloatingLayer=e.createFloatingLayer;exports.createRichTextEditor=e.createRichTextEditor;exports.createRichTextToolbar=e.createRichTextToolbar;exports.createWebViewBridgeRuntime=e.createWebViewBridgeRuntime;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-CkgUKPh3.cjs"),t=require("./index-CqOH1_5N.cjs");exports.createFloatingLayer=e.createFloatingLayer;exports.createRichTextEditor=e.createRichTextEditor;exports.createWebViewBridgeRuntime=e.createWebViewBridgeRuntime;exports.createRichTextToolbar=t.createRichTextToolbar;
 //# sourceMappingURL=dom.cjs.map

package/dist/dom.d.ts

@@ -170,8 +170,8 @@ export type PasteHook = (request: PasteRequest) => PasteHookResult | Promise<Pas
 /**
  * toolbar JSON 配置里的菜单组。
  *
- * `menuKeys` 使用菜单 schema 的稳定 id，DOM 先按简单横向分组渲染；
- * 后续需要下拉菜单时，可以继续复用这份结构。
+ * `menuKeys` 使用菜单 schema 的稳定 id，DOM 渲染为一个分组入口，
+ * 点击后打开纵向收纳菜单；RN/Flutter/WebView 可按同一结构自绘平台菜单。
  */
 export type ToolbarGroupConfig = {
     key: string;
@@ -756,7 +756,6 @@ export type RichTextEditorIcons = Partial<Record<string, string>>;
 export type RichTextEditorOptions = {
     value?: Partial<EditorContent>;
     readonly?: boolean;
-    platform?: 'pc' | 'h5' | 'webview';
     uploadAdapter?: UploadAdapter;
     /**
      * 媒体节点没有显式 displayWidthPercent 时的默认展示比例。
@@ -764,14 +763,23 @@ export type RichTextEditorOptions = {
      * 默认值是 50；业务可以按产品形态改成 20 或 100，内置 UI 仍只提供固定预设。
      */
     mediaDefaultWidthPercent?: MediaDisplayWidthPercent;
+    /**
+     * @deprecated createRichTextEditor 永远只创建编辑器内容实例。
+     * toolbar/tabbar 请使用 createRichTextToolbar 或原生侧单独渲染；该字段保留为兼容 no-op。
+     */
     toolbarMode?: 'top' | 'bottom' | 'none' | 'native';
     /**
-     * DOM 内置 toolbar/tabbar/hoverbar 使用的菜单 schema。
+     * DOM 内置 hoverbar、slash command 等菜单运行时使用的菜单 schema。
      *
-     * 自定义菜单必须先进入 schema，再由 `toolbarConfig` 或 `hoverbarConfig` 引用；
+     * 自定义菜单必须先进入 schema，再由独立 toolbar 的 `toolbarConfig`、`hoverbarConfig`
+     * 或 slash command 配置引用；
      * 这里不接收 SVG，图标展示仍通过 `icons` 按稳定 icon key 覆盖。
      */
     menuSchema?: MenuItem[];
+    /**
+     * @deprecated editor 不再自动创建 toolbar/tabbar，该字段在 createRichTextEditor 中是 no-op。
+     * 请把 toolbarConfig 传给 createRichTextToolbar(container, { editor, toolbarConfig })。
+     */
     toolbarConfig?: ToolbarConfig;
     /**
      * DOM 内置 hoverbar 的显示结构配置。
@@ -796,7 +804,7 @@ export type RichTextEditorOptions = {
     slashCommandConfig?: ToolbarConfig;
     icons?: RichTextEditorIcons;
     /**
-     * DOM 内置 toolbar/tabbar/hoverbar 的菜单 label 覆盖。
+     * DOM 内置 hoverbar、slash command 以及独立 toolbar/tabbar 的菜单 label 覆盖。
      *
      * key 使用 `MenuItem.id`，只影响按钮文本、tooltip 和 aria-label，不改变命令语义。
      */
@@ -897,7 +905,17 @@ export declare const BRIDGERTE_CONTENT_VERSION = "0.1.0";
 export declare const BRIDGERTE_TABLE_INSERT_MAX_ROWS = 20;
 export declare const BRIDGERTE_TABLE_INSERT_MAX_COLS = 20;
 
+/**
+ * toolbar icon 覆盖表。
+ *
+ * key 对应 MenuItem.icon 稳定 key，value 是 DOM 侧渲染用 SVG 字符串。
+ */
 export type RichTextToolbarIcons = RichTextEditorIcons;
+/**
+ * toolbar 横向拖动状态。
+ *
+ * PC/H5 都用同一套 pointer 数据，hasDragged 用于区分拖动滚动和真实点击。
+ */
 export type ToolbarDragState = {
     startClientX: number;
     startScrollLeft: number;
@@ -905,7 +923,27 @@ export type ToolbarDragState = {
     hasDragged: boolean;
     startButton?: HTMLButtonElement;
 };
+/**
+ * toolbar 分组收纳菜单打开状态。
+ *
+ * groupKey 对应 ToolbarGroupConfig.key；触发按钮用于定位固定浮层，menu 保存当前组内可执行子项。
+ */
+export type ToolbarGroupMenuState = {
+    groupKey: string;
+    button: HTMLButtonElement;
+    items: MenuItem[];
+};
+/**
+ * toolbar 挂载方向。
+ *
+ * createRichTextToolbar 独立实例只负责自身布局，具体位置由宿主挂载容器决定。
+ */
 export type RichTextToolbarPlacement = 'top' | 'bottom';
+/**
+ * 独立 toolbar 创建参数。
+ *
+ * editor 提供命令和状态，schema/config 决定展示结构，icons/menuLabels 只覆盖显示层。
+ */
 export type RichTextToolbarOptions = {
     editor: EditorAPI;
     menuSchema?: MenuItem[];
@@ -915,6 +953,11 @@ export type RichTextToolbarOptions = {
     menuLabels?: MenuLabelOverrides;
     payloadPanelConfig?: PayloadPanelConfig;
 };
+/**
+ * toolbar 实例 API。
+ *
+ * update 手动刷新命令状态，destroy 释放 DOM listener 和命令状态订阅。
+ */
 export type RichTextToolbarAPI = {
     update(): void;
     destroy(): void;
@@ -927,13 +970,28 @@ export type RichTextToolbarAPI = {
  */
 export declare function createRichTextToolbar(container: HTMLElement, options: RichTextToolbarOptions): RichTextToolbarAPI;
 
+/**
+ * 浮层相对锚点的放置方向。
+ *
+ * 语义对齐 floating-ui placement，方便 DOM 默认层和业务自绘使用同一套位置配置。
+ */
 export type RichTextFloatingPlacement = 'top' | 'top-start' | 'top-end' | 'right' | 'right-start' | 'right-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'left-start' | 'left-end';
+/**
+ * 通用浮层创建选项。
+ *
+ * root 由实现层持有；这里仅描述定位策略、偏移和边界 padding。
+ */
 export type RichTextFloatingLayerOptions = {
     placement?: RichTextFloatingPlacement;
     offset?: number;
     shiftPadding?: number;
     strategy?: 'absolute' | 'fixed';
 };
+/**
+ * 通用浮层实例。
+ *
+ * update 会重新计算位置，destroy 释放 floating-ui autoUpdate 和 DOM 引用。
+ */
 export type RichTextFloatingLayer = {
     update(): Promise<void>;
     setOpen(open: boolean): void;

package/dist/dom.js

@@ -1,8 +1,9 @@
-import { c as r, a as t, b as c, d as i } from "./index-C7IVE5Bd.js";
+import { c as r, a as t, b as c } from "./index-KRuLtGv9.js";
+import { c as i } from "./index-DRWIM218.js";
 export {
   r as createFloatingLayer,
   t as createRichTextEditor,
-  c as createRichTextToolbar,
-  i as createWebViewBridgeRuntime
+  i as createRichTextToolbar,
+  c as createWebViewBridgeRuntime
 };
 //# sourceMappingURL=dom.js.map

package/dist/dom.js.map

@@ -1 +1 @@
-{"version":3,"file":"dom.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}
+{"version":3,"file":"dom.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}