@web-ppt/edit-core 0.5.0-beta.1

package/dist/editor.d.ts

@@ -0,0 +1,38 @@
+import type { Command, EditorChange, EditorOptions, EditorSubscriber, History, Selection, Transaction, TransactionOptions, TransactionResult } from './commands/types';
+import type { OpcPatchResult } from './opc/types';
+import type { RecoverySubscriber } from './recovery-types';
+import type { EditDoc, ElementId, SlideId } from './types';
+export declare class Editor {
+    readonly doc: EditDoc;
+    readonly history: History;
+    private readonly historyStore;
+    private readonly origin;
+    private readonly subscribers;
+    private readonly recoveryJournal;
+    private currentSelection;
+    private currentState;
+    private savedState;
+    private nextState;
+    private activeImageResources;
+    constructor(doc: EditDoc, options?: EditorOptions);
+    get selection(): Selection;
+    isDirty(): boolean;
+    save(): Promise<Uint8Array>;
+    saveDetailed(): Promise<OpcPatchResult>;
+    markSaved(): void;
+    select(selection: Selection): void;
+    subscribe(subscriber: EditorSubscriber): () => void;
+    subscribeRecovery(subscriber: RecoverySubscriber): () => void;
+    exec(...commands: Command[]): TransactionResult;
+    transaction(callback: (transaction: Transaction) => void, label: string, options?: TransactionOptions): TransactionResult;
+    undo(): EditorChange | null;
+    redo(): EditorChange | null;
+    toSlide(id: SlideId): import("@web-ppt/core").Slide;
+    effectiveElement(id: ElementId): import("@web-ppt/core").SlideElement;
+    private commit;
+    private emitRecovery;
+    private emit;
+    private refreshActiveImageResources;
+    private historyImageResourceBytes;
+    private pruneImageResources;
+}

package/dist/element-ancestry.d.ts

@@ -0,0 +1,3 @@
+import type { EditDoc, ElementId, ElementRecord } from './types';
+/** 父链是热路径；统一环检测，避免锁定、隐藏与选区各自复制且逐渐分叉。 */
+export declare function elementOrAncestorMatches(doc: EditDoc, id: ElementId, predicate: (record: ElementRecord) => boolean): boolean;

package/dist/element-name.d.ts

@@ -0,0 +1,4 @@
+import type { ElementRecord } from './types';
+export declare const MAX_ELEMENT_NAME_LENGTH = 255;
+export declare function assertElementName(value: unknown, label?: string): asserts value is string;
+export declare function elementName(record: ElementRecord): string;

package/dist/element-order.d.ts

@@ -0,0 +1,7 @@
+import type { EditDoc, ElementId, ElementRecord, FractionalIndex } from './types';
+export declare function elementOrder(record: Pick<ElementRecord, 'z' | 'order'>): FractionalIndex;
+export declare function elementParentChildren(doc: EditDoc, parent: string): ElementId[];
+/** 母版/版式与歧义宿主留在固定槽位；层级命令只重排可可靠写回的同 part 直属节点。 */
+export declare function writableLayerSiblingIds(doc: EditDoc, record: ElementRecord): ElementId[];
+/** 同一事务可能改多个键；最后只排序一次，避免多选操作退化成逐元素全量搬移。 */
+export declare function sortElementChildrenByOrder(doc: EditDoc, parent: string): void;

package/dist/field-text.d.ts

@@ -0,0 +1,3 @@
+import type { TextBody } from '@web-ppt/core';
+/** 字段内容属于页面；版式字段节点上的直设格式只是缓存，克隆时必须回到继承层。 */
+export declare function fieldTextWithoutDirect(source: TextBody): TextBody;

package/dist/fractional-index.d.ts

@@ -0,0 +1,10 @@
+import type { FractionalIndex } from './types';
+export declare function assertFractionalIndex(key: string): void;
+/** 初始兄弟顺序留出 61 个直接插槽，避免导入大文档时键长随元素数增长。 */
+export declare function initialFractionalIndex(index: number): FractionalIndex;
+/**
+ * `discriminator` 供协同插入传稳定唯一值（通常就是新元素 ULID）。中点本身已在边界的
+ * 某一位留出严格间隙，因此追加编码后仍在原开区间内；不同客户端不会占用同一个 z。
+ */
+export declare function fractionalIndexBetween(lower: FractionalIndex | null, upper: FractionalIndex | null, discriminator?: string): FractionalIndex;
+export declare function compareFractionalIndex(a: FractionalIndex, b: FractionalIndex): number;

package/dist/history.d.ts

@@ -0,0 +1,50 @@
+import type { History, HistoryEntry, Patch } from './commands/types';
+interface StoredHistoryEntry extends HistoryEntry {
+    readonly beforeState: number;
+    readonly afterState: number;
+    readonly links: readonly StoredPatchLink[];
+}
+interface StoredPatchLink {
+    readonly trigger: string;
+    readonly related: readonly string[];
+}
+export interface HistoryPatchLink {
+    readonly trigger: Patch['path'];
+    readonly related: readonly Patch['path'][];
+}
+export interface HistoryStoreHooks {
+    /** 不复制进 Patch、但仅因历史可达而常驻的外部资源字节。 */
+    readonly externalByteSize?: (entries: readonly HistoryEntry[]) => number;
+    /** 历史驱逐/清空后通知资源所有者做可达性回收。 */
+    readonly changed?: (entries: readonly HistoryEntry[]) => void;
+}
+export declare function cloneHistoryEntry(entry: HistoryEntry): HistoryEntry;
+export declare class HistoryStore implements History {
+    private readonly undoList;
+    private readonly redoList;
+    private readonly limit;
+    private readonly byteLimit;
+    private readonly hooks;
+    private bytes;
+    private externalBytes;
+    private mergeBarrier;
+    constructor(limit?: number, byteLimit?: number, hooks?: HistoryStoreHooks);
+    get undoCount(): number;
+    get redoCount(): number;
+    get byteSize(): number;
+    get undoEntries(): readonly HistoryEntry[];
+    get redoEntries(): readonly HistoryEntry[];
+    clear(): void;
+    breakMerge(): void;
+    /** 后到的非记录写入胜出；旧历史只保留未冲突路径，避免撤销覆盖远端或系统改动。 */
+    rebaseUnrecorded(patches: readonly Patch[], currentState: number, allocateState: () => number): void;
+    push(entry: HistoryEntry, beforeState: number, afterState: number, links?: readonly HistoryPatchLink[]): void;
+    peekUndo(): StoredHistoryEntry | null;
+    peekRedo(): StoredHistoryEntry | null;
+    moveToRedo(): void;
+    moveToUndo(): void;
+    private entries;
+    private rebudget;
+    private sizeOf;
+}
+export {};

package/dist/hyperlink.d.ts

@@ -0,0 +1,10 @@
+import type { EditDoc, ElementId, ElementLinkState, LinkOverride, LinkSourceValue, LinkTarget } from './types';
+export declare const MAX_EXTERNAL_LINK_LENGTH = 2048;
+export declare function normalizeExternalLinkTarget(href: string): LinkTarget | null;
+export declare function assertLinkOverride(value: unknown, label: string): asserts value is LinkOverride;
+export declare function normalizeLinkTarget(doc: EditDoc, value: LinkOverride, label: string): LinkOverride;
+export declare function sourceLinkValue(doc: EditDoc, link: string | undefined): LinkSourceValue | null;
+export declare function renderLinkTarget(doc: EditDoc, target: LinkTarget): string | undefined;
+export declare function sourceLinkReadonly(value: LinkSourceValue | null): boolean;
+export declare function linkValueFollowable(doc: EditDoc, value: LinkSourceValue | null): boolean;
+export declare function queryElementLink(doc: EditDoc, ids: readonly ElementId[]): ElementLinkState;

package/dist/image-content.d.ts

@@ -0,0 +1,7 @@
+import type { ImageElement } from '@web-ppt/core';
+import type { EditDoc, ElementCropState, ElementId, ImageCrop } from './types';
+export declare function assertImageCrop(value: unknown, label: string): asserts value is ImageCrop;
+/** srcRect 用十万分数保存；命令入口先收敛，避免保存重开制造脏状态。 */
+export declare function normalizeImageCrop(crop: ImageCrop): ImageCrop;
+export declare function isEditablePicture(element: ImageElement): boolean;
+export declare function queryElementCrop(doc: EditDoc, ids: readonly ElementId[]): ElementCropState;

package/dist/image-resource-history.d.ts

@@ -0,0 +1,6 @@
+import type { HistoryEntry, Patch } from './commands/types';
+import type { EditDoc } from './types';
+/** 结构历史也可能包住整棵元素快照，因此不能只识别直接 imageReplacement Patch。 */
+export declare function historyImageResourceHashes(entries: readonly HistoryEntry[]): Set<string>;
+export declare function activeImageResourceHashes(doc: EditDoc): Set<string>;
+export declare function imageReachabilityMayChange(patches: readonly Patch[]): boolean;