@web-ppt/edit-core 0.5.0-beta.2 → 0.5.0

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

@@ -0,0 +1,7 @@
+import type { EditDoc } from '../types';
+import type { CommandPatches, DocumentSizePatch, Patch, SetSlideSizeCommand } from './types';
+export declare function isDocumentSizePatch(patch: Patch): patch is DocumentSizePatch;
+export declare function validateDocumentSizePatch(patch: DocumentSizePatch, index: number): void;
+export declare function applyDocumentSizePatch(doc: EditDoc, patch: DocumentSizePatch): void;
+/** 画布与内容变化属于同一历史事务；按需策略只负责产出内容补丁。 */
+export declare function setSlideSizePatches(doc: EditDoc, command: SetSlideSizeCommand, origin: string): CommandPatches;

package/dist/commands/spid.d.ts

@@ -1,5 +1,5 @@
 import type { EditDoc } from '../types';
+export declare function maxPartSpid(doc: EditDoc, part: string): number;
 export declare function prepareElementSpidNamespaces(doc: EditDoc): void;
 /** 来源 XML 里还有不进入 Schema 的 cNvPr；只扫模型会在空页或未知宿主上复用 spid。 */
 export declare function allocateElementSpid(doc: EditDoc, part: string): number;
-export declare function partSpidAllocator(doc: EditDoc, part: string): () => number;

package/dist/commands/table-grid-patch.d.ts

@@ -0,0 +1,12 @@
+import type { EditDoc, ElementRecord } from '../types';
+import type { Patch, TableCellPropsPatch, TableColumnPatch, TableGridEntryPatch, TableMergePatch } from './types';
+export declare function isTableColumnPatch(patch: Patch): patch is TableColumnPatch;
+export declare function isTableGridEntryPatch(patch: Patch): patch is TableGridEntryPatch;
+export declare function isTableMergePatch(patch: Patch): patch is TableMergePatch;
+export declare function isTableCellPropsPatch(patch: Patch): patch is TableCellPropsPatch;
+export declare function validateTableColumnPatch(doc: EditDoc, patch: TableColumnPatch, index: number): void;
+export declare function validateTableGridEntryPatch(doc: EditDoc, patch: TableGridEntryPatch, index: number): void;
+export declare function assertTableMergeRegions(record: ElementRecord, value: unknown, label: string): void;
+export declare function validateTableMergePatch(doc: EditDoc, patch: TableMergePatch, index: number): void;
+export declare function validateTableCellPropsPatch(doc: EditDoc, patch: TableCellPropsPatch, index: number): void;
+export declare function applyTableGridPatch(doc: EditDoc, patch: TableColumnPatch | TableGridEntryPatch | TableMergePatch | TableCellPropsPatch): void;

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

@@ -1,5 +1,5 @@
 import type { TextBody } from '@web-ppt/core';
-import type { EditDoc, ElementRecord, TableCellAddress, TableCellRowRef, TextOverride } from '../types';
+import type { EditDoc, ElementRecord, TableCellAddress, TableCellColumnRef, TableCellRowRef, TextOverride } from '../types';
 import type { ElementTextPatch } from './types';
 export interface TextTarget {
     readonly id: string;
@@ -17,7 +17,7 @@ export interface TextPatchTarget {
     readonly id: string;
     readonly cell?: {
         readonly row: TableCellRowRef;
-        readonly c: number;
+        readonly column: TableCellColumnRef;
     };
 }
 export declare function textTargetContextForRecord(record: ElementRecord, target: TextTarget): TextTargetContext;

package/dist/commands/theme-types.d.ts

@@ -0,0 +1,47 @@
+import type { ThemeColorSlot } from '@web-ppt/core';
+export interface ThemeFontCommandValue {
+    readonly latin?: string | null;
+    readonly ea?: string | null;
+    readonly cs?: string | null;
+    readonly scripts?: Readonly<Record<string, string | null>>;
+}
+export interface SetThemeCommand {
+    readonly type: 'SetTheme';
+    readonly id: string;
+    /** null 恢复该槽的来源值；未出现的槽保持当前覆盖。 */
+    readonly clrScheme?: Readonly<Partial<Record<ThemeColorSlot, string | null>>>;
+    readonly fontScheme?: {
+        readonly major?: ThemeFontCommandValue;
+        readonly minor?: ThemeFontCommandValue;
+    };
+}
+export type ThemeColorPatch = {
+    readonly op: 'set';
+    readonly path: readonly ['themes', string, 'ovr', 'colors', ThemeColorSlot];
+    readonly value: string;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['themes', string, 'ovr', 'colors', ThemeColorSlot];
+    readonly origin: string;
+};
+export type ThemeFontPatch = {
+    readonly op: 'set';
+    readonly path: readonly ['themes', string, 'ovr', 'fonts', 'major' | 'minor', 'latin' | 'ea' | 'cs'];
+    readonly value: string;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['themes', string, 'ovr', 'fonts', 'major' | 'minor', 'latin' | 'ea' | 'cs'];
+    readonly origin: string;
+} | {
+    readonly op: 'set';
+    readonly path: readonly ['themes', string, 'ovr', 'fonts', 'major' | 'minor', 'scripts', string];
+    readonly value: string;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['themes', string, 'ovr', 'fonts', 'major' | 'minor', 'scripts', string];
+    readonly origin: string;
+};
+export type ThemePatch = ThemeColorPatch | ThemeFontPatch;

package/dist/commands/theme.d.ts

@@ -0,0 +1,9 @@
+import type { EditDoc } from '../types';
+import type { CommandPatches } from './types';
+import type { SetThemeCommand, ThemePatch } from './theme-types';
+export declare function isThemePatch(patch: {
+    readonly path: readonly unknown[];
+}): patch is ThemePatch;
+export declare function setThemePatches(doc: EditDoc, command: SetThemeCommand, origin: string): CommandPatches;
+export declare function validateThemePatch(doc: EditDoc, patch: ThemePatch, index: number): void;
+export declare function applyThemePatch(doc: EditDoc, patch: ThemePatch): void;

package/dist/commands/types.d.ts

@@ -1,18 +1,24 @@
-import type { Effects, Fill, Stroke } from '@web-ppt/core';
-import type { EditIdentity, ElementId, ElementImageReplacement, ElementInsertionResource, ElementRecord, ImageCrop, LinkOverride, LinkTarget, ParagraphPropertyOverrides, ProjectionInvalidation, RunPropertyOverrides, SlideId, TextFragment, TextOverride, SlideRecord, TableCellAddress, TextBodyPropertyOverrides } from '../types';
+import type { CellBorders, Effects, Fill, Stroke, TableCell } from '@web-ppt/core';
+import type { DesignTarget, EditIdentity, ElementId, ElementImageReplacement, ElementInsertionResource, ElementRecord, ImageCrop, LinkOverride, LinkTarget, ParagraphPropertyInput, ProjectionInvalidation, RunPropertyOverrides, SlideId, TextFragment, TextOverride, SlideRecord, TableCellAddress, TextBodyPropertyOverrides } from '../types';
 import type { ElementClipboardPayload } from './clipboard-types';
 import type { ElementHierarchyPatch, GroupCommand, UngroupCommand } from './group-types';
-import type { ConvertToCustomGeometryCommand, ElementGeometryPatch, SetGeometryCommand } from './geometry-types';
-import type { SetBackgroundCommand, SetBackgroundCropCommand, SetBackgroundImageCommand, SetHiddenCommand, SetAnimationsCommand, SetTransitionCommand, SetLayoutCommand, SetNotesCommand, SlideLayoutPatch, SlideNotesPatch, SlidePropertyPatch } from './slide-property-types';
+import type { ConvertToCustomGeometryCommand, ElementGeometryPatch, ElementPresetGeometryPatch, SetAdjCommand, SetGeometryCommand, SetPresetCommand } from './geometry-types';
+import type { SetBackgroundCommand, SetBackgroundCropCommand, SetBackgroundImageCommand, SetHiddenCommand, SetAnimationsCommand, SetTransitionCommand, SetLayoutCommand, SetNotesCommand, LayoutPropertyPatch, MasterBackgroundPatch, SlideLayoutPatch, SlideNotesPatch, SlidePropertyPatch } from './slide-property-types';
 import type { ApplyFormatCommand } from './format-painter-types';
 import type { ReplaceTextCommand } from '../text-search-types';
 import type { ElementTableStylePatch, SetTableStyleCommand } from './table-style-types';
+import type { AddSectionCommand, DistributeElementsCommand, DocumentSizePatch, ElementAltTextPatch, MoveSectionCommand, RemoveSectionCommand, RenameSectionCommand, SectionStatePatch, SetAltTextCommand, SetSlideSizeCommand } from './common-object-slide-types';
+import type { SetThemeCommand, ThemePatch } from './theme-types';
+import type { MasterTextStylePatch, SetMasterTextStyleCommand } from './master-text-style-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 { SetBackgroundCommand, SetBackgroundCropCommand, SetBackgroundImageCommand, SetHiddenCommand, SetAnimationsCommand, SetTransitionCommand, SetLayoutCommand, SlideAnimationsPatch, SlideBackgroundImagePatch, SlideBackgroundPatch, SlideHiddenPatch, SlideTransitionPatch, LayoutBackgroundPatch, LayoutTransitionPatch, LayoutPropertyPatch, MasterBackgroundPatch, SetNotesCommand, SlideLayoutPatch, SlideNotesPatch, SlidePropertyPatch, } from './slide-property-types';
 export type { ApplyFormatCommand, FormatMaskField } from './format-painter-types';
 export type { ElementHierarchyPatch, ElementHierarchyState, GroupCommand, UngroupCommand, } from './group-types';
 export type { ReplaceTextCommand, ReplaceTextScope } from '../text-search-types';
 export type { ElementTableStylePatch, SetTableStyleCommand } from './table-style-types';
+export type { AddSectionCommand, DistributeElementsCommand, DocumentSizePatch, ElementAltTextPatch, MoveSectionCommand, RemoveSectionCommand, RenameSectionCommand, SectionStatePatch, SetAltTextCommand, SetSlideSizeCommand, } from './common-object-slide-types';
+export type { SetThemeCommand, ThemeColorPatch, ThemeFontPatch, ThemePatch } from './theme-types';
+export type { MasterParagraphTextStylePatch, MasterRunTextStylePatch, MasterTextStylePatch, SetMasterTextStyleCommand, } from './master-text-style-types';
 export type NumericXfrmField = 'x' | 'y' | 'w' | 'h' | 'rot';
 export type FlipField = 'flipH' | 'flipV';
 export type XfrmField = NumericXfrmField | FlipField;
@@ -82,9 +88,8 @@ export interface PasteElementsCommand {
         readonly y: number;
     };
 }
-export interface AddShapeCommand {
+interface AddShapeFields {
     readonly type: 'AddShape';
-    readonly slideId: SlideId;
     readonly preset: string;
     readonly rect: {
         readonly x: number;
@@ -93,9 +98,15 @@ export interface AddShapeCommand {
         readonly h: number;
     };
 }
-export interface AddImageCommand {
-    readonly type: 'AddImage';
+export type AddShapeCommand = AddShapeFields & ({
     readonly slideId: SlideId;
+    readonly target?: never;
+} | {
+    readonly target: DesignTarget;
+    readonly slideId?: never;
+});
+interface AddImageFields {
+    readonly type: 'AddImage';
     /** 空图片占位符可由同一历史单元原子替换。 */
     readonly placeholderId?: ElementId;
     readonly bytes: Uint8Array;
@@ -107,6 +118,13 @@ export interface AddImageCommand {
         readonly h: number;
     };
 }
+export type AddImageCommand = AddImageFields & ({
+    readonly slideId: SlideId;
+    readonly target?: never;
+} | {
+    readonly target: DesignTarget;
+    readonly slideId?: never;
+});
 export interface ReplaceImageCommand {
     readonly type: 'ReplaceImage';
     readonly id: ElementId;
@@ -119,9 +137,8 @@ export interface SetCropCommand {
     /** null 恢复来源；全零对象明确写出不裁剪。 */
     readonly crop: ImageCrop | null;
 }
-export interface AddTableCommand {
+interface AddTableFields {
     readonly type: 'AddTable';
-    readonly slideId: SlideId;
     readonly rows: number;
     readonly cols: number;
     readonly rect: {
@@ -133,6 +150,13 @@ export interface AddTableCommand {
     /** 空内容占位符可由同一历史单元原子替换。 */
     readonly placeholderId?: ElementId;
 }
+export type AddTableCommand = AddTableFields & ({
+    readonly slideId: SlideId;
+    readonly target?: never;
+} | {
+    readonly target: DesignTarget;
+    readonly slideId?: never;
+});
 export interface AddSlideCommand {
     readonly type: 'AddSlide';
     readonly layoutId: string;
@@ -222,12 +246,18 @@ export interface SetRunPropsCommand {
     readonly range: TextRange;
     readonly props: RunPropertyOverrides;
 }
+export interface ClearFormatCommand {
+    readonly type: 'ClearFormat';
+    readonly id: ElementId;
+    readonly cell?: TableCellAddress;
+    readonly range: TextRange;
+}
 export interface SetParaPropsCommand {
     readonly type: 'SetParaProps';
     readonly id: ElementId;
     readonly cell?: TableCellAddress;
     readonly range: TextRange;
-    readonly props: ParagraphPropertyOverrides;
+    readonly props: ParagraphPropertyInput;
 }
 export interface FitTextShapeCommand {
     readonly type: 'FitTextShape';
@@ -239,12 +269,90 @@ export interface SetBodyPropsCommand {
     readonly cell?: TableCellAddress;
     readonly props: TextBodyPropertyOverrides;
 }
-/** 当前公开语义是尾部追加；指定位置插行要先解决纵向合并与坐标重基。 */
+/** 子路径只用纯数据命令接入主历史；payload 的语义由已加载命名空间校验。 */
+export interface ExtensionCommand {
+    readonly type: 'Extension';
+    readonly namespace: string;
+    readonly scope?: 'element' | 'slide';
+    readonly id: ElementId;
+    readonly payload: unknown;
+}
 export interface InsertRowCommand {
     readonly type: 'InsertRow';
     readonly id: ElementId;
+    /** 省略仍兼容尾部追加；null 也表示尾部。 */
+    readonly at?: {
+        readonly before: import('../types').TableRowId | null;
+    };
+}
+export interface InsertColumnCommand {
+    readonly type: 'InsertColumn';
+    readonly id: ElementId;
+    readonly at?: {
+        readonly before: import('../types').TableColumnId | null;
+    };
+}
+export interface RemoveRowCommand {
+    readonly type: 'RemoveRow';
+    readonly id: ElementId;
+    readonly row: import('../types').TableRowId;
+}
+export interface RemoveColumnCommand {
+    readonly type: 'RemoveColumn';
+    readonly id: ElementId;
+    readonly column: import('../types').TableColumnId;
 }
-export type Command = SetXfrmCommand | SetFlipCommand | RemoveElementCommand | SetZCommand | SetNameCommand | SetLockedCommand | SetElementHiddenCommand | ApplyFormatCommand | ReplaceTextCommand | AlignElementsCommand | GroupCommand | UngroupCommand | PasteElementsCommand | AddShapeCommand | AddImageCommand | ReplaceImageCommand | SetCropCommand | SetGeometryCommand | ConvertToCustomGeometryCommand | AddTableCommand | AddSlideCommand | MoveSlideCommand | RemoveSlideCommand | DuplicateSlideCommand | EditTextCommand | SetRunPropsCommand | SetParaPropsCommand | FitTextShapeCommand | SetBodyPropsCommand | InsertRowCommand | SetFillCommand | SetStrokeCommand | SetEffectsCommand | SetLinkCommand | SetBackgroundCommand | SetBackgroundCropCommand | SetBackgroundImageCommand | SetHiddenCommand | SetTransitionCommand | SetAnimationsCommand | SetLayoutCommand | SetNotesCommand | SetTableStyleCommand;
+export interface SetRowHeightCommand {
+    readonly type: 'SetRowHeight';
+    readonly id: ElementId;
+    readonly row: import('../types').TableRowId;
+    readonly height: number;
+}
+export interface SetColumnWidthCommand {
+    readonly type: 'SetColumnWidth';
+    readonly id: ElementId;
+    readonly column: import('../types').TableColumnId;
+    readonly width: number;
+}
+export interface MergeCellsCommand {
+    readonly type: 'MergeCells';
+    readonly id: ElementId;
+    readonly from: import('../types').TableCellRef;
+    readonly to: import('../types').TableCellRef;
+}
+export interface SplitCellCommand {
+    readonly type: 'SplitCell';
+    readonly id: ElementId;
+    readonly cell: import('../types').TableCellRef;
+}
+export interface SetCellPropsCommand {
+    readonly type: 'SetCellProps';
+    readonly id: ElementId;
+    readonly cell: import('../types').TableCellRef;
+    readonly props: {
+        readonly fill?: Exclude<Fill, {
+            type: 'image';
+        }> | null;
+        readonly borders?: CellBorders | null;
+        readonly margins?: [number, number, number, number] | null;
+        readonly vAlign?: TableCell['vAlign'] | null;
+        readonly vert?: TableCell['vert'] | null;
+    };
+}
+export type Command = SetXfrmCommand | SetFlipCommand | RemoveElementCommand | SetZCommand | SetNameCommand | SetAltTextCommand | ExtensionCommand | SetLockedCommand | SetElementHiddenCommand | ApplyFormatCommand | ReplaceTextCommand | AlignElementsCommand | DistributeElementsCommand | GroupCommand | UngroupCommand | PasteElementsCommand | AddShapeCommand | AddImageCommand | ReplaceImageCommand | SetCropCommand | SetGeometryCommand | ConvertToCustomGeometryCommand | SetPresetCommand | SetAdjCommand | AddTableCommand | AddSlideCommand | MoveSlideCommand | RemoveSlideCommand | DuplicateSlideCommand | EditTextCommand | SetRunPropsCommand | ClearFormatCommand | SetParaPropsCommand | AddSectionCommand | RenameSectionCommand | MoveSectionCommand | RemoveSectionCommand | SetSlideSizeCommand | FitTextShapeCommand | SetBodyPropsCommand | InsertRowCommand | InsertColumnCommand | RemoveRowCommand | RemoveColumnCommand | SetRowHeightCommand | SetColumnWidthCommand | MergeCellsCommand | SplitCellCommand | SetCellPropsCommand | SetFillCommand | SetStrokeCommand | SetEffectsCommand | SetLinkCommand | SetBackgroundCommand | SetBackgroundCropCommand | SetBackgroundImageCommand | SetHiddenCommand | SetTransitionCommand | SetAnimationsCommand | SetLayoutCommand | SetNotesCommand | SetTableStyleCommand | SetThemeCommand | SetMasterTextStyleCommand;
+type PageOnlyCommand = AddSlideCommand | MoveSlideCommand | RemoveSlideCommand | DuplicateSlideCommand | AddSectionCommand | RenameSectionCommand | MoveSectionCommand | RemoveSectionCommand | SetSlideSizeCommand | SetBackgroundCropCommand | SetBackgroundImageCommand | SetHiddenCommand | SetAnimationsCommand | SetLayoutCommand | SetNotesCommand | SetThemeCommand | AddShapeCommand | AddImageCommand | AddTableCommand | PasteElementsCommand | ReplaceTextCommand;
+/** 版式命令沿用元素命令语言；只有画布属性命令显式携带 DesignTarget。 */
+export type DesignCommand = Exclude<Command, PageOnlyCommand | SetBackgroundCommand | SetTransitionCommand> | Extract<SetBackgroundCommand, {
+    readonly target: import('../types').DesignTarget;
+}> | Extract<SetTransitionCommand, {
+    readonly target: import('../types').DesignTarget;
+}> | Extract<AddShapeCommand, {
+    readonly target: import('../types').DesignTarget;
+}> | Extract<AddImageCommand, {
+    readonly target: import('../types').DesignTarget;
+}> | Extract<AddTableCommand, {
+    readonly target: import('../types').DesignTarget;
+}>;
 type SetXfrmPatch = {
     [F in XfrmField]: {
         readonly op: 'set';
@@ -344,12 +452,12 @@ export type ElementTextPatch = {
     readonly origin: string;
 } | {
     readonly op: 'set';
-    readonly path: readonly ['elements', ElementId, 'ovr', 'tableCells', import('../types').TableCellRowRef, number, 'text'];
+    readonly path: readonly ['elements', ElementId, 'ovr', 'tableCells', import('../types').TableCellRowRef, import('../types').TableCellColumnRef, 'text'];
     readonly value: TextOverride;
     readonly origin: string;
 } | {
     readonly op: 'del';
-    readonly path: readonly ['elements', ElementId, 'ovr', 'tableCells', import('../types').TableCellRowRef, number, 'text'];
+    readonly path: readonly ['elements', ElementId, 'ovr', 'tableCells', import('../types').TableCellRowRef, import('../types').TableCellColumnRef, 'text'];
     readonly origin: string;
 };
 export type ElementOrderPatch = {
@@ -400,6 +508,12 @@ export interface SlideTreeSnapshot {
     /** 删除视图优先切到原后继；插入 patch 不依赖它定位。 */
     readonly before: SlideId | null;
     readonly records: Readonly<Record<ElementId, ElementRecord>>;
+    /** 直接复制来源用于冻结字段出处；不能从原生 part 推断中间副本。 */
+    readonly copySources?: Readonly<Record<ElementId, ElementId>>;
+    /** 复制发生时已证明的原操作；恢复与重做只运输这份不可变证据。 */
+    readonly extensionCopies?: string;
+    /** 页面结构 Patch 同步维护稳定节成员；省略表示该页不属于任何节。 */
+    readonly sectionId?: import('../types').SectionId;
 }
 export type SlideTreePatch = {
     readonly op: 'remove' | 'insert';
@@ -421,7 +535,70 @@ export type TableRowPatch = {
     readonly value: import('../types').TableRowInsertion;
     readonly origin: string;
 };
-export type Patch = ElementTransformPatch | ElementFillPatch | ElementStrokePatch | ElementEffectsPatch | ElementLinkPatch | ElementCropPatch | ElementGeometryPatch | ElementImageReplacementPatch | ImageResourcePatch | ElementTextPatch | ElementOrderPatch | ElementNamePatch | ElementInteractionPatch | ElementTreePatch | ElementHierarchyPatch | SlideTreePatch | SlideOrderPatch | SlidePropertyPatch | SlideLayoutPatch | SlideNotesPatch | TableRowPatch | ElementTableStylePatch;
+export type TableColumnPatch = {
+    readonly op: 'insert' | 'remove';
+    readonly path: readonly ['elements', ElementId, 'ovr', 'tableColumns', string];
+    readonly value: import('../types').TableColumnInsertion;
+    readonly origin: string;
+};
+export type TableGridEntryPatch = {
+    readonly op: 'set' | 'del';
+    readonly path: readonly [
+        'elements',
+        ElementId,
+        'ovr',
+        'tableRemovedRows' | 'tableRemovedColumns' | 'tableRowHeights' | 'tableColumnWidths',
+        string
+    ];
+    readonly value?: true | number;
+    readonly origin: string;
+};
+export type TableMergePatch = {
+    readonly op: 'set';
+    readonly path: readonly ['elements', ElementId, 'ovr', 'tableMerges'];
+    readonly value: readonly import('../types').TableMergeRegion[];
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['elements', ElementId, 'ovr', 'tableMerges'];
+    readonly origin: string;
+};
+export type TableCellPropsPatch = {
+    readonly op: 'set' | 'del';
+    readonly path: readonly [
+        'elements',
+        ElementId,
+        'ovr',
+        'tableCells',
+        string,
+        'fill' | 'borders' | 'margins' | 'vAlign' | 'vert'
+    ];
+    readonly value?: import('../types').TableCellOverrides[keyof Omit<import('../types').TableCellOverrides, 'text'>];
+    readonly origin: string;
+};
+export type ExtensionPatch = {
+    readonly op: 'set';
+    readonly path: readonly ['elements' | 'slides', ElementId, 'ovr', 'extensions', string, ...string[]];
+    readonly value: unknown;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['elements' | 'slides', ElementId, 'ovr', 'extensions', string, ...string[]];
+    readonly origin: string;
+};
+export type DocumentExtensionPatch = {
+    readonly op: 'set';
+    readonly path: readonly ['document', 'extensions', string, ...string[]];
+    readonly value: unknown;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['document', 'extensions', string, ...string[]];
+    readonly origin: string;
+};
+/** 单个事务必须能作为一条协同消息原子传输。 */
+export declare const MAX_PATCHES_PER_TRANSACTION = 10000;
+export type Patch = ElementTransformPatch | ElementFillPatch | ElementStrokePatch | ElementEffectsPatch | ElementLinkPatch | ElementCropPatch | ElementGeometryPatch | ElementPresetGeometryPatch | ElementImageReplacementPatch | ImageResourcePatch | ElementTextPatch | ElementOrderPatch | ElementNamePatch | ElementAltTextPatch | ElementInteractionPatch | ExtensionPatch | DocumentExtensionPatch | ElementTreePatch | ElementHierarchyPatch | SlideTreePatch | SlideOrderPatch | SectionStatePatch | DocumentSizePatch | SlidePropertyPatch | SlideLayoutPatch | SlideNotesPatch | TableRowPatch | TableColumnPatch | TableGridEntryPatch | TableMergePatch | TableCellPropsPatch | ElementTableStylePatch | ThemePatch | LayoutPropertyPatch | MasterBackgroundPatch | MasterTextStylePatch;
 export interface CommandPatches {
     readonly forward: Patch[];
     readonly inverse: Patch[];

package/dist/commands/ungroup-source.d.ts

@@ -0,0 +1,3 @@
+import type { EditDoc, ElementInsertionSource, ElementRecord } from '../types';
+/** 完整插入来源随父组删除；孩子脱离前分取自己的闭包，不能依赖已消失的活父链。 */
+export declare function ungroupInsertionSources(doc: EditDoc, group: ElementRecord): Map<string, ElementInsertionSource>;

package/dist/comments/index.d.ts

@@ -0,0 +1,35 @@
+import type { SlideComment } from '@web-ppt/core';
+import type { Editor } from '../editor';
+import type { SlideId } from '../types';
+import type { CommentFields } from './state';
+export { queryComments } from './state';
+export type { CommentFields } from './state';
+export type CommentCommand = {
+    type: 'AddComment';
+    slideId: SlideId;
+    comment: SlideComment & {
+        id: string;
+    };
+} | {
+    type: 'UpdateComment';
+    slideId: SlideId;
+    id: string;
+    fields: Partial<CommentFields>;
+} | {
+    type: 'RemoveComment';
+    slideId: SlideId;
+    id: string;
+};
+export declare function registerCommentEditing(): void;
+export declare function createCommentEditor(editor: Pick<Editor, 'doc' | 'exec'>): {
+    exec: (command: CommentCommand) => import("..").TransactionResult;
+    query: (id: SlideId) => SlideComment[];
+    add(slideId: SlideId, comment: CommentFields & {
+        id?: string;
+    }): string;
+    update(slideId: SlideId, id: string, fields: Partial<CommentFields>): import("..").TransactionResult;
+    remove(slideId: SlideId, id: string): import("..").TransactionResult;
+    reply(slideId: SlideId, parentId: string, comment: CommentFields & {
+        id?: string;
+    }): string;
+};

package/dist/comments/save.d.ts

@@ -0,0 +1,3 @@
+import type { EditDoc } from '../types';
+/** 新部件隔离编辑覆盖，旧部件保持基线；撤销后保存可以精确恢复来源关系。 */
+export declare function materializeCommentEdits(doc: EditDoc, baselines: Record<string, Uint8Array>, created: Set<string>, changes: Record<string, Uint8Array | null>): void;

package/dist/comments/state.d.ts

@@ -0,0 +1,10 @@
+import type { SlideComment } from '@web-ppt/core';
+import type { EditDoc, SlideId } from '../types';
+import type { ExtensionPatch } from '../commands/types';
+export type CommentFields = Omit<SlideComment, 'id' | 'idx'>;
+export type CommentState = Record<string, Partial<CommentFields> & {
+    deleted?: boolean;
+}>;
+export declare const commentState: (doc: EditDoc, id: SlideId) => CommentState;
+export declare function queryComments(doc: EditDoc, slideId: SlideId): SlideComment[];
+export declare function validateCommentPatch(_doc: EditDoc, patch: ExtensionPatch): void;

package/dist/comments/xml.d.ts

@@ -0,0 +1,12 @@
+import type { SlideComment } from '@web-ppt/core';
+import type { XmlElement } from '../xml/types';
+export declare const THREAD_URI = "{C676402C-5697-4E1C-873F-D02D1690AC5C}";
+export declare const THREAD_NS = "http://schemas.microsoft.com/office/powerpoint/2012/main";
+export declare const attr: (node: XmlElement, name: string) => string | undefined;
+export declare const children: (root: XmlElement, name: string) => XmlElement[];
+export declare function add(parent: XmlElement, name: string, attributes?: Record<string, string>): XmlElement;
+export type CommentIdentity = {
+    author: string;
+    idx: number;
+};
+export declare function writeComment(node: XmlElement, comment: SlideComment, identity: CommentIdentity, parent?: CommentIdentity): void;