bridgerte 0.9.0 → 0.9.1

package/dist/bridge.d.ts

@@ -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

@@ -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-Bui5UnkQ.cjs"),t=require("./index-DAlyGWXO.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

@@ -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,17 @@ export type ToolbarDragState = {
     hasDragged: boolean;
     startButton?: HTMLButtonElement;
 };
+/**
+ * toolbar 挂载方向。
+ *
+ * createRichTextToolbar 独立实例只负责自身布局，具体位置由宿主挂载容器决定。
+ */
 export type RichTextToolbarPlacement = 'top' | 'bottom';
+/**
+ * 独立 toolbar 创建参数。
+ *
+ * editor 提供命令和状态，schema/config 决定展示结构，icons/menuLabels 只覆盖显示层。
+ */
 export type RichTextToolbarOptions = {
     editor: EditorAPI;
     menuSchema?: MenuItem[];
@@ -915,6 +943,11 @@ export type RichTextToolbarOptions = {
     menuLabels?: MenuLabelOverrides;
     payloadPanelConfig?: PayloadPanelConfig;
 };
+/**
+ * toolbar 实例 API。
+ *
+ * update 手动刷新命令状态，destroy 释放 DOM listener 和命令状态订阅。
+ */
 export type RichTextToolbarAPI = {
     update(): void;
     destroy(): void;
@@ -927,13 +960,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-BQAzp56J.js";
+import { c as i } from "./index-CeYJbOQi.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":";;"}