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

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

@@ -0,0 +1,25 @@
+import type { TextBody } from '@web-ppt/core';
+import type { EditDoc, ElementRecord, TableCellAddress, TableCellRowRef, TextOverride } from '../types';
+import type { ElementTextPatch } from './types';
+export interface TextTarget {
+    readonly id: string;
+    readonly cell?: TableCellAddress;
+}
+export interface TextTargetContext {
+    readonly record: ElementRecord;
+    readonly body: TextBody;
+    readonly before: TextOverride | undefined;
+    readonly patchTarget: TextPatchTarget;
+    readonly empty: boolean;
+}
+export interface TextPatchTarget {
+    readonly id: string;
+    readonly cell?: {
+        readonly row: TableCellRowRef;
+        readonly c: number;
+    };
+}
+export declare function textTargetContextForRecord(record: ElementRecord, target: TextTarget): TextTargetContext;
+export declare function textTargetContext(doc: EditDoc, target: TextTarget): TextTargetContext;
+export declare function setTextPatch(target: TextPatchTarget, value: TextOverride, origin: string): ElementTextPatch;
+export declare function inverseTextPatch(target: TextPatchTarget, before: TextOverride | undefined, origin: string): ElementTextPatch;

package/dist/commands/types.d.ts

@@ -0,0 +1,509 @@
+import type { Effects, Fill, Stroke } from '@web-ppt/core';
+import type { ElementId, ElementImageReplacement, ElementInsertionResource, ElementRecord, ImageCrop, LinkOverride, LinkTarget, ParagraphPropertyOverrides, ProjectionInvalidation, RunPropertyOverrides, SlideId, TextFragment, TextOverride, SlideRecord, TableCellAddress, TextBodyPropertyOverrides } from '../types';
+import type { ElementClipboardPayload } from './clipboard-types';
+import type { SetBackgroundCommand, SetBackgroundCropCommand, SetBackgroundImageCommand, SetHiddenCommand, SetAnimationsCommand, SetTransitionCommand, SetLayoutCommand, SetNotesCommand, SlideLayoutPatch, SlideNotesPatch, SlidePropertyPatch } from './slide-property-types';
+import type { ApplyFormatCommand } from './format-painter-types';
+import type { ReplaceTextCommand } from '../text-search-types';
+export type { ClipboardElementRecord, ClipboardPortableLink, ClipboardRelationship, ClipboardResource, ClipboardTextLink, ClipboardXmlRoot, ElementClipboardPayload, ElementClipboardRecordMeta, } from './clipboard-types';
+export type { SetBackgroundCommand, SetBackgroundCropCommand, SetBackgroundImageCommand, SetHiddenCommand, SetAnimationsCommand, SetTransitionCommand, SetLayoutCommand, SlideAnimationsPatch, SlideBackgroundImagePatch, SlideBackgroundPatch, SlideHiddenPatch, SlideTransitionPatch, SetNotesCommand, SlideLayoutPatch, SlideNotesPatch, SlidePropertyPatch, } from './slide-property-types';
+export type { ApplyFormatCommand, FormatMaskField } from './format-painter-types';
+export type { ReplaceTextCommand, ReplaceTextScope } from '../text-search-types';
+export type NumericXfrmField = 'x' | 'y' | 'w' | 'h' | 'rot';
+export type FlipField = 'flipH' | 'flipV';
+export type XfrmField = NumericXfrmField | FlipField;
+export interface XfrmValueByField {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    rot: number;
+    flipH: boolean;
+    flipV: boolean;
+}
+export type ElementXfrmPath<F extends XfrmField = XfrmField> = readonly ['elements', ElementId, 'ovr', F];
+export interface SetXfrmCommand {
+    readonly type: 'SetXfrm';
+    readonly id: ElementId;
+    readonly x?: number;
+    readonly y?: number;
+    readonly w?: number;
+    readonly h?: number;
+    readonly rot?: number;
+}
+export interface SetFlipCommand {
+    readonly type: 'SetFlip';
+    readonly id: ElementId;
+    readonly h?: boolean;
+    readonly v?: boolean;
+}
+export interface RemoveElementCommand {
+    readonly type: 'RemoveElement';
+    readonly id: ElementId;
+}
+export type ElementLayerTarget = 'front' | 'back' | 'forward' | 'backward';
+export interface SetZCommand {
+    readonly type: 'SetZ';
+    readonly id: ElementId;
+    readonly to: ElementLayerTarget;
+}
+export interface SetNameCommand {
+    readonly type: 'SetName';
+    readonly id: ElementId;
+    /** null 删除本次会话的名称覆盖并恢复来源 cNvPr@name。 */
+    readonly name: string | null;
+}
+export interface SetLockedCommand {
+    readonly type: 'SetLocked';
+    readonly id: ElementId;
+    readonly locked: boolean;
+}
+export interface SetElementHiddenCommand {
+    readonly type: 'SetElementHidden';
+    readonly id: ElementId;
+    readonly hidden: boolean;
+}
+export type AlignEdge = 'left' | 'center' | 'right' | 'top' | 'middle' | 'bottom';
+export interface AlignElementsCommand {
+    readonly type: 'AlignElements';
+    readonly ids: readonly ElementId[];
+    readonly edge: AlignEdge;
+}
+export interface PasteElementsCommand {
+    readonly type: 'PasteElements';
+    readonly payload: ElementClipboardPayload;
+    readonly at: {
+        readonly parentId: SlideId | ElementId;
+        readonly x: number;
+        readonly y: number;
+    };
+}
+export interface AddShapeCommand {
+    readonly type: 'AddShape';
+    readonly slideId: SlideId;
+    readonly preset: string;
+    readonly rect: {
+        readonly x: number;
+        readonly y: number;
+        readonly w: number;
+        readonly h: number;
+    };
+}
+export interface AddImageCommand {
+    readonly type: 'AddImage';
+    readonly slideId: SlideId;
+    /** 空图片占位符可由同一历史单元原子替换。 */
+    readonly placeholderId?: ElementId;
+    readonly bytes: Uint8Array;
+    readonly mime: 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp';
+    readonly rect: {
+        readonly x: number;
+        readonly y: number;
+        readonly w: number;
+        readonly h: number;
+    };
+}
+export interface ReplaceImageCommand {
+    readonly type: 'ReplaceImage';
+    readonly id: ElementId;
+    readonly bytes: Uint8Array;
+    readonly mime: 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp';
+}
+export interface SetCropCommand {
+    readonly type: 'SetCrop';
+    readonly id: ElementId;
+    /** null 恢复来源；全零对象明确写出不裁剪。 */
+    readonly crop: ImageCrop | null;
+}
+export interface AddTableCommand {
+    readonly type: 'AddTable';
+    readonly slideId: SlideId;
+    readonly rows: number;
+    readonly cols: number;
+    readonly rect: {
+        readonly x: number;
+        readonly y: number;
+        readonly w: number;
+        readonly h: number;
+    };
+    /** 空内容占位符可由同一历史单元原子替换。 */
+    readonly placeholderId?: ElementId;
+}
+export interface AddSlideCommand {
+    readonly type: 'AddSlide';
+    readonly layoutId: string;
+    /** null 表示插入到第一位；稳定页身份比瞬时数组下标更适合框架与协同边界。 */
+    readonly at: {
+        readonly after: SlideId | null;
+    };
+}
+export interface MoveSlideCommand {
+    readonly type: 'MoveSlide';
+    readonly id: SlideId;
+    /** null 表示置首；稳定身份锚点避免页下标在插入后漂移。 */
+    readonly at: {
+        readonly after: SlideId | null;
+    };
+}
+export interface RemoveSlideCommand {
+    readonly type: 'RemoveSlide';
+    readonly id: SlideId;
+}
+export interface DuplicateSlideCommand {
+    readonly type: 'DuplicateSlide';
+    readonly id: SlideId;
+}
+export interface SetFillCommand {
+    readonly type: 'SetFill';
+    readonly id: ElementId;
+    /** null 删除直接覆盖；显式无填充使用 { type: 'none' }。 */
+    readonly fill: Exclude<Fill, {
+        type: 'image';
+    }> | null;
+}
+export interface SetStrokeCommand {
+    readonly type: 'SetStroke';
+    readonly id: ElementId;
+    /** null 恢复来源；{type:'none'} 形成显式无描边。 */
+    readonly stroke: Stroke | {
+        readonly type: 'none';
+    } | null;
+}
+export interface SetEffectsCommand {
+    readonly type: 'SetEffects';
+    readonly id: ElementId;
+    /** null 恢复继承；空对象明确写出无效果。 */
+    readonly effects: Effects | null;
+}
+export interface SetLinkCommand {
+    readonly type: 'SetLink';
+    readonly id: ElementId;
+    /** null 恢复来源；{kind:'none'} 明确移除当前元素链接。 */
+    readonly target: LinkTarget | {
+        readonly kind: 'none';
+    } | null;
+}
+export type TextEditOp = {
+    readonly type: 'replace';
+    readonly from: TextPosition;
+    readonly to: TextPosition;
+    readonly text: string;
+} | {
+    readonly type: 'splitParagraph';
+    readonly at: TextPosition;
+} | {
+    readonly type: 'insertLineBreak';
+    readonly at: TextPosition;
+} | {
+    readonly type: 'replaceFragment';
+    readonly from: TextPosition;
+    readonly to: TextPosition;
+    readonly fragment: TextFragment;
+};
+export interface EditTextCommand {
+    readonly type: 'EditText';
+    readonly id: ElementId;
+    readonly cell?: TableCellAddress;
+    /** 操作按数组顺序作用于前一个操作的结果，便于 beforeinput 批量提交。 */
+    readonly ops: readonly TextEditOp[];
+}
+export interface TextRange {
+    readonly from: TextPosition;
+    readonly to: TextPosition;
+}
+export interface SetRunPropsCommand {
+    readonly type: 'SetRunProps';
+    readonly id: ElementId;
+    readonly cell?: TableCellAddress;
+    readonly range: TextRange;
+    readonly props: RunPropertyOverrides;
+}
+export interface SetParaPropsCommand {
+    readonly type: 'SetParaProps';
+    readonly id: ElementId;
+    readonly cell?: TableCellAddress;
+    readonly range: TextRange;
+    readonly props: ParagraphPropertyOverrides;
+}
+export interface FitTextShapeCommand {
+    readonly type: 'FitTextShape';
+    readonly id: ElementId;
+}
+export interface SetBodyPropsCommand {
+    readonly type: 'SetBodyProps';
+    readonly id: ElementId;
+    readonly cell?: TableCellAddress;
+    readonly props: TextBodyPropertyOverrides;
+}
+/** 当前公开语义是尾部追加；指定位置插行要先解决纵向合并与坐标重基。 */
+export interface InsertRowCommand {
+    readonly type: 'InsertRow';
+    readonly id: ElementId;
+}
+export type Command = SetXfrmCommand | SetFlipCommand | RemoveElementCommand | SetZCommand | SetNameCommand | SetLockedCommand | SetElementHiddenCommand | ApplyFormatCommand | ReplaceTextCommand | AlignElementsCommand | PasteElementsCommand | AddShapeCommand | AddImageCommand | ReplaceImageCommand | SetCropCommand | AddTableCommand | AddSlideCommand | MoveSlideCommand | RemoveSlideCommand | DuplicateSlideCommand | EditTextCommand | SetRunPropsCommand | SetParaPropsCommand | FitTextShapeCommand | SetBodyPropsCommand | InsertRowCommand | SetFillCommand | SetStrokeCommand | SetEffectsCommand | SetLinkCommand | SetBackgroundCommand | SetBackgroundCropCommand | SetBackgroundImageCommand | SetHiddenCommand | SetTransitionCommand | SetAnimationsCommand | SetLayoutCommand | SetNotesCommand;
+type SetXfrmPatch = {
+    [F in XfrmField]: {
+        readonly op: 'set';
+        readonly path: ElementXfrmPath<F>;
+        readonly value: XfrmValueByField[F];
+        readonly origin: string;
+    };
+}[XfrmField];
+type DeleteXfrmPatch = {
+    [F in XfrmField]: {
+        readonly op: 'del';
+        readonly path: ElementXfrmPath<F>;
+        readonly origin: string;
+    };
+}[XfrmField];
+export type ElementTransformPatch = SetXfrmPatch | DeleteXfrmPatch;
+export type ElementFillPatch = {
+    readonly op: 'set';
+    readonly path: readonly ['elements', ElementId, 'ovr', 'fill'];
+    readonly value: Exclude<Fill, {
+        type: 'image';
+    }>;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['elements', ElementId, 'ovr', 'fill'];
+    readonly origin: string;
+};
+export type ElementStrokePatch = {
+    readonly op: 'set';
+    readonly path: readonly ['elements', ElementId, 'ovr', 'stroke'];
+    readonly value: Stroke | null;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['elements', ElementId, 'ovr', 'stroke'];
+    readonly origin: string;
+};
+export type ElementEffectsPatch = {
+    readonly op: 'set';
+    readonly path: readonly ['elements', ElementId, 'ovr', 'effects'];
+    readonly value: Effects;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['elements', ElementId, 'ovr', 'effects'];
+    readonly origin: string;
+};
+export type ElementLinkPatch = {
+    readonly op: 'set';
+    readonly path: readonly ['elements', ElementId, 'ovr', 'link'];
+    readonly value: LinkOverride;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['elements', ElementId, 'ovr', 'link'];
+    readonly origin: string;
+};
+export type ElementCropPatch = {
+    readonly op: 'set';
+    readonly path: readonly ['elements', ElementId, 'ovr', 'crop'];
+    readonly value: ImageCrop;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['elements', ElementId, 'ovr', 'crop'];
+    readonly origin: string;
+};
+export type ElementImageReplacementPatch = {
+    readonly op: 'set';
+    readonly path: readonly ['elements', ElementId, 'meta', 'imageReplacement'];
+    readonly value: ElementImageReplacement;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['elements', ElementId, 'meta', 'imageReplacement'];
+    readonly origin: string;
+};
+export type ImageResourcePatch = {
+    readonly op: 'set';
+    readonly path: readonly ['imageResources', string];
+    readonly value: ElementInsertionResource;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['imageResources', string];
+    readonly origin: string;
+};
+export type ElementTextPatch = {
+    readonly op: 'set';
+    readonly path: readonly ['elements', ElementId, 'ovr', 'text'];
+    readonly value: TextOverride;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['elements', ElementId, 'ovr', 'text'];
+    readonly origin: string;
+} | {
+    readonly op: 'set';
+    readonly path: readonly ['elements', ElementId, 'ovr', 'tableCells', import('../types').TableCellRowRef, number, 'text'];
+    readonly value: TextOverride;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['elements', ElementId, 'ovr', 'tableCells', import('../types').TableCellRowRef, number, 'text'];
+    readonly origin: string;
+};
+export type ElementOrderPatch = {
+    readonly op: 'set';
+    readonly path: readonly ['elements', ElementId, 'order'];
+    readonly value: string;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['elements', ElementId, 'order'];
+    readonly origin: string;
+};
+export type ElementNamePatch = {
+    readonly op: 'set';
+    readonly path: readonly ['elements', ElementId, 'ovr', 'name'];
+    readonly value: string;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['elements', ElementId, 'ovr', 'name'];
+    readonly origin: string;
+};
+export type ElementInteractionField = 'locked' | 'hiddenByUser';
+export type ElementInteractionPatch = {
+    readonly op: 'set';
+    readonly path: readonly ['elements', ElementId, 'meta', ElementInteractionField];
+    readonly value: true;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['elements', ElementId, 'meta', ElementInteractionField];
+    readonly origin: string;
+};
+export interface ElementTreeSnapshot {
+    readonly root: ElementId;
+    readonly parent: SlideId | ElementId;
+    readonly records: Readonly<Record<ElementId, ElementRecord>>;
+}
+export type ElementTreePatch = {
+    readonly op: 'remove' | 'insert';
+    readonly path: readonly ['elements', ElementId];
+    readonly value: ElementTreeSnapshot;
+    readonly origin: string;
+};
+export interface SlideTreeSnapshot {
+    readonly slide: SlideRecord;
+    readonly after: SlideId | null;
+    /** 删除视图优先切到原后继；插入 patch 不依赖它定位。 */
+    readonly before: SlideId | null;
+    readonly records: Readonly<Record<ElementId, ElementRecord>>;
+}
+export type SlideTreePatch = {
+    readonly op: 'remove' | 'insert';
+    readonly path: readonly ['slides', SlideId];
+    readonly value: SlideTreeSnapshot;
+    readonly origin: string;
+};
+export type SlideOrderPatch = {
+    readonly op: 'move';
+    readonly path: readonly ['slideOrder', SlideId];
+    readonly value: {
+        readonly after: SlideId | null;
+    };
+    readonly origin: string;
+};
+export type TableRowPatch = {
+    readonly op: 'insert' | 'remove';
+    readonly path: readonly ['elements', ElementId, 'ovr', 'tableRows', string];
+    readonly value: import('../types').TableRowInsertion;
+    readonly origin: string;
+};
+export type Patch = ElementTransformPatch | ElementFillPatch | ElementStrokePatch | ElementEffectsPatch | ElementLinkPatch | ElementCropPatch | ElementImageReplacementPatch | ImageResourcePatch | ElementTextPatch | ElementOrderPatch | ElementNamePatch | ElementInteractionPatch | ElementTreePatch | SlideTreePatch | SlideOrderPatch | SlidePropertyPatch | SlideLayoutPatch | SlideNotesPatch | TableRowPatch;
+export interface CommandPatches {
+    readonly forward: Patch[];
+    readonly inverse: Patch[];
+}
+export interface TextPosition {
+    readonly p: number;
+    readonly r: number;
+    readonly off: number;
+}
+export type Selection = {
+    readonly kind: 'none';
+} | {
+    readonly kind: 'elements';
+    readonly ids: readonly ElementId[];
+    readonly enteredGroup: ElementId | null;
+} | {
+    readonly kind: 'text';
+    readonly id: ElementId;
+    readonly cell?: TableCellAddress;
+    readonly anchor: TextPosition;
+    readonly focus: TextPosition;
+} | {
+    readonly kind: 'table';
+    readonly id: ElementId;
+    readonly cells: readonly {
+        r: number;
+        c: number;
+    }[];
+};
+export interface HistoryEntry extends CommandPatches {
+    readonly selectionBefore: Selection;
+    readonly selectionAfter: Selection;
+    readonly label: string;
+    readonly time: number;
+    readonly mergeKey?: string;
+    readonly affectedSlides: readonly SlideId[];
+}
+export interface History {
+    readonly undoCount: number;
+    readonly redoCount: number;
+    readonly byteSize: number;
+    readonly undoEntries: readonly HistoryEntry[];
+    readonly redoEntries: readonly HistoryEntry[];
+    clear(): void;
+}
+export interface SlideChangeSets {
+    readonly createdSlides: Set<SlideId>;
+    readonly removedSlides: Set<SlideId>;
+    readonly movedSlides: Set<SlideId>;
+    readonly notesSlides: Set<SlideId>;
+    readonly removedSlideFallbacks: Map<SlideId, SlideId>;
+}
+export interface TransactionResult extends ProjectionInvalidation, CommandPatches, SlideChangeSets {
+    readonly selection: Selection;
+    readonly renderSlides: Set<SlideId>;
+}
+export interface EditorChange extends ProjectionInvalidation, SlideChangeSets {
+    readonly source: 'transaction' | 'undo' | 'redo' | 'selection';
+    readonly selection: Selection;
+    /** dirtyElements 含投影缓存祖先；DOM 增量分区必须以真正被 patch 的元素为准。 */
+    readonly touchedElements: Set<ElementId>;
+    /** 需要重新生成 markup/defs 的元素；纯层级 patch 不进入这里。 */
+    readonly renderElements: Set<ElementId>;
+    /** 页面级视觉属性需要重建整个 SVG；隐藏等纯目录元数据不进入这里。 */
+    readonly renderSlides: Set<SlideId>;
+    /** bodyPr 有效值变化；活动文字面必须同步刷新被延迟的静态分区。 */
+    readonly bodyPropsElements: Set<ElementId>;
+    /** 只需移动既有 DOM 分区的元素；可与 renderElements 重叠。 */
+    readonly reorderedElements: Set<ElementId>;
+    /** 名称与会话交互状态改变；选择窗格只消费这一集合，避免文字输入重建目录 DOM。 */
+    readonly paneElements: Set<ElementId>;
+}
+export type EditorSubscriber = (change: EditorChange) => void;
+export interface Transaction {
+    exec(...commands: Command[]): void;
+    select(selection: Selection): void;
+}
+export interface TransactionOptions {
+    readonly origin?: string;
+    readonly recordHistory?: boolean;
+    readonly mergeKey?: string;
+    readonly time?: number;
+}
+export interface EditorOptions {
+    readonly origin?: string;
+    readonly historyLimit?: number;
+    readonly historyByteLimit?: number;
+    /** 新解析文档的恢复日志；构造期间原子回放，不进入历史或再次广播。 */
+    readonly recoveryFrames?: readonly import('../recovery-types').RecoveryFrame[];
+}

package/dist/commands/xfrm.d.ts

@@ -0,0 +1,8 @@
+import type { FlipField, NumericXfrmField, XfrmField, XfrmValueByField } from './types';
+export declare const NUMERIC_XFRM_FIELDS: readonly NumericXfrmField[];
+export declare const FLIP_FIELDS: readonly FlipField[];
+export declare const XFRM_FIELDS: readonly XfrmField[];
+export declare const XFRM_FIELD_SET: Set<XfrmField>;
+export declare const isFrameXfrmField: (field: XfrmField) => boolean;
+export declare const isFrameSaveXfrmField: (field: XfrmField) => boolean;
+export declare function assertXfrmValue<F extends XfrmField>(field: F, value: unknown, label: string): asserts value is XfrmValueByField[F];

package/dist/data-validation.d.ts

@@ -0,0 +1,7 @@
+import type { TextPosition, TextRange } from './commands/types';
+export declare const own: (object: object, key: PropertyKey) => boolean;
+export declare function assertDataObject(value: unknown, fields: readonly string[], label: string): asserts value is object;
+/** JSON 数组必须稠密且只能拥有索引与 length；否则序列化会吞掉空洞、访问器或附加状态。 */
+export declare function assertDataArray(value: unknown, label: string): asserts value is readonly unknown[];
+export declare function assertTextPosition(value: unknown, label: string): asserts value is TextPosition;
+export declare function assertTextRange(value: unknown, label: string): asserts value is TextRange;

package/dist/document.d.ts

@@ -0,0 +1,17 @@
+import type { Presentation, SlideElement } from '@web-ppt/core';
+import type { CreateDocOptions, EditDoc, EditableKind, ElementId, ElementMeta, SlideId } from './types';
+export declare function elementMetaOf(el: SlideElement, inherited: EditableKind, source: Presentation['source'], writablePart: string | null): ElementMeta;
+export declare function createDoc(pres: Presentation, opts?: CreateDocOptions): EditDoc;
+export declare function createEmptyDoc(opts: {
+    width: number;
+    height: number;
+    idPrefix?: string;
+}): EditDoc;
+export declare function allocateSlideId(doc: EditDoc): SlideId;
+export declare function allocateElementId(doc: EditDoc): ElementId;
+/** 采用外部完整包快照会建立新的保存基线；会话中常规保存应只调用 Editor.save。 */
+export declare function replaceDocPackage(doc: EditDoc, pkg: NonNullable<EditDoc['package']>): void;
+/** 保存模块原子提交包与对应基线，不能拆成两个公开赋值。 */
+export declare function commitSavedPackage(doc: EditDoc, pkg: NonNullable<EditDoc['package']>, baselines: Record<string, Uint8Array>, createdParts: string[]): void;
+/** EditDoc 不内嵌函数，资源释放能力由 WeakMap 关联，因而文档本身仍可结构化克隆。 */
+export declare function disposeDoc(doc: EditDoc): void;

package/dist/dynamic-slide-fields.d.ts

@@ -0,0 +1,6 @@
+import type { SlideElement } from '@web-ppt/core';
+export declare const isDynamicSlideLink: (link: string | undefined) => boolean;
+/** 组后代有独立记录和索引；字段身份来自内容，不依赖可选的页码占位符元数据。 */
+export declare function hasDynamicSlideNumber(element: SlideElement): boolean;
+/** 组后代有独立记录和索引；这里只判断当前记录自身承载的跳转。 */
+export declare function hasDynamicSlideLink(element: SlideElement): boolean;