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

package/dist/history.d.ts

@@ -3,6 +3,8 @@ interface StoredHistoryEntry extends HistoryEntry {
     readonly beforeState: number;
     readonly afterState: number;
     readonly links: readonly StoredPatchLink[];
+    /** 条目内容不可变；创建时精确计量一次，清理 redo 不再重复序列化大结构快照。 */
+    readonly storedBytes: number;
 }
 interface StoredPatchLink {
     readonly trigger: string;
@@ -13,10 +15,15 @@ export interface HistoryPatchLink {
     readonly related: readonly Patch['path'][];
 }
 export interface HistoryStoreHooks {
+    readonly canonicalPath?: (path: Patch['path']) => Patch['path'];
+    /** 资源闭包等宿主约束也适用于合并历史；不满足时仍保留两个独立撤销单元。 */
+    readonly canMerge?: (entry: HistoryEntry) => boolean;
     /** 不复制进 Patch、但仅因历史可达而常驻的外部资源字节。 */
     readonly externalByteSize?: (entries: readonly HistoryEntry[]) => number;
     /** 历史驱逐/清空后通知资源所有者做可达性回收。 */
     readonly changed?: (entries: readonly HistoryEntry[]) => void;
+    /** 结构历史内的字段仍受后来写入约束；只重基快照，不撤销结构意图。 */
+    readonly rebase?: (entry: HistoryEntry, patches: readonly Patch[]) => HistoryEntry;
 }
 export declare function cloneHistoryEntry(entry: HistoryEntry): HistoryEntry;
 export declare class HistoryStore implements History {
@@ -36,8 +43,10 @@ export declare class HistoryStore implements History {
     get redoEntries(): readonly HistoryEntry[];
     clear(): void;
     breakMerge(): void;
+    /** 快照派生与证据验证可失败，须先完成，再允许宿主提交模型。 */
+    prepareRebase(patches: readonly Patch[]): ReadonlyMap<HistoryEntry, HistoryEntry>;
     /** 后到的非记录写入胜出；旧历史只保留未冲突路径，避免撤销覆盖远端或系统改动。 */
-    rebaseUnrecorded(patches: readonly Patch[], currentState: number, allocateState: () => number): void;
+    rebaseUnrecorded(patches: readonly Patch[], currentState: number, allocateState: () => number, prepared?: ReadonlyMap<HistoryEntry, HistoryEntry>): void;
     push(entry: HistoryEntry, beforeState: number, afterState: number, links?: readonly HistoryPatchLink[]): void;
     peekUndo(): StoredHistoryEntry | null;
     peekRedo(): StoredHistoryEntry | null;
@@ -45,6 +54,7 @@ export declare class HistoryStore implements History {
     moveToUndo(): void;
     private entries;
     private rebudget;
+    private withStoredBytes;
     private sizeOf;
 }
 export {};

package/dist/hyperlink.d.ts

@@ -1,5 +1,7 @@
+import type { SlideElement } from '@web-ppt/core';
 import type { EditDoc, ElementId, ElementLinkState, LinkOverride, LinkSourceValue, LinkTarget } from './types';
 export declare const MAX_EXTERNAL_LINK_LENGTH = 2048;
+export declare const supportsElementLink: (kind: SlideElement["kind"]) => boolean;
 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;

package/dist/identities.d.ts

@@ -0,0 +1,4 @@
+export type ElementId = string;
+export type SlideId = string;
+export type SectionId = string;
+export type FractionalIndex = string;

package/dist/identity-allocation.d.ts

@@ -0,0 +1,12 @@
+import type { EditIdentity, EditIdentityAllocation, EditIdentityRange } from './types';
+/** JSON number 协议的显式上限；达到上限时必须在编辑落模前失败，不能静默停止广播。 */
+export declare const MAX_COLLABORATION_VERSION = 4294967295;
+export declare function assertIdentityAllocation(value: unknown, label?: string, basePrefix?: string): asserts value is EditIdentityAllocation;
+export declare function configureIdentityAllocation(identity: EditIdentity, replicaId: string, slot: number, count?: number): void;
+export declare function ensureIdentityRange(identity: EditIdentity, key: string, first: number, maximum?: number): EditIdentityRange | null;
+export declare function allocateIdentityRange(identity: EditIdentity, key: string, first: number, maximum?: number): number | null;
+export declare const logicalIdentityPrefix: (identity: EditIdentity) => string;
+/** 在编辑落模前调用；版本耗尽必须先拒绝事务，不能留下未广播的本地状态。 */
+export declare function assertCollaborationVersionAvailable(identity: EditIdentity): void;
+/** Editor 在恢复帧取样前预留本地消息版本。 */
+export declare function advanceCollaborationVersion(identity: EditIdentity): void;

package/dist/identity-watermark.d.ts

@@ -0,0 +1,4 @@
+import type { EditIdentity } from './types';
+export declare function assertEditIdentityWatermark(value: unknown): asserts value is EditIdentity;
+/** 不同副本使用不同逻辑 id 前缀；只有 OPC 的全局数值水位需要跨副本取最大值。 */
+export declare function mergeEditIdentityWatermark(target: EditIdentity, source: EditIdentity): void;

package/dist/image-content.d.ts

@@ -1,7 +1,10 @@
 import type { ImageElement } from '@web-ppt/core';
-import type { EditDoc, ElementCropState, ElementId, ImageCrop } from './types';
+import type { EditDoc, ElementCropState, ElementId, ElementRecord, 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;
+/** 海报只能改普通媒体宿主的 blip，不能越过兼容分支或开放媒体裁剪。 */
+export declare function canEditImageContent(record: ElementRecord, poster?: boolean): record is ElementRecord & {
+    src: ImageElement;
+};
 export declare function queryElementCrop(doc: EditDoc, ids: readonly ElementId[]): ElementCropState;

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

@@ -1,5 +1,7 @@
 import type { HistoryEntry, Patch } from './commands/types';
 import type { EditDoc } from './types';
+/** 接收端没有本地历史，撤销后可以回收图片；传输引用必须同时补齐内容寻址资源。 */
+export declare function imageResourcePatchClosure(doc: EditDoc, patches: readonly Patch[], origin: string): Patch[];
 /** 结构历史也可能包住整棵元素快照，因此不能只识别直接 imageReplacement Patch。 */
 export declare function historyImageResourceHashes(entries: readonly HistoryEntry[]): Set<string>;
 export declare function activeImageResourceHashes(doc: EditDoc): Set<string>;