@web-ppt/editor 0.5.0-beta.1

package/dist/text-clipboard-controller.d.ts

@@ -0,0 +1,32 @@
+import type { TextBody } from '@web-ppt/core';
+import type { RunPropertyOverrides, TextEditOp, TextPosition } from '@web-ppt/edit-core';
+interface ClipboardTextContext {
+    text: TextBody;
+    positions: {
+        from: TextPosition;
+        to: TextPosition;
+    };
+}
+interface TextClipboardControllerOptions {
+    enabled(): boolean;
+    context(): ClipboardTextContext | null;
+    pendingProps(): RunPropertyOverrides;
+    commit(ops: readonly TextEditOp[], nextIndex: number, label: string): void;
+}
+export declare class TextClipboardController {
+    private readonly options;
+    private root;
+    private pasteIntent;
+    constructor(options: TextClipboardControllerOptions);
+    bind(root: HTMLDivElement): void;
+    release(): void;
+    beforeInput(event: InputEvent): boolean;
+    private copy;
+    private cut;
+    private paste;
+    private armPlainPasteIntent;
+    private consumePlainPasteIntent;
+    private resetPasteIntent;
+    private insert;
+}
+export {};

package/dist/text-clipboard.d.ts

@@ -0,0 +1,7 @@
+import type { TextFragment } from '@web-ppt/edit-core';
+type ClipboardPort = Pick<DataTransfer, 'getData' | 'setData'>;
+export declare function plainTextFragment(text: string): TextFragment;
+export declare function readTextClipboard(data: Pick<DataTransfer, 'getData'> | null, document: Document, plainOnly?: boolean): TextFragment | null;
+export declare function textFragmentToHtml(fragment: TextFragment): string;
+export declare function writeTextClipboard(data: ClipboardPort | null, plain: string, html: string): boolean;
+export {};

package/dist/text-dom.d.ts

@@ -0,0 +1,30 @@
+import type { TextBody } from '@web-ppt/core';
+import type { TextPosition } from '@web-ppt/edit-core';
+export interface DomRead {
+    valid: boolean;
+    text: string;
+}
+/** 未知浏览器包装只取纯文本，格式绝不从 DOM 私有样式反写。 */
+export declare function readEditableDom(root: ParentNode): DomRead;
+export declare function rangePositions(root: HTMLElement, body: TextBody): {
+    from: TextPosition;
+    to: TextPosition;
+} | null;
+export declare function caretPointAt(container: HTMLElement | SVGElement, offset: number): {
+    node: Node;
+    offset: number;
+};
+/** engine 行盒会把同一 run 拆成多个标记；边界优先落到下一视觉行，run 末尾才落前一段。 */
+export declare function domPointAt(root: Element, position: TextPosition, markerKind?: 'edit' | 'search'): {
+    node: Node;
+    offset: number;
+} | null;
+export declare function compositionChangedRange(before: string, after: string, from: number, to: number): {
+    from: number;
+    to: number;
+    text: string;
+} | null;
+export declare function rebaseRange(base: string, current: string, from: number, to: number): {
+    from: number;
+    to: number;
+} | null;

package/dist/text-editor-context.d.ts

@@ -0,0 +1,13 @@
+import type { TextBody } from '@web-ppt/core';
+import type { Editor, ElementId, TableCellAddress, TextPosition } from '@web-ppt/edit-core';
+import type { ActiveText } from './text-editor-types';
+export interface TextEditorContext {
+    id: ElementId;
+    cell: TableCellAddress | null;
+    text: TextBody;
+    positions: {
+        from: TextPosition;
+        to: TextPosition;
+    };
+}
+export declare function resolveTextEditorContext(editor: Editor, active: ActiveText, root: HTMLDivElement): TextEditorContext | null;

package/dist/text-editor-target.d.ts

@@ -0,0 +1,10 @@
+import type { TableElement } from '@web-ppt/core';
+import type { Editor, TableCellAddress } from '@web-ppt/edit-core';
+import type { ActiveText } from './text-editor-types';
+export declare const sameTextCell: (left: TableCellAddress | null | undefined, right: TableCellAddress | null | undefined) => boolean;
+export declare function textTargetFields(cell: TableCellAddress | null): {
+    cell?: TableCellAddress;
+};
+export declare function resolveActiveText(editor: Editor, id: string, address: TableCellAddress | null): ActiveText | null;
+export declare function editableTableCells(table: TableElement): TableCellAddress[];
+export declare function nextEditableTableCell(table: TableElement, current: TableCellAddress, reverse: boolean): TableCellAddress | null;

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

@@ -0,0 +1,30 @@
+import type { TextBody, TextVert } from '@web-ppt/core';
+import type { AffineMatrix, Editor, ElementId, TableCellAddress } from '@web-ppt/edit-core';
+export interface TextEditorControllerOptions {
+    editor: Editor;
+    boundary: HTMLElement;
+    staticLayer: HTMLElement;
+    textLayer: HTMLElement;
+    textLayout: 'browser' | 'engine';
+    slideId: () => string;
+    claim: () => void;
+    release: () => void;
+    syncStatic: (id: ElementId) => void;
+}
+export interface CompositionSnapshot {
+    domText: string;
+    modelText: string;
+    from: number;
+    to: number;
+}
+export interface ActiveText {
+    id: ElementId;
+    cell?: TableCellAddress;
+    text: TextBody;
+    width: number;
+    height: number;
+    matrix: AffineMatrix;
+    insets?: readonly [number, number, number, number];
+    anchor?: TextBody['anchor'];
+    vert?: TextVert;
+}

package/dist/text-editor-view.d.ts

@@ -0,0 +1,4 @@
+import type { TextPosition } from '@web-ppt/edit-core';
+import type { ActiveText } from './text-editor-types';
+export declare function createTextEditorRoot(document: Document, active: ActiveText, layout: 'browser' | 'engine', scale?: number): HTMLDivElement;
+export declare function setTextDomSelection(root: HTMLDivElement, anchor: TextPosition, focus: TextPosition): void;

package/dist/text-editor.d.ts

@@ -0,0 +1,51 @@
+import type { EditorChange, ElementId, ParagraphPropertiesState, ParagraphPropertyOverrides, RunLinkState, RunPropertiesState, RunPropertyOverrides, TableCellAddress } from '@web-ppt/edit-core';
+import type { TextEditorControllerOptions } from './text-editor-types';
+export declare class TextEditorController {
+    private readonly options;
+    private readonly clipboard;
+    private readonly autofit;
+    private activeId;
+    private activeCell;
+    private root;
+    private composing;
+    private composition;
+    private pendingRunProps;
+    private staticStale;
+    private readonly hidden;
+    private readonly externalUi;
+    private readonly onDocumentPointerDown;
+    constructor(options: TextEditorControllerOptions);
+    get isActive(): boolean;
+    get activeElementId(): ElementId | null;
+    get isComposing(): boolean;
+    registerExternalUi(element: HTMLElement): () => void;
+    queryRunProps(): RunPropertiesState | null;
+    queryRunLink(): RunLinkState | null;
+    queryParaProps(): ParagraphPropertiesState | null;
+    setParaProps(props: ParagraphPropertyOverrides): boolean;
+    setRunProps(props: RunPropertyOverrides): boolean;
+    owns(target: EventTarget | null): boolean;
+    enter(id: ElementId): boolean;
+    enterCell(id: ElementId, cell: TableCellAddress): boolean;
+    private enterTarget;
+    releaseTextEditing(): void;
+    close(selectElement?: boolean): void;
+    update(change: EditorChange): void;
+    refreshStatic(): void;
+    destroy(): void;
+    private textContext;
+    private activeText;
+    private render;
+    private settleAutofit;
+    private bind;
+    private navigateTableCell;
+    private syncSelection;
+    private beforeInput;
+    private commit;
+    private endComposition;
+    private formatSelection;
+    private setSelection;
+    private setCaret;
+    private hideStaticText;
+    private restoreStaticText;
+}

package/dist/text-input-plan.d.ts

@@ -0,0 +1,20 @@
+import type { TextBody } from '@web-ppt/core';
+import type { TextEditOp, TextPosition } from '@web-ppt/edit-core';
+export type TextInputPlan = {
+    readonly type: 'format';
+    readonly field: 'b' | 'i' | 'u';
+} | {
+    readonly type: 'history';
+    readonly direction: 'undo' | 'redo';
+} | {
+    readonly type: 'edit';
+    readonly ops: readonly TextEditOp[];
+    readonly nextIndex: number;
+    readonly insertedFrom: number | null;
+    readonly label: string;
+};
+/** beforeinput 只描述意图；这里把浏览器事件归一成无 DOM 的模型操作计划。 */
+export declare function planTextInput(text: TextBody, positions: {
+    readonly from: TextPosition;
+    readonly to: TextPosition;
+}, inputType: string, data: string | null): TextInputPlan | null;

package/dist/text-search-highlight.d.ts

@@ -0,0 +1,18 @@
+import type { TextSearchMatch } from '@web-ppt/edit-core';
+/** 只修改计数变化的元素和当前范围；导航不会重写整页命中 DOM。 */
+export declare class TextSearchHighlightProjection {
+    private readonly root;
+    private readonly staticLayer;
+    private readonly overlay;
+    private readonly counts;
+    private readonly rangeMarkers;
+    private currentSlide;
+    private currentTarget;
+    constructor(root: HTMLElement, staticLayer: HTMLElement, overlay: HTMLElement);
+    sync(matches: readonly TextSearchMatch[], current: TextSearchMatch | null, slideId: string): void;
+    clear(): void;
+    private syncCounts;
+    private syncCurrent;
+    private markRange;
+    private clearCurrent;
+}

package/dist/text-search-index.d.ts

@@ -0,0 +1,11 @@
+import type { Editor, FindTextRequest, TextSearchMatch } from '@web-ppt/edit-core';
+/** 查询结果按页懒缓存；事务只淘汰脏页，页序变化只重组数组。 */
+export declare class SessionTextSearchIndex {
+    private readonly editor;
+    private readonly cache;
+    private readonly unsubscribe;
+    private isDisposed;
+    constructor(editor: Editor);
+    find(request: FindTextRequest): readonly TextSearchMatch[];
+    dispose(): void;
+}

package/dist/text-search-types.d.ts

@@ -0,0 +1,41 @@
+import type { FindTextRequest, TextSearchMatch, TextSearchScope } from '@web-ppt/edit-core';
+export type TextSearchMode = 'find' | 'replace';
+export interface TextSearchOpenOptions {
+    readonly mode?: TextSearchMode;
+    readonly query?: string;
+    readonly replacement?: string;
+    readonly scope?: TextSearchScope;
+    readonly matchCase?: boolean;
+    readonly wholeWord?: boolean;
+}
+export type TextSearchOptions = Pick<FindTextRequest, 'scope' | 'matchCase' | 'wholeWord'>;
+export interface TextSearchSnapshot {
+    readonly open: boolean;
+    readonly mode: TextSearchMode;
+    readonly query: string;
+    readonly replacement: string;
+    readonly scope: TextSearchScope;
+    readonly matchCase: boolean;
+    readonly wholeWord: boolean;
+    readonly matches: readonly TextSearchMatch[];
+    readonly currentIndex: number;
+    readonly current: TextSearchMatch | null;
+    /** 外部事务让原精确范围消失；控制器已尽力重基到同一目标或相邻命中。 */
+    readonly currentInvalidated: boolean;
+}
+export type TextSearchSubscriber = (snapshot: TextSearchSnapshot) => void;
+export interface TextSearch {
+    readonly snapshot: TextSearchSnapshot;
+    readonly disposed: boolean;
+    open(options?: TextSearchOpenOptions): void;
+    close(): void;
+    setQuery(query: string): void;
+    setReplacement(replacement: string): void;
+    setOptions(options: Partial<TextSearchOptions>): void;
+    next(): TextSearchMatch | null;
+    previous(): TextSearchMatch | null;
+    replaceCurrent(): boolean;
+    replaceAll(): number;
+    subscribe(subscriber: TextSearchSubscriber): () => void;
+    dispose(): void;
+}

package/dist/text-search-view.d.ts

@@ -0,0 +1,33 @@
+import type { TextSearchMatch } from '@web-ppt/edit-core';
+import type { EditorMode } from './slide-editor-types';
+import type { TextSearch, TextSearchOpenOptions } from './text-search-types';
+/** 每个视图只投影会话搜索状态；导航只让发起动作的视图跨页。 */
+export declare class TextSearchViewBinding {
+    private readonly root;
+    private readonly search;
+    private readonly mode;
+    private readonly readonlyDocument;
+    private readonly slideId;
+    private readonly reveal;
+    private readonly onError?;
+    readonly overlay: HTMLDivElement;
+    private readonly unsubscribe;
+    private readonly highlight;
+    private readonly originalAriaLabel;
+    constructor(root: HTMLElement, staticLayer: HTMLElement, search: TextSearch, mode: () => EditorMode, readonlyDocument: () => boolean, slideId: () => string, reveal: (match: TextSearchMatch) => void, onError?: ((error: unknown) => void) | undefined);
+    open(options: TextSearchOpenOptions): void;
+    close(): void;
+    next(): TextSearchMatch | null;
+    previous(): TextSearchMatch | null;
+    replaceCurrent(): boolean;
+    replaceAll(): number;
+    sync(): void;
+    destroy(): void;
+    readonly keydown: (event: KeyboardEvent) => boolean;
+    private navigate;
+    private revealCurrent;
+    private ariaLabel;
+    private consume;
+    private report;
+    private restoreAriaLabel;
+}

package/dist/text-search.d.ts

@@ -0,0 +1,46 @@
+import type { Editor, TextSearchMatch } from '@web-ppt/edit-core';
+import type { TextSearch, TextSearchOpenOptions, TextSearchOptions, TextSearchSnapshot, TextSearchSubscriber } from './text-search-types';
+/** 会话只保留模型身份与纯数据状态；DOM 视图和框架包都是薄消费者。 */
+export declare class SessionTextSearch implements TextSearch {
+    private readonly editor;
+    private readonly index;
+    private readonly unsubscribeEditor;
+    private readonly subscribers;
+    private currentMatches;
+    private currentIndex;
+    private isOpen;
+    private mode;
+    private query;
+    private replacement;
+    private scope;
+    private matchCase;
+    private wholeWord;
+    private invalidated;
+    private currentSnapshot;
+    private mutating;
+    private isDisposed;
+    constructor(editor: Editor);
+    get snapshot(): TextSearchSnapshot;
+    get disposed(): boolean;
+    open(options?: TextSearchOpenOptions): void;
+    close(): void;
+    setQuery(query: string): void;
+    setReplacement(replacement: string): void;
+    setOptions(options: Partial<TextSearchOptions>): void;
+    next(): TextSearchMatch | null;
+    previous(): TextSearchMatch | null;
+    replaceCurrent(): boolean;
+    replaceAll(): number;
+    subscribe(subscriber: TextSearchSubscriber): () => void;
+    dispose(): void;
+    private refresh;
+    private step;
+    private request;
+    private snapshotOf;
+    private publish;
+    private assertQuery;
+    private assertReplacement;
+    private assertScope;
+    private assertBoolean;
+    private assertActive;
+}

package/dist/transform-frame.d.ts

@@ -0,0 +1,14 @@
+import type { AffineMatrix, EditDoc, ElementFrameTransform, 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。 */
+export declare function transformPreviewMatrix(source: TransformFrame, next: TransformFrame): AffineMatrix;
+export declare function transformFrameCorners(doc: EditDoc, id: ElementId, frame: TransformFrame): [
+    SpacePoint,
+    SpacePoint,
+    SpacePoint,
+    SpacePoint
+];

package/dist/transition-preview.d.ts

@@ -0,0 +1,24 @@
+import type { Transition } from '@web-ppt/core';
+import { type SlideTransitionInput } from '@web-ppt/edit-core';
+interface TransitionPreviewOptions {
+    readonly layer: HTMLElement;
+    readonly chrome?: readonly (HTMLElement | SVGElement)[];
+    current(): Transition | undefined;
+    destroyed(): boolean;
+}
+/** 预览只拥有 Web Animations；模型、历史和产品面板状态都留在既有边界。 */
+export declare class TransitionPreviewController {
+    private readonly options;
+    private generation;
+    private playback;
+    private outgoing;
+    private chromeVisibility;
+    constructor(options: TransitionPreviewOptions);
+    preview(input?: SlideTransitionInput): Promise<boolean>;
+    cancel(): void;
+    private releaseAnimations;
+    private hideChrome;
+    private restoreChrome;
+    private previewOutgoing;
+}
+export {};

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@web-ppt/editor",
+  "version": "0.5.0-beta.1",
+  "description": "Framework-agnostic browser editing session and DOM view for Web-PPT.",
+  "keywords": [
+    "pptx",
+    "powerpoint",
+    "editor",
+    "browser",
+    "svg",
+    "react",
+    "vue",
+    "typescript"
+  ],
+  "license": "MIT",
+  "author": "unStone",
+  "homepage": "https://github.com/unStone/web-ppt#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/unStone/web-ppt.git",
+    "directory": "packages/editor"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/editor.js",
+  "module": "./dist/editor.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/editor.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "vite build && tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run build",
+    "prepack": "node ../../tooling/sync-package-docs.mjs"
+  },
+  "peerDependencies": {
+    "@web-ppt/core": "^0.5.0-beta.1",
+    "@web-ppt/edit-core": "^0.5.0-beta.1",
+    "@web-ppt/viewer-core": "^0.5.0-beta.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}