@web-ppt/editor 0.5.0-beta.1

package/dist/resize-gesture.d.ts

@@ -0,0 +1,30 @@
+import type { Editor, ElementId } from '@web-ppt/edit-core';
+import type { ResizeHandle } from './resize-geometry';
+interface ResizeGestureOptions {
+    root: HTMLElement;
+    stage: HTMLElement;
+    staticLayer: HTMLElement;
+    interactionLayer: SVGSVGElement;
+    editor: Editor;
+    zoom: () => number;
+}
+export declare class ResizeGestureController {
+    private readonly options;
+    private readonly lifecycle;
+    constructor(options: ResizeGestureOptions);
+    get isActive(): boolean;
+    begin(event: PointerEvent, handle: ResizeHandle, ids: readonly ElementId[]): void;
+    move(event: PointerEvent): void;
+    finish(event: PointerEvent): void;
+    modifier(event: KeyboardEvent): boolean;
+    cancel(): void;
+    cancelPointer(event: PointerEvent): void;
+    private currentSlide;
+    private proposal;
+    private startPreview;
+    private applyFrame;
+    private commit;
+    private clearPreview;
+    private sameFrame;
+}
+export {};

package/dist/rotation-geometry.d.ts

@@ -0,0 +1,9 @@
+import type { EditDoc, ElementId, SpacePoint } from '@web-ppt/edit-core';
+import type { TransformFrame } from './transform-frame';
+export declare const ROTATION_SNAP_DEGREES = 15;
+export declare function pointerAngle(center: SpacePoint, pointer: SpacePoint): number;
+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;
+/** 多选中心在幻灯片空间刚性旋转；方向轴反解回父空间，避免把组缩放误当成角度。 */
+export declare function rotateElementAroundSlideCenter(doc: EditDoc, id: ElementId, source: TransformFrame, selectionCenter: SpacePoint, degrees: number): TransformFrame;

package/dist/rotation-gesture.d.ts

@@ -0,0 +1,33 @@
+import type { Editor, ElementId } from '@web-ppt/edit-core';
+interface RotationGestureOptions {
+    root: HTMLElement;
+    stage: HTMLElement;
+    staticLayer: HTMLElement;
+    interactionLayer: SVGSVGElement;
+    editor: Editor;
+    zoom: () => number;
+}
+export declare class RotationGestureController {
+    private readonly options;
+    private readonly lifecycle;
+    constructor(options: RotationGestureOptions);
+    get isActive(): boolean;
+    begin(event: PointerEvent, ids: readonly ElementId[]): void;
+    move(event: PointerEvent): void;
+    finish(event: PointerEvent): void;
+    modifier(event: KeyboardEvent): boolean;
+    cancel(): void;
+    cancelPointer(event: PointerEvent): void;
+    private currentSlide;
+    private anglePointer;
+    private observe;
+    private proposal;
+    private startPreview;
+    private applyFrame;
+    private commit;
+    private clearPreview;
+    private angleElement;
+    private showAngle;
+    private changed;
+}
+export {};

package/dist/selection-body-properties.d.ts

@@ -0,0 +1,3 @@
+import type { Editor, SlideId, TextBodyProperties, TextBodyPropertyOverrides } from '@web-ppt/edit-core';
+export declare function querySelectionBodyProps(editor: Editor, slideId: SlideId): TextBodyProperties | null;
+export declare function setSelectionBodyProps(editor: Editor, slideId: SlideId, props: TextBodyPropertyOverrides): boolean;

package/dist/selection-combine.d.ts

@@ -0,0 +1,10 @@
+import type { ElementId } from '@web-ppt/edit-core';
+interface SelectionModifiers {
+    readonly shiftKey: boolean;
+    readonly ctrlKey: boolean;
+    readonly metaKey: boolean;
+}
+export declare function selectionModifierActive(modifiers: SelectionModifiers): boolean;
+/** 结果始终服从当前作用域绘制顺序，点击先后不成为隐藏的主元素。 */
+export declare function combineSelectionIds(scope: readonly ElementId[], prior: readonly ElementId[], affected: readonly ElementId[], toggle: boolean): ElementId[];
+export {};

package/dist/selection-handles.d.ts

@@ -0,0 +1,3 @@
+import type { ResizeHandle } from './resize-geometry';
+export declare function resizeHandleAt(target: EventTarget | null, interactionLayer: SVGSVGElement): ResizeHandle | null;
+export declare function isRotationHandleAt(target: EventTarget | null, interactionLayer: SVGSVGElement): boolean;

package/dist/selection-hit.d.ts

@@ -0,0 +1,8 @@
+import type { EditDoc, ElementId, Selection, SlideId, TableCellAddress } from '@web-ppt/edit-core';
+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[];
+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;
+export declare function outermostHitCandidate(doc: EditDoc, candidates: ElementId[], enteredGroup: ElementId | null): ElementId | undefined;

package/dist/selection-overlay.d.ts

@@ -0,0 +1,13 @@
+import type { EditDoc, ElementId, Selection, SlideId, SpacePoint } from '@web-ppt/edit-core';
+interface SelectionFrame {
+    ids: ElementId[];
+    corners: [SpacePoint, SpacePoint, SpacePoint, SpacePoint];
+    handles: boolean;
+}
+/** 手势帧只改已有属性，避免每次缩放都重建交互 DOM。 */
+export declare function updateSelectionOverlayFrame(layer: SVGSVGElement, corners: SelectionFrame['corners'], zoom: number, handleFlip?: {
+    horizontal: boolean;
+    vertical: boolean;
+}): void;
+export declare function renderSelectionOverlay(layer: SVGSVGElement, doc: EditDoc, selection: Selection, slideId: SlideId, zoom: number): void;
+export {};

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

@@ -0,0 +1,18 @@
+import type { ElementId, SlideId } from '@web-ppt/edit-core';
+import type { EditorMode } from './slide-editor-types';
+export interface SelectionPaneOptions {
+    readonly slideId?: SlideId;
+    readonly mode?: EditorMode;
+    readonly ariaLabel?: string;
+    readonly onError?: (error: unknown) => void;
+}
+export interface SelectionPane {
+    readonly element: HTMLDivElement;
+    readonly slideId: SlideId;
+    readonly mode: EditorMode;
+    readonly destroyed: boolean;
+    setSlide(slideId: SlideId): void;
+    setMode(mode: EditorMode): void;
+    focusElement(id: ElementId): boolean;
+    destroy(): void;
+}

package/dist/selection-pane.d.ts

@@ -0,0 +1,3 @@
+import type { EditorSession } from './session';
+import type { SelectionPane, SelectionPaneOptions } from './selection-pane-types';
+export declare function createSelectionPane(container: HTMLElement, session: EditorSession, options?: SelectionPaneOptions): SelectionPane;

package/dist/session-state.d.ts

@@ -0,0 +1,20 @@
+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;
+    views: Set<SlideEditor>;
+    panes: Set<SelectionPane>;
+    textOwner: TextEditingOwner | null;
+}
+interface TextEditingOwner {
+    releaseTextEditing(): void;
+}
+export declare function registerSession(session: EditorSession, presentation: Presentation): void;
+export declare function sessionState(session: EditorSession): SessionState;
+export declare function releaseSession(session: EditorSession): void;
+/** contenteditable 是视图本地资源；同一会话只能有一个 DOM 所有者。 */
+export declare function claimTextEditing(session: EditorSession, owner: TextEditingOwner): void;
+export declare function releaseTextEditing(session: EditorSession, owner: TextEditingOwner): void;
+export {};

package/dist/session.d.ts

@@ -0,0 +1,24 @@
+import type { ParseOptions } 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';
+import type { EditorRecovery, RecoveryOptions } from './recovery-store';
+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 {
+    password?: ParseOptions['password'];
+    recovery?: RecoveryOptions;
+}
+/** 一份源文件只建立一个所有者，DOM 视图与框架适配器共享同一 headless Editor。 */
+export interface EditorSession {
+    readonly editor: Editor;
+    readonly recovery: EditorRecovery | null;
+    readonly formatPainter: FormatPainter;
+    readonly textSearch: TextSearch;
+    readonly disposed: boolean;
+    mount(container: HTMLElement, options?: SlideEditorOptions): SlideEditor;
+    mountSelectionPane(container: HTMLElement, options?: SelectionPaneOptions): SelectionPane;
+    dispose(): void;
+}
+export declare function openEditor(input: File | Blob | ArrayBuffer | Uint8Array, options?: OpenEditorOptions): Promise<EditorSession>;

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

@@ -0,0 +1,22 @@
+import type { Presentation } from '@web-ppt/core';
+import type { Editor, EditorChange, ElementId, Selection, SlideId } from '@web-ppt/edit-core';
+interface SlideDomRendererOptions {
+    presentation: Presentation;
+    editor: Editor;
+    staticLayer: HTMLElement;
+    interactionLayer: SVGSVGElement;
+    slideId: () => SlideId;
+    zoom: () => number;
+    idPrefix: string;
+    textMode: 'html' | 'svg';
+    editable: () => boolean;
+}
+export declare class SlideDomRenderer {
+    private readonly options;
+    constructor(options: SlideDomRendererOptions);
+    render(selection: Selection): void;
+    update(change: EditorChange, deferElement: ElementId | null): void;
+    syncElement(id: ElementId): void;
+    renderSelection(selection: Selection): void;
+}
+export {};

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

@@ -0,0 +1,13 @@
+import type { Editor, EditorChange, ElementId, SlideId } from '@web-ppt/edit-core';
+interface SlideDomUpdateOptions {
+    staticLayer: HTMLElement;
+    editor: Editor;
+    slideId: SlideId;
+    change: EditorChange;
+    idPrefix: string;
+    textMode: 'html' | 'svg';
+    deferElement: ElementId | null;
+}
+/** 返回 false 表示局部分区身份不足，调用方应统一回退整页渲染。 */
+export declare function patchSlideDom(options: SlideDomUpdateOptions): boolean;
+export {};

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

@@ -0,0 +1,76 @@
+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 { EditorSession } from './session';
+import type { TextEditorController } from './text-editor';
+import type { ImageInsertionController } from './image-insertion';
+import type { ImageBackgroundOptions, ImageInsertOptions, ImageReplaceOptions } from './image-insertion';
+import type { ImageCropGestureController } from './image-crop-gesture';
+import type { SlideLinkController } from './slide-link-controller';
+import type { EditorMode } from './slide-editor-types';
+import type { TableInsertOptions } from './table-insertion';
+import type { FormatPainterStartOptions } from './format-painter-types';
+import type { FormatPainterViewBinding } from './format-painter-view';
+import type { TextSearchOpenOptions } from './text-search-types';
+import type { TextSearchViewBinding } from './text-search-view';
+import type { TransitionPreviewController } from './transition-preview';
+import type { AnimationPreviewController } from './animation-preview';
+interface SlideEditorCommandsOptions {
+    readonly session: EditorSession;
+    readonly element: HTMLElement;
+    readonly textEditor: TextEditorController;
+    readonly imageInsertion: ImageInsertionController;
+    readonly imageCropGesture: ImageCropGestureController;
+    readonly links: SlideLinkController;
+    readonly formatPainter: FormatPainterViewBinding;
+    readonly textSearch: TextSearchViewBinding;
+    transitionPreview(): TransitionPreviewController;
+    animationPreview(): AnimationPreviewController;
+    mode(): EditorMode;
+    slideId(): SlideId;
+    destroyed(): boolean;
+    cancelGestures(): void;
+}
+/** 把公开工具栏动作收敛为薄能力层，视图本体只负责 DOM 与生命周期装配。 */
+export declare class SlideEditorCommands {
+    private readonly options;
+    constructor(options: SlideEditorCommandsOptions);
+    startFormatPainter(options: FormatPainterStartOptions): boolean;
+    cancelFormatPainter(): void;
+    openTextSearch(options: TextSearchOpenOptions): void;
+    closeTextSearch(): void;
+    nextTextSearch(): import("@web-ppt/edit-core").TextSearchMatch | null;
+    previousTextSearch(): import("@web-ppt/edit-core").TextSearchMatch | null;
+    replaceCurrentText(): boolean;
+    replaceAllText(): number;
+    followLink(target?: LinkTarget): boolean;
+    releaseTextEditing(): void;
+    registerTextUi(element: HTMLElement): () => void;
+    queryRunProps(): RunPropertiesState | null;
+    queryRunLink(): RunLinkState | null;
+    setRunProps(props: RunPropertyOverrides): boolean;
+    queryParaProps(): ParagraphPropertiesState | null;
+    setParaProps(props: ParagraphPropertyOverrides): boolean;
+    queryBodyProps(): TextBodyProperties | null;
+    setBodyProps(props: TextBodyPropertyOverrides): boolean;
+    insertImage(file: Blob, options: ImageInsertOptions): Promise<ElementId>;
+    chooseImage(options: ImageInsertOptions): Promise<ElementId | null>;
+    replaceImage(file: Blob, options: ImageReplaceOptions): Promise<ElementId>;
+    chooseReplacementImage(options: ImageReplaceOptions): Promise<ElementId | null>;
+    setBackgroundImage(file: Blob, options: ImageBackgroundOptions): Promise<SlideId>;
+    chooseBackgroundImage(options: ImageBackgroundOptions): Promise<SlideId | null>;
+    setBackgroundCrop(crop: ImageCrop | null): boolean;
+    queryTransition(): SlideTransitionState;
+    setTransition(value: SlideTransitionInput | null): boolean;
+    previewTransition(value?: SlideTransitionInput): Promise<boolean>;
+    queryAnimations(): SlideAnimationState;
+    setAnimations(value: readonly EditAnimationStep[] | null): boolean;
+    previewAnimations(value?: readonly EditAnimationStep[]): Promise<boolean>;
+    queryLayout(): SlideLayoutState;
+    setLayout(layoutId: string): boolean;
+    queryNotes(): SlideNotesState;
+    setNotes(text: string): boolean;
+    insertTable(rows: number, cols: number, options: TableInsertOptions): ElementId;
+    startImageCrop(id?: ElementId): boolean;
+    endImageCrop(): void;
+    private selectedImageId;
+}
+export {};

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

@@ -0,0 +1,2 @@
+export declare function nextViewIdPrefix(documentPrefix: string): string;
+export declare function createEditorLayer(document: Document, name: string): HTMLDivElement;

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

@@ -0,0 +1,20 @@
+interface SlideEditorEventHandlers {
+    pointerdown: (event: PointerEvent) => void;
+    pointermove: (event: PointerEvent) => void;
+    pointerup: (event: PointerEvent) => void;
+    pointercancel: (event: PointerEvent) => void;
+    dblclick: (event: MouseEvent) => void;
+    keydown: (event: KeyboardEvent) => void;
+    keyup: (event: KeyboardEvent) => void;
+    blur: (event: FocusEvent) => void;
+    copy: (event: ClipboardEvent) => void;
+    cut: (event: ClipboardEvent) => void;
+    paste: (event: ClipboardEvent) => void;
+}
+/** 事件表集中绑定与释放，构造失败和 destroy 共用同一份对称清理。 */
+export declare function bindSlideEditorEditEvents(element: HTMLElement, handlers: SlideEditorEventHandlers): () => void;
+export declare function bindSlideEditorLinkEvent(element: HTMLElement, handlers: {
+    click: (event: MouseEvent) => void;
+    keydown: (event: KeyboardEvent) => void;
+}): () => void;
+export {};

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

@@ -0,0 +1,39 @@
+import type { EditorSession } from './session';
+import type { EditorKeyboardController } from './editor-keyboard';
+import type { ElementClipboardController } from './element-clipboard';
+import type { MarqueeGestureController } from './marquee-gesture';
+import type { MoveGestureController } from './move-gesture';
+import type { ResizeGestureController } from './resize-gesture';
+import type { RotationGestureController } from './rotation-gesture';
+import type { ImageCropGestureController } from './image-crop-gesture';
+import type { TextEditorController } from './text-editor';
+import type { SlideLinkController } from './slide-link-controller';
+import type { FormatPainterViewBinding } from './format-painter-view';
+import type { EditorMode } from './slide-editor-types';
+interface SlideEditorKeyboardEventOptions {
+    readonly session: EditorSession;
+    readonly keyboard: EditorKeyboardController;
+    readonly clipboard: ElementClipboardController;
+    readonly marquee: MarqueeGestureController;
+    readonly move: MoveGestureController;
+    readonly resize: ResizeGestureController;
+    readonly rotation: RotationGestureController;
+    readonly crop: ImageCropGestureController;
+    readonly textEditor: TextEditorController;
+    readonly links: SlideLinkController;
+    readonly formatPainter: FormatPainterViewBinding;
+    mode(): EditorMode;
+    cancelActiveGesture(): boolean;
+}
+/** 键盘/剪贴板事件共享焦点与 Escape 优先级，集中路由可避免视图类继续膨胀。 */
+export declare class SlideEditorKeyboardEvents {
+    private readonly options;
+    constructor(options: SlideEditorKeyboardEventOptions);
+    readonly keydown: (event: KeyboardEvent) => void;
+    readonly keyup: (event: KeyboardEvent) => void;
+    readonly blur: () => void;
+    readonly copy: (event: ClipboardEvent) => void;
+    readonly cut: (event: ClipboardEvent) => void;
+    readonly paste: (event: ClipboardEvent) => void;
+}
+export {};

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

@@ -0,0 +1,90 @@
+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 { ImageBackgroundOptions, ImageInsertOptions, ImageReplaceOptions } from './image-insertion';
+import type { SnapMargins } from './snap';
+import type { TableInsertOptions } from './table-insertion';
+import type { FormatPainterStartOptions } from './format-painter-types';
+import type { TextSearchOpenOptions } from './text-search-types';
+export type EditorMode = 'view' | 'edit';
+export type LinkFollowSource = 'view' | 'edit' | 'api';
+export interface LinkFollowContext {
+    source: LinkFollowSource;
+    event?: MouseEvent | KeyboardEvent;
+}
+/** 返回 true 表示宿主已经完成路由，编辑器不再执行默认跳转。 */
+export type LinkFollowHandler = (target: LinkTarget, context: LinkFollowContext) => boolean | void;
+export interface SlideEditorOptions {
+    slideId?: SlideId;
+    mode?: EditorMode;
+    zoom?: number;
+    /** 默认 auto；受 WebKit foreignObject 缩放缺陷影响时自动切到原生 SVG 文本。 */
+    textMode?: 'auto' | 'html' | 'svg';
+    /** 默认开启；false 使本视图的移动手势保留原始指针位移。 */
+    snapping?: boolean;
+    /** 文档没有通用形状页边距；需要时由宿主在幻灯片 px 中显式给出。 */
+    snapMargins?: SnapMargins;
+    /** React/Vue 等宿主可接管路由；返回 true 阻止内置页跳转或安全新窗口。 */
+    onLinkFollow?: LinkFollowHandler;
+    /** 与自定义事件 webpptformaterror 同源，adapter 用它接入全局 onError。 */
+    onError?: (error: unknown) => void;
+}
+export interface SlideEditor {
+    readonly element: HTMLDivElement;
+    readonly mode: EditorMode;
+    readonly slideId: SlideId;
+    readonly zoom: number;
+    readonly snapping: boolean;
+    readonly destroyed: boolean;
+    setMode(mode: EditorMode): void;
+    setSlide(slideId: SlideId): void;
+    setZoom(zoom: number): void;
+    setSnapping(enabled: boolean): void;
+    /** 从当前单元素或文字选区启用会话级格式刷。 */
+    startFormatPainter(options?: FormatPainterStartOptions): boolean;
+    cancelFormatPainter(): void;
+    openTextSearch(options?: TextSearchOpenOptions): void;
+    closeTextSearch(): void;
+    nextTextSearch(): import('@web-ppt/edit-core').TextSearchMatch | null;
+    previousTextSearch(): import('@web-ppt/edit-core').TextSearchMatch | null;
+    replaceCurrentText(): boolean;
+    replaceAllText(): number;
+    /** 省略目标时跟随当前单一元素或文字选区；内部页始终使用稳定 SlideId。 */
+    followLink(target?: LinkTarget): boolean;
+    /** 注册外置工具栏，使其 pointer 交互不结束当前文字编辑。 */
+    registerTextUi(element: HTMLElement): () => void;
+    queryRunProps(): RunPropertiesState | null;
+    queryRunLink(): RunLinkState | null;
+    setRunProps(props: RunPropertyOverrides): boolean;
+    queryParaProps(): ParagraphPropertiesState | null;
+    setParaProps(props: ParagraphPropertyOverrides): boolean;
+    queryBodyProps(): TextBodyProperties | null;
+    setBodyProps(props: TextBodyPropertyOverrides): boolean;
+    insertImage(file: Blob, options?: ImageInsertOptions): Promise<ElementId>;
+    chooseImage(options?: ImageInsertOptions): Promise<ElementId | null>;
+    replaceImage(file: Blob, options?: ImageReplaceOptions): Promise<ElementId>;
+    chooseReplacementImage(options?: ImageReplaceOptions): Promise<ElementId | null>;
+    setBackgroundImage(file: Blob, options?: ImageBackgroundOptions): Promise<SlideId>;
+    chooseBackgroundImage(options?: ImageBackgroundOptions): Promise<SlideId | null>;
+    setBackgroundCrop(crop: ImageCrop | null): boolean;
+    queryTransition(): SlideTransitionState;
+    /** 查看模式同样可预览；省略值时播放当前页有效切换，不写模型。 */
+    previewTransition(value?: SlideTransitionInput): Promise<boolean>;
+    /** null 恢复来源；查看模式不改模型并返回 false。 */
+    setTransition(value: SlideTransitionInput | null): boolean;
+    queryAnimations(): SlideAnimationState;
+    /** 查看和编辑模式均可试听；传值时先校验草稿但不写模型。 */
+    previewAnimations(value?: readonly EditAnimationStep[]): Promise<boolean>;
+    /** null 恢复来源，空数组删除时间线；查看模式不改模型。 */
+    setAnimations(value: readonly EditAnimationStep[] | null): boolean;
+    queryLayout(): SlideLayoutState;
+    /** 只接受当前文档的 layoutId；查看模式不改模型。 */
+    setLayout(layoutId: string): boolean;
+    /** 普通 textarea 可直接读取当前页纯文本备注。 */
+    queryNotes(): SlideNotesState;
+    /** 查看模式不改模型并返回 false；空字符串表示显式清空。 */
+    setNotes(text: string): boolean;
+    insertTable(rows: number, cols: number, options?: TableInsertOptions): ElementId;
+    /** 双击图片之外的框架无关入口；省略 id 时使用当前单选图片。 */
+    startImageCrop(id?: ElementId): boolean;
+    endImageCrop(): void;
+    destroy(): void;
+}

package/dist/slide-editor.d.ts

@@ -0,0 +1,3 @@
+import type { EditorSession } from './session';
+import type { SlideEditor, SlideEditorOptions } from './slide-editor-types';
+export declare function createSlideEditor(container: HTMLElement, session: EditorSession, options?: SlideEditorOptions): SlideEditor;

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

@@ -0,0 +1,26 @@
+import type { Editor, LinkTarget, RunLinkState, SlideId } from '@web-ppt/edit-core';
+import type { EditorMode, LinkFollowHandler, LinkFollowSource } from './slide-editor-types';
+interface SlideLinkControllerOptions {
+    editor: Editor;
+    root: HTMLElement;
+    mode(): EditorMode;
+    slideId(): SlideId;
+    setSlide(slideId: SlideId): void;
+    queryRunLink(): RunLinkState | null;
+    onFollow?: LinkFollowHandler;
+}
+/** 单个 view 独占路由状态；共享的只有 headless 文档与选区。 */
+export declare class SlideLinkController {
+    private readonly options;
+    constructor(options: SlideLinkControllerOptions);
+    readonly click: (event: MouseEvent) => void;
+    readonly keydown: (event: KeyboardEvent) => void;
+    follow(target?: LinkTarget): boolean;
+    followSelection(source: LinkFollowSource, event?: KeyboardEvent): boolean;
+    private eventLinkNode;
+    private selectedValue;
+    private valueFromNode;
+    private followValue;
+    private perform;
+}
+export {};

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

@@ -0,0 +1,43 @@
+import type { Editor, ElementId, SlideId } from '@web-ppt/edit-core';
+import { ImageInsertionController } from './image-insertion';
+import type { MarqueeGestureController } from './marquee-gesture';
+import type { MoveGestureController } from './move-gesture';
+import type { ResizeGestureController } from './resize-gesture';
+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';
+interface SlidePointerControllerOptions {
+    readonly editor: Editor;
+    readonly root: HTMLElement;
+    readonly staticLayer: HTMLElement;
+    readonly interactionLayer: SVGSVGElement;
+    readonly textEditor: TextEditorController;
+    readonly imageInsertion: ImageInsertionController;
+    readonly marquee: MarqueeGestureController;
+    readonly move: MoveGestureController;
+    readonly resize: ResizeGestureController;
+    readonly rotation: RotationGestureController;
+    readonly crop: ImageCropGestureController;
+    editable(): boolean;
+    slideId(): SlideId;
+    hitCandidates(path: EventTarget[]): ElementId[];
+    formatPainter: {
+        active(): boolean;
+        apply(target: FormatPainterTarget): boolean;
+        error(error: unknown): void;
+    };
+}
+/** 统一路由画布 pointer 命中；视图生命周期类只负责装配控制器。 */
+export declare class SlidePointerController {
+    private readonly options;
+    constructor(options: SlidePointerControllerOptions);
+    readonly down: (event: PointerEvent) => void;
+    private applyFormat;
+    private pointedElement;
+    readonly move: (event: PointerEvent) => void;
+    readonly up: (event: PointerEvent) => void;
+    readonly cancel: (event: PointerEvent) => void;
+    readonly doubleClick: (event: MouseEvent) => void;
+}
+export {};

package/dist/snap-guides.d.ts

@@ -0,0 +1,3 @@
+import type { SnapGuide } from './snap';
+export declare function createSnapGuideLayer(document: Document): SVGGElement;
+export declare function renderSnapGuides(layer: SVGGElement, guides: readonly SnapGuide[], zoom: number): void;

package/dist/snap.d.ts

@@ -0,0 +1,60 @@
+import type { SpacePoint } from '@web-ppt/edit-core';
+export interface SnapBounds {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+}
+export interface SnapTarget {
+    id: string;
+    bounds: SnapBounds;
+}
+export interface SnapMargins {
+    left: number;
+    right: number;
+    top: number;
+    bottom: number;
+}
+export interface AlignmentSnapGuide {
+    kind: 'alignment';
+    axis: 'x' | 'y';
+    position: number;
+    start: number;
+    end: number;
+    source: 'canvas-center' | 'canvas-edge' | 'page-margin' | 'element-edge' | 'element-center';
+}
+export interface SpacingSnapGuide {
+    kind: 'spacing';
+    axis: 'x' | 'y';
+    cross: number;
+    intervals: readonly [
+        {
+            start: number;
+            end: number;
+        },
+        {
+            start: number;
+            end: number;
+        }
+    ];
+    source: 'equal-spacing';
+}
+export type SnapGuide = AlignmentSnapGuide | SpacingSnapGuide;
+export interface MoveSnapRequest {
+    bounds: SnapBounds;
+    delta: SpacePoint;
+    threshold: number;
+    siblings: readonly SnapTarget[];
+    slide: {
+        width: number;
+        height: number;
+    };
+    margins?: SnapMargins;
+}
+export interface MoveSnapResult {
+    delta: SpacePoint;
+    guides: SnapGuide[];
+}
+export declare function normalizeSnapMargins(margins: SnapMargins | undefined, slide: MoveSnapRequest['slide']): SnapMargins | undefined;
+/** 阈值和候选都在幻灯片空间，DOM 缩放与父组矩阵不会改变求解结果。 */
+export declare function snapMove(request: MoveSnapRequest): MoveSnapResult;

package/dist/source-fingerprint.d.ts

@@ -0,0 +1,9 @@
+export type WebPptSource = File | Blob | ArrayBuffer | Uint8Array;
+export interface WebPptSourceIdentity {
+    readonly fingerprint: `sha256:${string}`;
+    readonly byteLength: number;
+}
+export declare function sourceBytes(source: WebPptSource): Promise<Uint8Array<ArrayBuffer>>;
+export declare function fingerprintSourceBytes(bytes: Uint8Array<ArrayBuffer>): Promise<WebPptSourceIdentity>;
+/** 只按完整源字节识别恢复日志；文件名与时间戳都不是内容身份。 */
+export declare function fingerprintSource(source: WebPptSource): Promise<WebPptSourceIdentity>;

package/dist/table-insertion.d.ts

@@ -0,0 +1,7 @@
+import { type AddTableCommand, type Editor, type ElementId, type SlideId } from '@web-ppt/edit-core';
+export interface TableInsertOptions {
+    readonly rect?: AddTableCommand['rect'];
+    /** 通常无需传；显式工具栏可指定要原子替换的空内容占位符。 */
+    readonly placeholderId?: ElementId;
+}
+export declare function insertTable(editor: Editor, slideId: SlideId, rows: number, cols: number, options?: TableInsertOptions): ElementId;

package/dist/text-autofit.d.ts

@@ -0,0 +1,18 @@
+import type { ElementId, TableCellAddress } from '@web-ppt/edit-core';
+import type { ActiveText } from './text-editor-types';
+export interface TextAutofitTarget {
+    id: ElementId;
+    cell: TableCellAddress | null;
+}
+/** normAutofit 是视图派生状态；输入突发期不应污染可序列化文档与历史。 */
+export declare class TextAutofitThrottle {
+    private readonly view;
+    private current;
+    private timer;
+    constructor(view: Window);
+    displayScale(active: ActiveText): number | undefined;
+    schedule(active: ActiveText, settle: (target: TextAutofitTarget) => void): void;
+    settle(active: ActiveText, expectedTarget: TextAutofitTarget): boolean;
+    reset(): void;
+    private cancelTimer;
+}