@web-ppt/editor 0.5.0-beta.2 → 0.5.0-beta.7

package/dist/element-clipboard.d.ts

@@ -1,20 +1,22 @@
-import type { Editor, ElementId, SlideId } from '@web-ppt/edit-core';
+import type { Editor, ElementClipboardPayload, ElementId, SlideId } from '@web-ppt/edit-core';
 export declare const ELEMENT_CLIPBOARD_MIME = "application/x-web-ppt-elements+json";
 interface ElementClipboardOptions {
     editor: Editor;
+    copyElements(ids: readonly ElementId[]): ElementClipboardPayload;
     slideId(): SlideId;
     editable(): boolean;
     gestureActive(): boolean;
     insertImage(file: File): Promise<ElementId>;
+    onError?: (error: unknown) => void;
 }
 export declare class ElementClipboardController {
     private readonly options;
     constructor(options: ElementClipboardOptions);
+    private report;
     copy(event: ClipboardEvent): void;
     cut(event: ClipboardEvent): void;
     paste(event: ClipboardEvent): void;
     duplicate(event: KeyboardEvent): boolean;
-    private shouldYield;
     private shouldYieldBase;
     private selectedRoots;
     private write;

package/dist/framework-adapter-types.d.ts

@@ -1,8 +1,8 @@
-import type { EditAnimationStep, EditorChange, SlideAnimationState, SlideId, SlideTransitionInput, SlideTransitionState, TextSearchMatch } from '@web-ppt/edit-core';
+import type { AddSectionCommand, DistributeElementsCommand, EditAnimationStep, EditorChange, ElementAltTextState, ElementId, SectionId, SectionRecord, SetAltTextCommand, SetSlideSizeCommand, SlideAnimationState, SlideId, SlideSizeState, SlideTransitionInput, SlideTransitionState, TextSearchMatch } from '@web-ppt/edit-core';
 import type { RecoveryCandidate, RecoveryDecision } from './recovery-store';
 import type { EditorSession, OpenEditorOptions } from './session';
 import type { SelectionPane } from './selection-pane-types';
-import type { EditorMode, LinkFollowHandler, SlideEditor, SlideEditorOptions } from './slide-editor-types';
+import type { EditorContextRequest, EditorMode, LinkFollowHandler, SlideEditor, SlideEditorOptions, TouchNavigationChange } from './slide-editor-types';
 import type { WebPptSource } from './source-fingerprint';
 import type { FormatPainterSnapshot, FormatPainterStartOptions } from './format-painter-types';
 import type { TextSearchOpenOptions, TextSearchOptions, TextSearchSnapshot } from './text-search-types';
@@ -52,6 +52,8 @@ export interface WebPptAdapterCallbacks {
     readonly onProgress?: (progress: WebPptAdapterProgress) => void;
     readonly onChange?: (change: EditorChange) => void;
     readonly onViewChange?: (state: WebPptViewState) => void;
+    readonly onTouchNavigate?: (change: TouchNavigationChange) => void;
+    readonly onContextRequest?: (request: EditorContextRequest) => void;
     readonly onRecovery?: (candidate: RecoveryCandidate) => RecoveryDecision | Promise<RecoveryDecision>;
 }
 export type WebPptAdapterBinding = WebPptViewOptions & WebPptAdapterCallbacks & ({
@@ -107,6 +109,16 @@ export interface WebPptAdapter {
     previousTextSearch(): TextSearchMatch | null;
     replaceCurrentText(): boolean;
     replaceAllText(): number;
+    distributeElements(axis: DistributeElementsCommand['axis'], ids?: readonly ElementId[]): boolean;
+    queryAltText(id?: ElementId): ElementAltTextState | null;
+    setAltText(value: Pick<SetAltTextCommand, 'title' | 'descr'>, id?: ElementId): boolean;
+    listSections(): SectionRecord[];
+    addSection(value: Omit<AddSectionCommand, 'type'>): SectionRecord | null;
+    renameSection(id: SectionId, name: string): boolean;
+    moveSection(id: SectionId, after: SectionId | null): boolean;
+    removeSection(id: SectionId): boolean;
+    querySlideSize(): SlideSizeState;
+    setSlideSize(value: Pick<SetSlideSizeCommand, 'w' | 'h' | 'fit'>): boolean;
     queryTransition(): SlideTransitionState | null;
     setTransition(value: SlideTransitionInput | null): boolean;
     previewTransition(value?: SlideTransitionInput): Promise<boolean>;

package/dist/image-insertion.d.ts

@@ -1,15 +1,18 @@
 import type { AddImageCommand, Editor, ElementId, SetBackgroundImageCommand, SlideId } from '@web-ppt/edit-core';
 export interface ImageInsertOptions {
+    readonly signal?: AbortSignal;
     readonly rect?: AddImageCommand['rect'];
     /** 默认 5MB：留足默认 8MB 历史预算所需的 Base64 开销，保证插入后仍可撤销。 */
     readonly maxBytes?: number;
 }
 export interface ImageReplaceOptions {
+    readonly signal?: AbortSignal;
     /** 默认使用当前单选图片。 */
     readonly id?: ElementId;
     readonly maxBytes?: number;
 }
 export interface ImageBackgroundOptions {
+    readonly signal?: AbortSignal;
     readonly crop?: SetBackgroundImageCommand['crop'];
     readonly alpha?: SetBackgroundImageCommand['alpha'];
     readonly tile?: SetBackgroundImageCommand['tile'];
@@ -30,7 +33,7 @@ export declare class ImageInsertionController {
     private activeReads;
     private destroyed;
     constructor(options: ImageInsertionControllerOptions);
-    private withImageBytes;
+    private applyImage;
     insert(blob: Blob, options?: InternalImageInsertOptions): Promise<ElementId>;
     replace(id: ElementId, blob: Blob, options?: ImageReplaceOptions): Promise<ElementId>;
     choose(options?: InternalImageInsertOptions): Promise<ElementId | null>;
@@ -40,7 +43,6 @@ export declare class ImageInsertionController {
     private chooseFile;
     destroy(): void;
     private setReading;
-    private report;
     private assertContext;
 }
 export {};

package/dist/index.d.ts

@@ -7,8 +7,9 @@ export { createWebPptAdapter, } from './framework-adapter';
 export { applyWebPptAdapterBinding } from './framework-adapter-binding';
 export { WEB_PPT_IDLE_SNAPSHOT } from './framework-adapter-state';
 export { ELEMENT_CLIPBOARD_MIME } from './element-clipboard';
-export { elementFrameToSlideMatrix, elementFrameToSlidePoint, elementParentToSlideMatrix, elementParentToSlidePoint, invertSpaceMatrix, screenToSlidePoint, slideToElementFramePoint, slideToElementParentPoint, slideToScreenPoint, transformSpacePoint, queryElementCrop, queryElementEffects, queryElementFill, queryElementLink, queryElementStroke, queryRunLink, querySlideBackground, querySlideHidden, querySlideLayout, querySlideNotes, querySlideAnimations, querySlideTransition, ANIMATION_EFFECTS, MAX_ANIMATION_STEPS, animationDirections, animationEffectsForKind, SHAPE_PATTERN_PRESETS, SLIDE_TRANSITION_TYPES, transitionDirections, } from '@web-ppt/edit-core';
+export { editFrameToModelFrame, elementEditFrame, elementEditParentToSlideMatrix, elementFrameToSlideMatrix, elementFrameToSlidePoint, elementParentToRenderedParentMatrix, elementParentToSlideMatrix, elementParentToSlidePoint, invertSpaceMatrix, renderedContentToSlideMatrix, renderedElement, renderedFrameToSlideMatrix, screenToSlidePoint, slideToElementEditParentPoint, slideToElementFramePoint, slideToElementParentPoint, slideToScreenPoint, transformSpacePoint, queryElementCrop, queryElementEffects, queryElementFill, queryElementLink, queryElementStroke, queryElementPresetGeometry, queryParaProps, queryRunLink, queryRunProps, queryTableGrid, querySlideBackground, querySlideHidden, querySlideLayout, querySlideNotes, listSections, queryElementAltText, querySlideAnimations, querySlideSize, querySlideTransition, sectionOfSlide, ANIMATION_EFFECTS, MAX_ANIMATION_STEPS, animationDirections, animationEffectsForKind, SHAPE_PATTERN_PRESETS, SLIDE_TRANSITION_TYPES, transitionDirections, listThemes, queryTheme, } from '@web-ppt/edit-core';
 export type { EditorSession, OpenEditorOptions } from './session';
+export type { DesignEditor, DesignEditorOptions } from './design-editor-types';
 export type { FormatPainter, FormatPainterSnapshot, FormatPainterSource, FormatPainterStartOptions, FormatPainterSubscriber, FormatPainterTarget, } from './format-painter-types';
 export type { TextSearch, TextSearchMode, TextSearchOpenOptions, TextSearchOptions, TextSearchSnapshot, TextSearchSubscriber, } from './text-search-types';
 export type { SelectionPane, SelectionPaneOptions } from './selection-pane-types';
@@ -17,12 +18,12 @@ export type { EditorRecovery, RecoveryCandidate, RecoveryDecision, RecoveryDecis
 export type { IndexedDbRecoveryStore, IndexedDbRecoveryStoreOptions, RecoveryCleanupResult, RecoveryStoreStats, } from './indexeddb-recovery-store';
 export type { WebPptAdapter, WebPptAdapterBinding, WebPptAdapterCallbacks, WebPptAdapterProgress, WebPptAdapterSnapshot, WebPptAdapterSubscriber, WebPptDocument, WebPptDocumentKind, WebPptFormatPainterState, WebPptTextSearchState, WebPptViewOptions, WebPptViewState, } from './framework-adapter-types';
 export type { WebPptSource } from './source-fingerprint';
-export type { EditorMode, LinkFollowContext, LinkFollowHandler, LinkFollowSource, SlideEditor, SlideEditorOptions, } from './slide-editor-types';
+export type { EditorContextRequest, EditorContextRequestHandler, EditorMode, LinkFollowContext, LinkFollowHandler, LinkFollowSource, SlideEditor, SlideEditorOptions, TouchNavigationChange, TouchNavigationHandler, } from './slide-editor-types';
 export type { ImageInsertOptions } from './image-insertion';
 export type { ImageBackgroundOptions, ImageReplaceOptions } from './image-insertion';
 export type { TableInsertOptions } from './table-insertion';
-export type { AddImageCommand, AddShapeCommand, AddTableCommand, EditAnimationStep, ElementClipboardPayload, ElementCropState, ElementEffectsState, ElementFillState, ElementLinkState, ElementStrokeState, ImageCrop, LinkOverride, LinkSourceValue, LinkTarget, ParagraphProperties, ParagraphPropertiesState, ParagraphPropertyOverrides, SlideAnimationState, SlideBackgroundState, SlideHiddenState, SlideLayoutState, RunLinkState, RunPropertiesState, RunPropertyOverrides, SlideNotesState, SlideTransitionInput, SlideTransitionState, TextBodyAutoFit, TextBodyProperties, TextBodyPropertyOverrides, ReplaceImageCommand, SetAnimationsCommand, SetBackgroundCommand, SetBackgroundCropCommand, SetBackgroundImageCommand, SetCropCommand, SetEffectsCommand, SetFillCommand, SetHiddenCommand, SetTransitionCommand, SetLayoutCommand, SetLinkCommand, SetStrokeCommand, StrokeCommandValue, VectorFill, FormatMaskField, } from '@web-ppt/edit-core';
+export type { AddImageCommand, AddSectionCommand, AddShapeCommand, AddTableCommand, DistributeElementsCommand, EditAnimationStep, ElementAltTextState, ElementClipboardPayload, ElementCropState, ElementEffectsState, ElementFillState, ElementLinkState, ElementStrokeState, ImageCrop, LinkOverride, LinkSourceValue, LinkTarget, ParagraphAutoNumberType, ParagraphBullet, ParagraphBulletInput, ParagraphBulletSize, ParagraphBulletStyle, ParagraphProperties, ParagraphPropertiesState, ParagraphPropertyInput, ParagraphPropertyOverrides, SectionId, SectionRecord, SetAltTextCommand, SetSlideSizeCommand, SlideAnimationState, SlideBackgroundState, SlideHiddenState, SlideLayoutState, SlideSizeState, RunLinkState, RunPropertiesState, RunPropertyOverrides, SlideNotesState, SlideTransitionInput, SlideTransitionState, TextBodyAutoFit, TextBodyProperties, TextBodyPropertyOverrides, MoveSectionCommand, RemoveSectionCommand, RenameSectionCommand, ReplaceImageCommand, SetAnimationsCommand, SetBackgroundCommand, SetBackgroundCropCommand, SetBackgroundImageCommand, SetCropCommand, SetEffectsCommand, SetFillCommand, SetHiddenCommand, SetTransitionCommand, SetLayoutCommand, SetLinkCommand, SetStrokeCommand, StrokeCommandValue, VectorFill, FormatMaskField, SetThemeCommand, ThemeColorPatch, ThemeFontPatch, ThemePatch, ThemeState, DesignCommand, DesignTarget, LayoutCatalogItem, LayoutDesignState, LayoutPropertyPatch, MasterCatalogItem, MasterDesignState, MasterDesignTarget, MasterTextLevelState, SetMasterTextStyleCommand, } from '@web-ppt/edit-core';
 export type { EditorChange, FindTextRequest, ReplaceTextCommand, ReplaceTextScope, SlideId, TextSearchMatch, TextSearchScope, TextSearchTarget, } from '@web-ppt/edit-core';
 export type { SelectionPaneItem } from '@web-ppt/edit-core';
 export type { SnapMargins } from './snap';
-export type { AffineMatrix, SlideViewport, SpacePoint } from '@web-ppt/edit-core';
+export type { AffineMatrix, ElementEditFrame, SlideViewport, SpacePoint } from '@web-ppt/edit-core';

package/dist/media/index.d.ts

@@ -0,0 +1 @@
+export * from '@web-ppt/edit-core/media';

package/dist/media.js

@@ -0,0 +1 @@
+export * from "@web-ppt/edit-core/media";

package/dist/rotation-geometry.d.ts

@@ -5,5 +5,8 @@ export declare function pointerAngle(center: SpacePoint, pointer: SpacePoint): n
 export declare function shortestRotationDelta(degrees: number): number;
 export declare function constrainedRotation(degrees: number, shiftKey: boolean): number;
 export declare function rotatePointAround(point: SpacePoint, center: SpacePoint, degrees: number): SpacePoint;
-/** 多选中心在幻灯片空间刚性旋转；方向轴反解回父空间，避免把组缩放误当成角度。 */
+/**
+ * 多选中心在幻灯片空间刚性旋转；source 是编辑外框，父空间只含平移、旋转与翻转，
+ * 方向轴反解回父空间时只需处理翻转带来的手性。
+ */
 export declare function rotateElementAroundSlideCenter(doc: EditDoc, id: ElementId, source: TransformFrame, selectionCenter: SpacePoint, degrees: number): TransformFrame;

package/dist/selection-hit.d.ts

@@ -2,6 +2,12 @@ import type { EditDoc, ElementId, Selection, SlideId, TableCellAddress } from '@
 export declare function tableCellAddressFromPath(path: EventTarget[], root: Element): TableCellAddress | null;
 export declare function isSelectable(doc: EditDoc, id: ElementId): boolean;
 export declare function selectableElementIdsFromPath(doc: EditDoc, path: EventTarget[], root: Element): ElementId[];
+/** 触摸才按离落点由近到远采样；鼠标/笔仍完全服从浏览器的原生 SVG 命中。 */
+export declare function touchHitCandidate(doc: EditDoc, document: Document, screen: {
+    x: number;
+    y: number;
+}, root: Element, enteredGroup: ElementId | null): ElementId | undefined;
+export declare function pathWithinRoot(element: Element | null | undefined, root: Element): EventTarget[];
 export declare function alternateSelectableElementId(doc: EditDoc, elements: readonly Element[], root: Element, enteredGroup: ElementId | null, selection: Selection, preferUnselected: boolean): ElementId | undefined;
 export declare function directSelectableChildIds(doc: EditDoc, slideId: SlideId, enteredGroup: ElementId | null): ElementId[];
 export declare function enteredGroupOnSlide(doc: EditDoc, enteredGroup: ElementId | null, slideId: SlideId): ElementId | null;

package/dist/selection-pane-types.d.ts

@@ -14,5 +14,6 @@ export interface SelectionPane {
     setSlide(slideId: SlideId): void;
     setMode(mode: EditorMode): void;
     focusElement(id: ElementId): boolean;
+    revealElement(id: ElementId): boolean;
     destroy(): void;
 }

package/dist/session-state.d.ts

@@ -1,17 +1,21 @@
+import { copyElements } from '@web-ppt/edit-core';
 import type { Presentation } from '@web-ppt/core';
 import type { EditorSession } from './session';
 import type { SlideEditor } from './slide-editor-types';
 import type { SelectionPane } from './selection-pane-types';
 interface SessionState {
     presentation: Presentation;
+    copy: typeof copyElements;
     views: Set<SlideEditor>;
     panes: Set<SelectionPane>;
     textOwner: TextEditingOwner | null;
+    fontRefresh: Set<() => void>;
+    browserFontsReady?: boolean;
 }
 interface TextEditingOwner {
     releaseTextEditing(): void;
 }
-export declare function registerSession(session: EditorSession, presentation: Presentation): void;
+export declare function registerSession(session: EditorSession, presentation: Presentation, copy?: typeof copyElements): void;
 export declare function sessionState(session: EditorSession): SessionState;
 export declare function releaseSession(session: EditorSession): void;
 /** contenteditable 是视图本地资源；同一会话只能有一个 DOM 所有者。 */

package/dist/session.d.ts

@@ -1,4 +1,4 @@
-import type { ParseOptions } from '@web-ppt/core';
+import type { EmbeddedFont, ParseOptions, Presentation } from '@web-ppt/core';
 import { Editor } from '@web-ppt/edit-core';
 import type { CreateDocOptions, EditorOptions } from '@web-ppt/edit-core';
 import type { SlideEditor, SlideEditorOptions } from './slide-editor-types';
@@ -7,6 +7,8 @@ import type { SelectionPane, SelectionPaneOptions } from './selection-pane-types
 import type { FormatPainter } from './format-painter-types';
 import type { TextSearch } from './text-search-types';
 export interface OpenEditorOptions extends CreateDocOptions, EditorOptions {
+    /** 由宿主字体服务解码和安装时选 source；默认沿用 SDK 的直接预览行为。 */
+    embeddedFonts?: ParseOptions['embeddedFonts'];
     password?: ParseOptions['password'];
     recovery?: RecoveryOptions;
 }
@@ -17,6 +19,20 @@ export interface EditorSession {
     readonly formatPainter: FormatPainter;
     readonly textSearch: TextSearch;
     readonly disposed: boolean;
+    /** 原始字体容器由会话持有；使用前须检查许可与容器，关闭后 URL 失效。 */
+    readonly embeddedFontSources?: readonly Readonly<EmbeddedFont>[];
+    /**
+     * 取得当前编辑投影，供图片导出等只读能力直接消费。
+     * 资源 URL 仍由会话拥有，因此返回值只在会话释放前有效。
+     */
+    toPresentation(): Presentation;
+    /**
+     * 仅更新预览/图片及 SVG 导出的字体资源，不写入 PPTX 或历史；URL 仍由调用者拥有。
+     * 宿主已安装并加载 FontFace 时设置 browserFontsReady，DOM 预览可复用它们。
+     */
+    setFontResources(fonts: readonly EmbeddedFont[], options?: {
+        browserFontsReady?: boolean;
+    }): void;
     mount(container: HTMLElement, options?: SlideEditorOptions): SlideEditor;
     mountSelectionPane(container: HTMLElement, options?: SelectionPaneOptions): SelectionPane;
     dispose(): void;

package/dist/slide-dom-renderer.d.ts

@@ -2,6 +2,7 @@ import type { Presentation } from '@web-ppt/core';
 import type { Editor, EditorChange, ElementId, Selection, SlideId } from '@web-ppt/edit-core';
 interface SlideDomRendererOptions {
     presentation: Presentation;
+    browserFontsReady: () => boolean;
     editor: Editor;
     staticLayer: HTMLElement;
     interactionLayer: SVGSVGElement;

package/dist/slide-editor-commands.d.ts

@@ -1,4 +1,4 @@
-import type { EditAnimationStep, ElementId, ImageCrop, LinkTarget, ParagraphPropertiesState, ParagraphPropertyOverrides, RunLinkState, RunPropertiesState, RunPropertyOverrides, SlideId, SlideLayoutState, SlideNotesState, TextBodyProperties, TextBodyPropertyOverrides, SlideAnimationState, SlideTransitionInput, SlideTransitionState } from '@web-ppt/edit-core';
+import type { AddSectionCommand, DistributeElementsCommand, EditAnimationStep, ElementAltTextState, ElementId, ImageCrop, LinkTarget, ParagraphPropertiesState, ParagraphPropertyInput, RunLinkState, RunPropertiesState, RunPropertyOverrides, SlideId, SlideLayoutState, SectionId, SectionRecord, SetAltTextCommand, SetSlideSizeCommand, SlideNotesState, SlideSizeState, TextBodyProperties, TextBodyPropertyOverrides, SlideAnimationState, SlideTransitionInput, SlideTransitionState } from '@web-ppt/edit-core';
 import type { EditorSession } from './session';
 import type { TextEditorController } from './text-editor';
 import type { ImageInsertionController } from './image-insertion';
@@ -32,6 +32,7 @@ interface SlideEditorCommandsOptions {
 /** 把公开工具栏动作收敛为薄能力层，视图本体只负责 DOM 与生命周期装配。 */
 export declare class SlideEditorCommands {
     private readonly options;
+    private readonly common;
     constructor(options: SlideEditorCommandsOptions);
     startFormatPainter(options: FormatPainterStartOptions): boolean;
     cancelFormatPainter(): void;
@@ -47,10 +48,21 @@ export declare class SlideEditorCommands {
     queryRunProps(): RunPropertiesState | null;
     queryRunLink(): RunLinkState | null;
     setRunProps(props: RunPropertyOverrides): boolean;
+    clearFormat(): boolean;
     queryParaProps(): ParagraphPropertiesState | null;
-    setParaProps(props: ParagraphPropertyOverrides): boolean;
+    setParaProps(props: ParagraphPropertyInput): boolean;
     queryBodyProps(): TextBodyProperties | null;
     setBodyProps(props: TextBodyPropertyOverrides): boolean;
+    distributeElements(axis: DistributeElementsCommand['axis'], ids?: readonly ElementId[]): boolean;
+    queryAltText(id?: ElementId): ElementAltTextState | null;
+    setAltText(value: Pick<SetAltTextCommand, 'title' | 'descr'>, id?: ElementId): boolean;
+    listSections(): SectionRecord[];
+    addSection(value: Omit<AddSectionCommand, 'type'>): SectionRecord | null;
+    renameSection(id: SectionId, name: string): boolean;
+    moveSection(id: SectionId, after: SectionId | null): boolean;
+    removeSection(id: SectionId): boolean;
+    querySlideSize(): SlideSizeState;
+    setSlideSize(value: Pick<SetSlideSizeCommand, 'w' | 'h' | 'fit'>): boolean;
     insertImage(file: Blob, options: ImageInsertOptions): Promise<ElementId>;
     chooseImage(options: ImageInsertOptions): Promise<ElementId | null>;
     replaceImage(file: Blob, options: ImageReplaceOptions): Promise<ElementId>;

package/dist/slide-editor-events.d.ts

@@ -3,6 +3,7 @@ interface SlideEditorEventHandlers {
     pointermove: (event: PointerEvent) => void;
     pointerup: (event: PointerEvent) => void;
     pointercancel: (event: PointerEvent) => void;
+    click: (event: MouseEvent) => void;
     dblclick: (event: MouseEvent) => void;
     keydown: (event: KeyboardEvent) => void;
     keyup: (event: KeyboardEvent) => void;

package/dist/slide-editor-types.d.ts

@@ -1,4 +1,4 @@
-import type { EditAnimationStep, ElementId, ImageCrop, LinkTarget, ParagraphPropertiesState, ParagraphPropertyOverrides, RunLinkState, RunPropertiesState, RunPropertyOverrides, SlideId, SlideLayoutState, TextBodyProperties, TextBodyPropertyOverrides, SlideNotesState, SlideAnimationState, SlideTransitionInput, SlideTransitionState } from '@web-ppt/edit-core';
+import type { AddSectionCommand, DistributeElementsCommand, EditAnimationStep, ElementAltTextState, ElementId, ImageCrop, LinkTarget, ParagraphPropertiesState, ParagraphPropertyInput, RunLinkState, RunPropertiesState, RunPropertyOverrides, SlideId, SlideLayoutState, TextBodyProperties, TextBodyPropertyOverrides, SectionId, SectionRecord, SetAltTextCommand, SetSlideSizeCommand, SlideNotesState, SlideSizeState, SlideAnimationState, SlideTransitionInput, SlideTransitionState, SlideViewport } from '@web-ppt/edit-core';
 import type { ImageBackgroundOptions, ImageInsertOptions, ImageReplaceOptions } from './image-insertion';
 import type { SnapMargins } from './snap';
 import type { TableInsertOptions } from './table-insertion';
@@ -12,6 +12,20 @@ export interface LinkFollowContext {
 }
 /** 返回 true 表示宿主已经完成路由，编辑器不再执行默认跳转。 */
 export type LinkFollowHandler = (target: LinkTarget, context: LinkFollowContext) => boolean | void;
+export interface TouchNavigationChange {
+    readonly phase: 'start' | 'update' | 'end' | 'cancel';
+    /** 手势希望宿主呈现的舞台屏幕位置；left/top 可用于驱动外层滚动视口。 */
+    readonly viewport: SlideViewport;
+    readonly pointerCount: number;
+}
+export type TouchNavigationHandler = (change: TouchNavigationChange) => void;
+export interface EditorContextRequest {
+    readonly source: 'touch';
+    readonly screen: import('@web-ppt/edit-core').SpacePoint;
+    readonly slide: import('@web-ppt/edit-core').SpacePoint;
+    readonly targetId: ElementId | null;
+}
+export type EditorContextRequestHandler = (request: EditorContextRequest) => void;
 export interface SlideEditorOptions {
     slideId?: SlideId;
     mode?: EditorMode;
@@ -26,6 +40,10 @@ export interface SlideEditorOptions {
     onLinkFollow?: LinkFollowHandler;
     /** 页面级快捷键或内部链接切页后通知宿主同步侧栏、分页器和受控状态。 */
     onSlideChange?: (slideId: SlideId) => void;
+    /** 双指缩放/平移结果；缩放已同步到本视图，left/top 交由宿主管理外层滚动。 */
+    onTouchNavigate?: TouchNavigationHandler;
+    /** 长按只提出上下文请求；菜单内容与呈现仍由宿主决定。 */
+    onContextRequest?: EditorContextRequestHandler;
     /** 与自定义事件 webpptformaterror 同源，adapter 用它接入全局 onError。 */
     onError?: (error: unknown) => void;
 }
@@ -56,10 +74,25 @@ export interface SlideEditor {
     queryRunProps(): RunPropertiesState | null;
     queryRunLink(): RunLinkState | null;
     setRunProps(props: RunPropertyOverrides): boolean;
+    /** 清除选区直设字符格式；折叠光标时作用于后续输入。 */
+    clearFormat(): boolean;
     queryParaProps(): ParagraphPropertiesState | null;
-    setParaProps(props: ParagraphPropertyOverrides): boolean;
+    setParaProps(props: ParagraphPropertyInput): boolean;
     queryBodyProps(): TextBodyProperties | null;
     setBodyProps(props: TextBodyPropertyOverrides): boolean;
+    /** 省略 ids 时使用当前多元素选区；查看模式不改模型。 */
+    distributeElements(axis: DistributeElementsCommand['axis'], ids?: readonly ElementId[]): boolean;
+    /** 省略 id 时使用当前单元素选区。 */
+    queryAltText(id?: ElementId): ElementAltTextState | null;
+    setAltText(value: Pick<SetAltTextCommand, 'title' | 'descr'>, id?: ElementId): boolean;
+    listSections(): SectionRecord[];
+    addSection(value: Omit<AddSectionCommand, 'type'>): SectionRecord | null;
+    renameSection(id: SectionId, name: string): boolean;
+    moveSection(id: SectionId, after: SectionId | null): boolean;
+    removeSection(id: SectionId): boolean;
+    querySlideSize(): SlideSizeState;
+    /** v1 仅改变画布，即 PowerPoint“最大化”语义。 */
+    setSlideSize(value: Pick<SetSlideSizeCommand, 'w' | 'h' | 'fit'>): boolean;
     insertImage(file: Blob, options?: ImageInsertOptions): Promise<ElementId>;
     chooseImage(options?: ImageInsertOptions): Promise<ElementId | null>;
     replaceImage(file: Blob, options?: ImageReplaceOptions): Promise<ElementId>;

package/dist/slide-pointer-controller.d.ts

@@ -7,6 +7,7 @@ import type { RotationGestureController } from './rotation-gesture';
 import type { TextEditorController } from './text-editor';
 import type { ImageCropGestureController } from './image-crop-gesture';
 import type { FormatPainterTarget } from './format-painter-types';
+import type { TouchGestureController } from './touch-gesture';
 interface SlidePointerControllerOptions {
     readonly editor: Editor;
     readonly root: HTMLElement;
@@ -19,6 +20,7 @@ interface SlidePointerControllerOptions {
     readonly resize: ResizeGestureController;
     readonly rotation: RotationGestureController;
     readonly crop: ImageCropGestureController;
+    readonly touch: TouchGestureController;
     editable(): boolean;
     slideId(): SlideId;
     hitCandidates(path: EventTarget[]): ElementId[];
@@ -38,6 +40,7 @@ export declare class SlidePointerController {
     readonly move: (event: PointerEvent) => void;
     readonly up: (event: PointerEvent) => void;
     readonly cancel: (event: PointerEvent) => void;
+    readonly click: (event: MouseEvent) => void;
     readonly doubleClick: (event: MouseEvent) => void;
 }
 export {};

package/dist/templates/index.d.ts

@@ -0,0 +1,2 @@
+export { createPptxFromTemplate, listBuiltinTemplates } from '@web-ppt/edit-core/templates';
+export type { BuiltinTemplateCatalogItem, BuiltinTemplateId, BuiltinTemplatePreviewToken, CreatePptxFromTemplateOptions, } from '@web-ppt/edit-core/templates';

package/dist/templates.js

@@ -0,0 +1,5 @@
+import { createPptxFromTemplate as l, listBuiltinTemplates as m } from "@web-ppt/edit-core/templates";
+export {
+  l as createPptxFromTemplate,
+  m as listBuiltinTemplates
+};

package/dist/text-edit-commit.d.ts

@@ -0,0 +1,8 @@
+import type { Editor, RunPropertyOverrides, TextEditOp, TextPosition } from '@web-ppt/edit-core';
+import type { ActiveText } from './text-editor-types';
+export interface PendingTextFormat {
+    readonly props: RunPropertyOverrides;
+    readonly clearSource: boolean;
+}
+/** 先按 flat mark 身份预测插入范围，再把输入、清除与待输入格式合成一个历史事务。 */
+export declare function commitTextInput(editor: Editor, active: ActiveText, ops: readonly TextEditOp[], nextIndex: number, label: string, insertedFrom: number | null, pending: PendingTextFormat): TextPosition | null;

package/dist/text-editor.d.ts

@@ -1,4 +1,4 @@
-import type { EditorChange, ElementId, ParagraphPropertiesState, ParagraphPropertyOverrides, RunLinkState, RunPropertiesState, RunPropertyOverrides, TableCellAddress } from '@web-ppt/edit-core';
+import type { EditorChange, ElementId, ParagraphPropertiesState, ParagraphPropertyInput, RunLinkState, RunPropertiesState, RunPropertyOverrides, TableCellAddress } from '@web-ppt/edit-core';
 import type { TextEditorControllerOptions } from './text-editor-types';
 export declare class TextEditorController {
     private readonly options;
@@ -9,8 +9,9 @@ export declare class TextEditorController {
     private activeCell;
     private root;
     private composing;
+    private fontsPending;
     private composition;
-    private pendingRunProps;
+    private pendingFormat;
     private staticStale;
     private readonly hidden;
     private readonly externalUi;
@@ -23,8 +24,9 @@ export declare class TextEditorController {
     queryRunProps(): RunPropertiesState | null;
     queryRunLink(): RunLinkState | null;
     queryParaProps(): ParagraphPropertiesState | null;
-    setParaProps(props: ParagraphPropertyOverrides): boolean;
+    setParaProps(props: ParagraphPropertyInput): boolean;
     setRunProps(props: RunPropertyOverrides): boolean;
+    clearFormat(): boolean;
     owns(target: EventTarget | null): boolean;
     enter(id: ElementId): boolean;
     enterCell(id: ElementId, cell: TableCellAddress): boolean;
@@ -33,6 +35,7 @@ export declare class TextEditorController {
     close(selectElement?: boolean): void;
     update(change: EditorChange): void;
     refreshStatic(): void;
+    refreshFonts(): void;
     destroy(): void;
     private textContext;
     private activeText;
@@ -47,6 +50,7 @@ export declare class TextEditorController {
     private formatSelection;
     private setSelection;
     private setCaret;
+    private resetPendingFormat;
     private hideStaticText;
     private restoreStaticText;
 }

package/dist/text-keyboard.d.ts

@@ -1,4 +1,4 @@
-import type { Editor, ParagraphPropertyOverrides, TableCellAddress, TextPosition } from '@web-ppt/edit-core';
+import type { Editor, ParagraphPropertyInput, TableCellAddress, TextPosition } from '@web-ppt/edit-core';
 import type { TextEditorContext } from './text-editor-context';
 interface TextKeyboardOptions {
     editor: Editor;
@@ -10,7 +10,7 @@ interface TextKeyboardOptions {
     changeListLevel(delta: -1 | 1): void;
     formatSelection(field: 'b' | 'i' | 'u'): boolean;
     stepFontSize(direction: -1 | 1): boolean;
-    setParaProps(props: ParagraphPropertyOverrides): boolean;
+    setParaProps(props: ParagraphPropertyInput): boolean;
     restoreSelection(from: TextPosition, to: TextPosition): void;
     selectAllElements(): void;
     documentKeyDown(event: KeyboardEvent): boolean;

package/dist/touch-gesture.d.ts

@@ -0,0 +1,42 @@
+import type { ElementId } from '@web-ppt/edit-core';
+import type { EditorContextRequest, TouchNavigationChange } from './slide-editor-types';
+interface TouchGestureOptions {
+    readonly root: HTMLElement;
+    readonly stage: HTMLElement;
+    zoom(): number;
+    cancelObjectGestures(): void;
+    applyZoom(zoom: number): void;
+    navigate(change: TouchNavigationChange): void;
+    context(request: EditorContextRequest): void;
+}
+/** 只管理视图局部触屏导航；模型、历史与宿主滚动位置都不进入这里。 */
+export declare class TouchGestureController {
+    private readonly options;
+    private readonly pointers;
+    private navigation;
+    private longPress;
+    private suppressedClick;
+    constructor(options: TouchGestureOptions);
+    get isActive(): boolean;
+    down(event: PointerEvent): boolean;
+    move(event: PointerEvent): boolean;
+    up(event: PointerEvent): boolean;
+    cancelPointer(event: PointerEvent): boolean;
+    cancel(): void;
+    armLongPress(event: PointerEvent, targetId: ElementId | null): void;
+    readonly click: (event: MouseEvent) => void;
+    private currentViewport;
+    private points;
+    private base;
+    private rebase;
+    private nextViewport;
+    private scheduleFrame;
+    private flushFrame;
+    private updateFrame;
+    private emit;
+    private capture;
+    private fireLongPress;
+    private clearLongPress;
+    private clearNavigation;
+}
+export {};

package/dist/transform-frame.d.ts

@@ -1,14 +1,19 @@
-import type { AffineMatrix, EditDoc, ElementFrameTransform, ElementId, SpacePoint } from '@web-ppt/edit-core';
+import type { AffineMatrix, EditDoc, Editor, ElementEditFrame, ElementId, SpacePoint } from '@web-ppt/edit-core';
 export declare const MIN_FRAME_SIZE: number;
-export interface TransformFrame extends ElementFrameTransform {
-    flipH: boolean;
-    flipV: boolean;
-}
-/** 预览 wrapper 位于元素父空间；矩阵把旧渲染框直接映射到新框，不触碰静态 markup。 */
+/** 手势中的外框一律是编辑外框：父组渲染坐标里的刚体外框（见 edit-core elementEditFrame）。 */
+export type TransformFrame = ElementEditFrame;
+/** 预览 wrapper 位于父组渲染坐标；矩阵把旧编辑外框直接映射到新外框，不触碰静态 markup。 */
 export declare function transformPreviewMatrix(source: TransformFrame, next: TransformFrame): AffineMatrix;
+type XfrmField = 'x' | 'y' | 'w' | 'h' | 'rot';
+/**
+ * 编辑外框换算回模型后要写入的 SetXfrm 字段：always 里的字段照写，其余字段只在与模型原值
+ * 相差至少 1e-9 时写入。渲染外框往返模型会带入舍入误差，不能因此产生无意义的补丁。
+ */
+export declare function modelXfrmFields(editor: Pick<Editor, 'doc' | 'effectiveElement'>, id: ElementId, frame: TransformFrame, always: readonly XfrmField[]): Partial<Record<XfrmField, number>>;
 export declare function transformFrameCorners(doc: EditDoc, id: ElementId, frame: TransformFrame): [
     SpacePoint,
     SpacePoint,
     SpacePoint,
     SpacePoint
 ];
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@web-ppt/editor",
-  "version": "0.5.0-beta.2",
+  "version": "0.5.0-beta.7",
   "description": "Framework-agnostic browser editing session and DOM view for Web-PPT.",
   "keywords": [
     "pptx",
@@ -34,7 +34,39 @@
       "types": "./dist/vertex/index.d.ts",
       "import": "./dist/vertex.js"
     },
-    "./package.json": "./package.json"
+    "./adjustments": {
+      "types": "./dist/adjustments/index.d.ts",
+      "import": "./dist/adjustments.js"
+    },
+    "./design": {
+      "types": "./dist/design/index.d.ts",
+      "import": "./dist/design.js"
+    },
+    "./templates": {
+      "types": "./dist/templates/index.d.ts",
+      "import": "./dist/templates.js"
+    },
+    "./chart": {
+      "types": "./dist/chart/index.d.ts",
+      "import": "./dist/chart.js"
+    },
+    "./chart-shared": {
+      "types": "./dist/chart-shared/index.d.ts",
+      "import": "./dist/chart-shared.js"
+    },
+    "./media": {
+      "types": "./dist/media/index.d.ts",
+      "import": "./dist/media.js"
+    },
+    "./package.json": "./package.json",
+    "./accessibility": {
+      "types": "./dist/canvas-accessibility.d.ts",
+      "import": "./dist/accessibility.js"
+    },
+    "./edit-context": {
+      "types": "./dist/edit-context/index.d.ts",
+      "import": "./dist/edit-context.js"
+    }
   },
   "files": [
     "dist",
@@ -43,14 +75,14 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "vite build && node ../../tooling/check-editor-main-size.mjs && vite build --config vite.vertex.config.ts && tsc -p tsconfig.build.json",
+    "build": "vite build && node ../../tooling/check-editor-main-size.mjs && vite build --config vite.vertex.config.ts && vite build --config vite.adjustments.config.ts && vite build --config vite.design.config.ts && vite build --config vite.templates.config.ts && vite build --config vite.chart.config.ts && vite build --config vite.media.config.ts && vite build --config vite.browser-features.config.ts && tsc -p tsconfig.build.json",
     "prepublishOnly": "npm run build",
     "prepack": "node ../../tooling/sync-package-docs.mjs"
   },
   "peerDependencies": {
-    "@web-ppt/core": "^0.5.0-beta.2",
-    "@web-ppt/edit-core": "^0.5.0-beta.2",
-    "@web-ppt/viewer-core": "^0.5.0-beta.2"
+    "@web-ppt/core": "^0.5.0-beta.7",
+    "@web-ppt/edit-core": "^0.5.0-beta.7",
+    "@web-ppt/viewer-core": "^0.5.0-beta.7"
   },
   "publishConfig": {
     "access": "public"