weboffice-js-sdk 2.0.5-beta.13 → 2.0.5-beta.15

package/README.md

@@ -47,27 +47,6 @@ connect({
 - `disableAiEntry` 为可选布尔值，透传到 iframe 内 `OfficeSDK` 的 AI 入口开关能力。
 - `theme` 为可选主题对象，宿主侧仅负责透传；未传时 iframe 内仍使用默认主题配置。
 
-### V2 统一编辑 / 预览入口
-
-V2 使用独立的 `connectV2()`，旧 `connect()` 保持兼容。V2 要求 `type` 和 `mode` 必填：
-
-```typescript
-import { connectV2 } from 'weboffice-js-sdk'
-
-const sdk = await connectV2({
-  fileId: 'your-file-id',
-  endpoint: 'https://your-shimo-endpoint',
-  signature: 'your-signature',
-  token: 'your-token',
-  container: document.querySelector('#shimo-file'),
-  type: 'writer',
-  mode: 'edit',
-  refreshCredentialsInterval: 600000
-})
-```
-
-支持的 `type` 包括 `file`、`document`、`documentPro`、`writer`、`spreadsheet`、`presentation`、`table` 和 `form`。`writer` 与 `documentPro` 当前共存，`writer` 目前处于内测阶段。当前 `type` 主要作为 iframe 后续基于 `manifest.json` 选择资源的预留字段，不改变后端编辑准备判断。
-
 返回值：
 
 ```

package/dist/OfficeSDK.d.ts

@@ -9,11 +9,12 @@ import { Document, DocumentPro, Presentation, Spreadsheet, Table, Form, Flowchar
 import { EmptyPageOptions } from './types/EmptyPage';
 import { BaseEditor } from './types/BaseEditor';
 import { SlashMenuOptions } from './types/SlashMenu';
-import type { ContentVersion } from './types/ConnectV2';
-import type { CollaboratorFacade, CommentsFacade, ContentFacade, DiscussionFacade, DocsOutlineFacade, DocsSearchFacade, DocsSelectionFacade, DocsSettingsFacade, DocsSidebarFacade, DocsTablesFacade, ExternalAppFacade, HistoryFacade, LocksFacade, MentionFacade, OfficeSDKPresentationFacade, PresentationEventSubscriptionFacade, PresentationSelectionFacade, PresentationSlidesFacade, PresentationTextFacade, PresentationZoomFacade, SheetChartsFacade, SheetSelectionsFacade, SheetWorkbookFacade, SheetWorksheetFacade, TitleFacade, VersionFacade } from './OfficeSDK.facade.types';
+import type { CollaboratorFacade, CommentsFacade, ContentFacade, DiscussionFacade, DocsActiveOutlineFacade, DocsOutlineFacade, DocsSearchFacade, DocsSelectionFacade, DocsSettingsFacade, DocsSidebarFacade, DocsTablesFacade, ExternalAppFacade, HistoryFacade, LocksFacade, MentionFacade, OfficeSDKPresentationFacade, PresentationEventSubscriptionFacade, PresentationSelectionFacade, PresentationSlidesFacade, PresentationTextFacade, PresentationZoomFacade, SheetChartsFacade, SheetSelectionsFacade, SheetWorkbookFacade, SheetWorksheetFacade, TitleFacade, VersionFacade } from './OfficeSDK.facade.types';
+import type { OfficeSDKMethodPath } from './OfficeSDK.methods';
 import type { HeaderBarsFacade } from './OfficeSDK.headerBars';
 export * from './OfficeSDK.facade.types';
 export * from './OfficeSDK.headerBars';
+export { toHeaderBarsCallbackAnchorRect } from './headerBarsAnchor';
 export declare const MessageEvent: typeof InvokeMethod;
 export declare class OfficeSDK extends TinyEmitter {
     /**
@@ -37,6 +38,12 @@ export declare class OfficeSDK extends TinyEmitter {
      * @deprecated - 用 `sdk.getEditor<T>()` 替代
      */
     spreadsheet?: Spreadsheet.Editor;
+    /** 当前轻文档的标准化、强类型文档入口。 */
+    ActiveOutline?: DocsActiveOutlineFacade;
+    /**
+     * 判断当前套件和 iframe runtime 是否支持指定的公开 SDK 方法。
+     */
+    canIUse(method: OfficeSDKMethodPath): Promise<boolean>;
     /**
      * 当前套件支持的标题能力。
      */
@@ -178,7 +185,6 @@ export declare class OfficeSDK extends TinyEmitter {
     private readonly emitter;
     private channel;
     private readonly connectOptions;
-    private readonly contentVersion?;
     private _readyState;
     private editor;
     private readonly startParams;
@@ -198,6 +204,8 @@ export declare class OfficeSDK extends TinyEmitter {
     private headerBarsVisible;
     private readonly headerBarsCommands;
     private readonly headerBarsCommandOverrides;
+    private readonly headerBarsCommandEventOverrides;
+    private headerBarsCapabilities;
     private readonly slashMenuCallbacks;
     private readonly editorFacadeCallbacks;
     private readonly headerBarsCommandRefs;
@@ -208,15 +216,10 @@ export declare class OfficeSDK extends TinyEmitter {
      * 归一化后的缺省页配置，构造时一次算完，后续仅读取。
      */
     private readonly normalizedEmptyPage;
-    private readonly preloadCredentialsMessageHandler;
-    private pendingInitializationErrorHandler?;
-    private pendingInitializationError?;
-    private preloadCredentialsPromise?;
-    private disconnected;
     private readonly preloadAckTimeoutMs;
     private readonly preloadDoneTimeoutMs;
     private readonly preloadReadyTimeoutMs;
-    constructor(options: OfficeSDKOptions, contentVersion?: ContentVersion);
+    constructor(options: OfficeSDKOptions);
     get fileType(): FileType;
     get readyState(): ReadyState;
     /**
@@ -285,8 +288,6 @@ export declare class OfficeSDK extends TinyEmitter {
      */
     ready(): Promise<void>;
     private initIframe;
-    private handlePreloadMessage;
-    private getPreloadCredentials;
     private runPreloadHandshake;
     private initChannel;
     /**
@@ -301,6 +302,11 @@ export declare class OfficeSDK extends TinyEmitter {
      */
     private ensureHeaderBarsTitleChangeSubscription;
     private invokeHeaderBars;
+    /**
+     * 将 iframe viewport 坐标转换为宿主 window viewport 坐标。
+     * 输入为 iframe 内事件矩形；输出不包含任何 DOM 对象。
+     */
+    private toHeaderBarsCallbackAnchorRect;
     private syncHeaderBarsCommands;
     private createHeaderBarsHost;
     private applyHeaderBarsChanged;
@@ -319,6 +325,7 @@ export declare class OfficeSDK extends TinyEmitter {
      * 输出：无。
      */
     private unregisterEditorFacadeCallback;
+    private reportEditorFacadeError;
     /**
      * 创建基于 method-path 的模块 facade。
      * 输入：模块前缀与少量自定义实现覆盖。

package/dist/OfficeSDK.facade.d.ts

@@ -10,6 +10,7 @@ interface FacadeHost {
     registerEditorFacadeListener<T>(method: string, listener: (payload: T) => void): () => void;
     registerEditorFacadeCallback(callback: EditorFacadeCallback): string;
     unregisterEditorFacadeCallback(callbackId: string): void;
+    reportEditorFacadeError(message: string, error: unknown): void;
 }
 export declare function buildRootFacadeState(host: FacadeHost): OfficeSDKRootFacadeState;
 export {};

package/dist/OfficeSDK.facade.types.d.ts

@@ -3,6 +3,90 @@ export interface TitleFacade {
     addChangedListener: (listener: (title: string) => void) => () => void;
     setTitle: (title: string) => Promise<void>;
 }
+/**
+ * 可安全跨 iframe 传输的文档 Delta 快照。
+ *
+ * 这里只公开序列化结果和基础元数据，不承诺编辑器运行时对象上的
+ * compose / transform 等方法。
+ */
+export interface DocsEditorDeltaSnapshot {
+    length: number;
+    serialized: string;
+    stringify: () => string;
+}
+export interface DocsDocumentPermission {
+    read: boolean;
+    write: boolean;
+    comment: boolean;
+}
+export type DocsDownloadDocumentType = 'pdf' | 'word' | 'image' | 'md';
+export interface DocsProductFontFacade {
+    SetTextColor: (color: string) => Promise<boolean>;
+    SetHighLightColor: (color: string) => Promise<boolean>;
+    SetBold: (value?: boolean) => Promise<boolean>;
+    SetItalic: (value?: boolean) => Promise<boolean>;
+    SetUnderline: (value?: boolean) => Promise<boolean>;
+    SetStrike: (value?: boolean) => Promise<boolean>;
+}
+export interface DocsProductMarkdownFacade {
+    GetMarkdown: () => Promise<string>;
+    AppendMarkdown: (value: string) => Promise<DocsRangeValue>;
+    InsertMarkdown: (value: string) => Promise<DocsRangeValue>;
+    ValidateMarkdown: (value: string) => Promise<boolean>;
+}
+export interface DocsProductContentFacade {
+    ReplaceSelection: (value: string) => Promise<boolean>;
+    ReplaceAllContent: (value: string) => Promise<boolean>;
+}
+export interface DocsProductDocumentFacade {
+    GetContent: () => Promise<DocsEditorDeltaSnapshot>;
+    GetTitleContent: () => Promise<string>;
+    SetTitleContent: (title: string) => Promise<void>;
+    Font: DocsProductFontFacade;
+    Markdown: DocsProductMarkdownFacade;
+    Content: DocsProductContentFacade;
+}
+export interface DocsProductEditorFacade {
+    GetEditMode: () => Promise<string>;
+    Document: DocsProductDocumentFacade;
+}
+export interface DocsActiveOutlineFacade {
+    Editor: DocsProductEditorFacade;
+    Service: DocsProductServiceFacade;
+    Sub: DocsProductSubFacade;
+    Env: DocsProductEnvFacade;
+}
+export interface DocsProductUserFacade {
+    GetUserInfo: () => Promise<unknown>;
+}
+export interface DocsProductPermissionFacade {
+    GetDocumentPermission: () => Promise<DocsDocumentPermission>;
+}
+export interface DocsProductExportFacade {
+    DownloadDocument: (format: DocsDownloadDocumentType) => Promise<void>;
+}
+export interface DocsProductCollaborationFacade {
+    GetSaveStatus: () => Promise<unknown>;
+}
+export interface DocsProductServiceFacade {
+    User: DocsProductUserFacade;
+    Permission: DocsProductPermissionFacade;
+    Export: DocsProductExportFacade;
+    Collaboration: DocsProductCollaborationFacade;
+}
+export interface DocsProductSubFacade {
+    OnDocumentChange: (handler: (delta: DocsEditorDeltaSnapshot) => void) => () => void;
+}
+export interface DocsProductLanguageFacade {
+    GetLanguage: () => Promise<string>;
+}
+export interface DocsProductModeFacade {
+    GetDocsMode: () => Promise<string>;
+}
+export interface DocsProductEnvFacade {
+    Language: DocsProductLanguageFacade;
+    DocsMode: DocsProductModeFacade;
+}
 export interface CommentsFacade {
     show: (type?: 'list' | 'card') => Promise<void>;
     hide: (type?: 'list' | 'card') => Promise<void>;
@@ -830,6 +914,7 @@ export interface PresentationEventSubscriptionFacade {
     addLoadedListener: (listener: () => void) => () => void;
 }
 export interface OfficeSDKRootFacadeState {
+    ActiveOutline?: DocsActiveOutlineFacade;
     title?: TitleFacade;
     history?: HistoryFacade;
     comments?: CommentsFacade;

package/dist/OfficeSDK.headerBars.d.ts

@@ -1,4 +1,5 @@
 export declare const HEADER_BARS_METHOD: {
+    readonly getCapabilities: "headerBars.getCapabilities";
     readonly getVisible: "headerBars.getVisible";
     readonly setVisible: "headerBars.setVisible";
     readonly addCommand: "headerBars.addCommand";
@@ -12,6 +13,12 @@ export declare const HEADER_BARS_METHOD: {
     readonly setCommandCallbackEnabled: "headerBars.setCommandCallbackEnabled";
     readonly listViewCommands: "headerBars.listViewCommands";
     readonly handleCommandClick: "headerBars.handleCommandClick";
+    readonly addCommands: "headerBars.addCommands";
+    readonly setSectionVisible: "headerBars.setSectionVisible";
+    readonly setCommandOptions: "headerBars.setCommandOptions";
+    readonly setCommandOpen: "headerBars.setCommandOpen";
+    readonly setCommandEventCallbackEnabled: "headerBars.setCommandEventCallbackEnabled";
+    readonly handleCommandEvent: "headerBars.handleCommandEvent";
 };
 export declare const HEADER_BARS_CHANGED_EVENT = "headerBars:changed";
 export interface HeaderBarsCommandDefinition {
@@ -26,10 +33,21 @@ export interface HeaderBarsCommandDefinition {
     type?: 'action' | 'structural';
     renderType?: string;
     src?: string;
+    danger?: boolean;
+    disabledTip?: string;
+    itemType?: 'command' | 'divider';
+    trigger?: 'hover' | 'click';
+    open?: boolean;
+    style?: HeaderBarsCommandStyle;
+    toast?: Record<string, unknown>;
+    subItems?: HeaderBarsCommandDefinition[];
     onClick?: () => void | Promise<void>;
+    onOpen?: HeaderBarsCommandOpenHandler;
+    onClose?: HeaderBarsCommandCloseHandler;
 }
 export interface HeaderBarsCommandState extends HeaderBarsCommandDefinition {
     type: 'action' | 'structural';
+    open?: boolean;
 }
 export interface HeaderBarsCommandRef {
     readonly id: string;
@@ -39,9 +57,87 @@ export interface HeaderBarsCommandRef {
     src?: string;
     label?: string;
     editable?: boolean;
+    open: boolean;
+    style?: HeaderBarsCommandStyle;
+    subItems?: HeaderBarsCommandDefinition[];
     onCommandClick?: () => void | Promise<void>;
+    onCommandOpen?: HeaderBarsCommandOpenHandler;
+    onCommandClose?: HeaderBarsCommandCloseHandler;
     getState: () => HeaderBarsCommandState | undefined;
 }
+export interface HeaderBarsCommandStyle {
+    color?: string;
+    fontSize?: number;
+    fontWeight?: number;
+    backgroundColor?: string;
+    borderColor?: string;
+    borderWidth?: number;
+    borderRadius?: number;
+    width?: number;
+    height?: number;
+}
+export interface HeaderBarsAnchorRect {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+    width: number;
+    height: number;
+    viewport: {
+        width: number;
+        height: number;
+    };
+    coordinateSpace: 'callback-window-viewport';
+}
+export interface HeaderBarsSourceAnchorRect {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+    width: number;
+    height: number;
+    viewport: {
+        width: number;
+        height: number;
+    };
+    coordinateSpace: 'sdk-iframe-viewport';
+}
+export interface HeaderBarsCommandEventPayload {
+    requestId: string;
+    sequence: number;
+    commandId: string;
+    event: 'click' | 'open' | 'close';
+    anchorRect: HeaderBarsSourceAnchorRect;
+    context?: Record<string, unknown>;
+}
+export type HeaderBarsCommandEventResult = 'handled' | 'unhandled' | 'failed' | 'timedOut';
+export interface HeaderBarsCommandEvent {
+    commandId: string;
+    event: 'click' | 'open' | 'close';
+    anchorRect: HeaderBarsAnchorRect;
+    context?: Record<string, unknown>;
+}
+export type HeaderBarsCommandClickHandler = (event?: HeaderBarsCommandEvent) => void | Promise<void>;
+export type HeaderBarsCommandOpenHandler = (commandId: string, anchorRect: HeaderBarsAnchorRect, context: Record<string, unknown>) => void | Promise<void>;
+export type HeaderBarsCommandCloseHandler = HeaderBarsCommandOpenHandler;
+type HeaderBarsEventHandler = (...args: any[]) => void | Promise<void>;
+export interface HeaderBarsCapabilities {
+    protocolVersion: 1 | 2;
+    features: {
+        treeCommands: boolean;
+        batchCommands: boolean;
+        sectionVisibility: boolean;
+        commandOptions: boolean;
+        commandOpenState: boolean;
+        commandEvents: boolean;
+        anchorEvents: boolean;
+    };
+}
+export interface HeaderBarsMutationResult {
+    success: boolean;
+    code?: string;
+    message?: string;
+}
 export type HeaderBarsTitleChangeHandler = (title: string) => void | Promise<void>;
 export interface HeaderBarsFacade {
     visible: boolean;
@@ -51,6 +147,9 @@ export interface HeaderBarsFacade {
     addCommand: (command: HeaderBarsCommandDefinition, posCommand: string, pos?: 'before' | 'after') => Promise<boolean>;
     getCommand: (id: string) => HeaderBarsCommandRef;
     listViewCommands: () => Promise<HeaderBarsCommandState[]>;
+    getCapabilities: () => Promise<HeaderBarsCapabilities>;
+    addCommands: (commands: HeaderBarsCommandDefinition[], posCommand: string, pos?: 'before' | 'after') => Promise<HeaderBarsMutationResult>;
+    setSectionVisible: (section: 'left' | 'right', visible: boolean) => Promise<HeaderBarsMutationResult>;
 }
 export interface HeaderBarsChangedPayload {
     reason?: string;
@@ -66,6 +165,10 @@ interface HeaderBarsHost {
     setVisibleState(visible: boolean): void;
     getCommandsMap(): Map<string, HeaderBarsCommandState>;
     getOverridesMap(): Map<string, (() => void | Promise<void>) | undefined>;
+    getEventOverridesMap(): Map<string, HeaderBarsEventHandler | undefined>;
+    getCapabilitiesState(): HeaderBarsCapabilities;
+    setCapabilitiesState(capabilities: HeaderBarsCapabilities): void;
+    getIframeElement(): HTMLElement | null;
     getRefsMap(): Map<string, HeaderBarsCommandRef>;
     getTitleHandler(): HeaderBarsTitleChangeHandler | undefined;
     setTitleHandler(handler: HeaderBarsTitleChangeHandler | undefined): void;

package/dist/OfficeSDK.methods.d.ts

@@ -0,0 +1,67 @@
+/**
+ * SDK capability method identifiers.
+ *
+ * Values are public SDK method paths. Keeping the object tree aligned with the
+ * public facade makes the accepted canIUse arguments discoverable without
+ * exposing product-specific API namespaces.
+ */
+export declare const OfficeSDKMethods: {
+    readonly ActiveOutline: {
+        readonly Editor: {
+            readonly GetEditMode: "ActiveOutline.Editor.GetEditMode";
+            readonly Document: {
+                readonly GetContent: "ActiveOutline.Editor.Document.GetContent";
+                readonly GetTitleContent: "ActiveOutline.Editor.Document.GetTitleContent";
+                readonly SetTitleContent: "ActiveOutline.Editor.Document.SetTitleContent";
+                readonly Font: {
+                    readonly SetTextColor: "ActiveOutline.Editor.Document.Font.SetTextColor";
+                    readonly SetHighLightColor: "ActiveOutline.Editor.Document.Font.SetHighLightColor";
+                    readonly SetBold: "ActiveOutline.Editor.Document.Font.SetBold";
+                    readonly SetItalic: "ActiveOutline.Editor.Document.Font.SetItalic";
+                    readonly SetUnderline: "ActiveOutline.Editor.Document.Font.SetUnderline";
+                    readonly SetStrike: "ActiveOutline.Editor.Document.Font.SetStrike";
+                };
+                readonly Markdown: {
+                    readonly GetMarkdown: "ActiveOutline.Editor.Document.Markdown.GetMarkdown";
+                    readonly AppendMarkdown: "ActiveOutline.Editor.Document.Markdown.AppendMarkdown";
+                    readonly InsertMarkdown: "ActiveOutline.Editor.Document.Markdown.InsertMarkdown";
+                    readonly ValidateMarkdown: "ActiveOutline.Editor.Document.Markdown.ValidateMarkdown";
+                };
+                readonly Content: {
+                    readonly ReplaceSelection: "ActiveOutline.Editor.Document.Content.ReplaceSelection";
+                    readonly ReplaceAllContent: "ActiveOutline.Editor.Document.Content.ReplaceAllContent";
+                };
+            };
+        };
+        readonly Service: {
+            readonly User: {
+                readonly GetUserInfo: "ActiveOutline.Service.User.GetUserInfo";
+            };
+            readonly Permission: {
+                readonly GetDocumentPermission: "ActiveOutline.Service.Permission.GetDocumentPermission";
+            };
+            readonly Export: {
+                readonly DownloadDocument: "ActiveOutline.Service.Export.DownloadDocument";
+            };
+            readonly Collaboration: {
+                readonly GetSaveStatus: "ActiveOutline.Service.Collaboration.GetSaveStatus";
+            };
+        };
+        readonly Env: {
+            readonly Language: {
+                readonly GetLanguage: "ActiveOutline.Env.Language.GetLanguage";
+            };
+            readonly DocsMode: {
+                readonly GetDocsMode: "ActiveOutline.Env.DocsMode.GetDocsMode";
+            };
+        };
+        readonly Sub: {
+            readonly OnDocumentChange: "ActiveOutline.Sub.OnDocumentChange";
+        };
+    };
+};
+type LeafValues<T> = T extends string ? T : T extends object ? {
+    [K in keyof T]: LeafValues<T[K]>;
+}[keyof T] : never;
+export type OfficeSDKMethodPath = LeafValues<typeof OfficeSDKMethods>;
+export {};

package/dist/connect.d.ts

@@ -1,19 +1,6 @@
 import { OfficeSDK, OfficeSDKOptions } from './OfficeSDK';
-import { type ConnectV2FileType } from './types/ConnectV2';
-export { CONNECT_V2_FILE_TYPES, isConnectV2FileType, isConnectV2Mode, validateConnectV2Options } from './types/ConnectV2';
-export type { ConnectV2FileType } from './types/ConnectV2';
 export interface ConnectOptions extends OfficeSDKOptions {
 }
-export interface ConnectV2Options extends ConnectOptions {
-    /**
-     * V2 套件类型。当前用于 iframe 侧资源选择预留。
-     */
-    type: ConnectV2FileType;
-    /**
-     * V2 打开模式。
-     */
-    mode: 'edit' | 'preview';
-}
 /**
  * 初始化 SDK，返回 Promise，当 ReadState 变为 Ready 或 Failed 时，Promise 将被 resolve。
  * Promise resovled 不代表编辑器已经完整加载完毕，只代表 SDK 已经准备好了。
@@ -21,9 +8,3 @@ export interface ConnectV2Options extends ConnectOptions {
  * 比如受浏览器限制无法发出 postMessage() 时，Promise 将会一直 pending。
  */
 export declare function connect(options: ConnectOptions): Promise<OfficeSDK>;
-/**
- * 初始化 V2 统一编辑 / 预览入口。
- *
- * V2 在运行时强制校验 type 和 mode，底层 iframe 初始化流程与旧 connect 共用。
- */
-export declare function connectV2(options: ConnectV2Options): Promise<OfficeSDK>;

package/dist/editorFacade.contract.d.ts

@@ -1,4 +1,5 @@
-import type { AddChartFromSelectionResult, BasicPresentationFacade, DocsRangeFacade, DocsRangeValue, DocsTableFacade, EditorTextFormat, OfficeSDK, PresentationFacade, PresentationSlideFacade, PresentationShape, PresentationShapeBase, PresentationTableCell, PresentationTableItem, PresentationTableRange, PresentationTableSelection, PresentationTextShape, PresentationTextRangeFacade, PresentationTextRangeValue, SheetRangeValue, SheetRangeFacade, SheetSelection } from './OfficeSDK';
+import type { AddChartFromSelectionResult, BasicPresentationFacade, DocsActiveOutlineFacade, DocsEditorDeltaSnapshot, DocsRangeFacade, DocsRangeValue, DocsTableFacade, EditorTextFormat, OfficeSDK, PresentationFacade, PresentationSlideFacade, PresentationShape, PresentationShapeBase, PresentationTableCell, PresentationTableItem, PresentationTableRange, PresentationTableSelection, PresentationTextShape, PresentationTextRangeFacade, PresentationTextRangeValue, SheetRangeValue, SheetRangeFacade, SheetSelection } from './OfficeSDK';
+import type { OfficeSDKMethodPath } from './OfficeSDK.methods';
 type IsAssignable<T, U> = T extends U ? true : false;
 type IsEqual<T, U> = (<V>() => V extends T ? 1 : 2) extends <V>() => V extends U ? 1 : 2 ? (<V>() => V extends U ? 1 : 2) extends <V>() => V extends T ? 1 : 2 ? true : false : false;
 type Assert<T extends true> = T;
@@ -11,6 +12,13 @@ type PresentationSelection = Extract<RootSelection, {
 }>;
 type RootPresentation = NonNullable<OfficeSDK['presentation']>;
 export type EditorFacadeContractAssertions = [
+    Assert<IsEqual<OfficeSDK['canIUse'], (method: OfficeSDKMethodPath) => Promise<boolean>>>,
+    Assert<IsEqual<NonNullable<OfficeSDK['ActiveOutline']>, DocsActiveOutlineFacade>>,
+    Assert<IsEqual<DocsActiveOutlineFacade['Editor']['Document']['GetContent'], () => Promise<DocsEditorDeltaSnapshot>>>,
+    Assert<IsEqual<DocsActiveOutlineFacade['Editor']['Document']['Markdown']['AppendMarkdown'], (value: string) => Promise<DocsRangeValue>>>,
+    Assert<IsEqual<DocsActiveOutlineFacade['Service']['Permission']['GetDocumentPermission'], () => Promise<import('./OfficeSDK').DocsDocumentPermission>>>,
+    Assert<IsEqual<DocsActiveOutlineFacade['Service']['Export']['DownloadDocument'], (format: import('./OfficeSDK').DocsDownloadDocumentType) => Promise<void>>>,
+    Assert<IsEqual<DocsActiveOutlineFacade['Sub']['OnDocumentChange'], (handler: (delta: DocsEditorDeltaSnapshot) => void) => () => void>>,
     Assert<IsAssignable<NonNullable<OfficeSDK['title']>['setTitle'], (title: string) => Promise<void>>>,
     Assert<IsAssignable<NonNullable<OfficeSDK['title']>['addChangedListener'], (listener: (title: string) => void) => () => void>>,
     Assert<IsAssignable<NonNullable<OfficeSDK['locks']>['addRangeLock'], (options: import('./OfficeSDK').AddRangeLockParams) => Promise<void>>>,

package/dist/headerBarsAnchor.d.ts

@@ -0,0 +1,26 @@
+import type { HeaderBarsAnchorRect, HeaderBarsSourceAnchorRect } from './OfficeSDK.headerBars';
+/** iframe 内容区矩形，仅取换算需要的字段。 */
+export interface HeaderBarsIframeRect {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+/** 宿主视口尺寸。 */
+export interface HeaderBarsViewportSize {
+    width: number;
+    height: number;
+}
+/**
+ * 将 iframe 视口坐标系下的锚点矩形换算到宿主页面坐标系。
+ *
+ * 输入：
+ *  - anchorRect：iframe 内部产生的矩形，viewport 为来源视口尺寸；
+ *  - iframeRect：编辑器 iframe 元素在宿主页面的矩形，缺省时按无缩放、无偏移处理；
+ *  - viewport：宿主视口尺寸。
+ * 输出：可序列化的宿主坐标系矩形，coordinateSpace 固定为 callback-window-viewport。
+ *
+ * 缩放比例按来源视口尺寸计算，因此 iframe 被 CSS 缩放时仍能得到正确位置；
+ * 不承诺旋转、倾斜或 3D transform 场景。
+ */
+export declare function toHeaderBarsCallbackAnchorRect(anchorRect: HeaderBarsSourceAnchorRect, iframeRect: HeaderBarsIframeRect | null | undefined, viewport: HeaderBarsViewportSize): HeaderBarsAnchorRect;

package/dist/index.d.ts

@@ -8,7 +8,9 @@ import * as Flowchart from './types/FlowChart';
 import { EventMap as BaseEventMap, BaseEditor } from './types/BaseEditor';
 export * from 'weboffice-js-sdk-shared';
 export * from './connect';
+export type { JSAPIAdapter, JSAPIContract, JSAPIContractCatalog, JSAPITransport } from './jsapi';
 export * from './OfficeSDK';
+export * from './OfficeSDK.methods';
 export type { EmptyPageScene, EmptyPageOptions, EmptyPageActionOverride, EmptyPageContentOverride, NormalizedEmptyPageOptions, EmptyPageShownPayload, EmptyPageActionPayload, EmptyPageHiddenPayload, FileOpenFailedReason, TokenExpiredStrategy } from './types/EmptyPage';
 export type { SlashMenuButton, SlashMenuEntry, SlashMenuOptions } from './types/SlashMenu';
 export { ALL_EMPTY_PAGE_SCENES, normalizeEmptyPageOptions } from './types/EmptyPage';