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

package/dist/commands/replace-image.d.ts

@@ -1,3 +1,8 @@
+import type { ImageElement } from '@web-ppt/core';
 import type { EditDoc } from '../types';
-import type { CommandPatches, ReplaceImageCommand } from './types';
+import type { ClipboardResource, CommandPatches, ReplaceImageCommand } from './types';
 export declare function replaceImagePatches(doc: EditDoc, command: ReplaceImageCommand, origin: string): CommandPatches;
+/** 普通图片与媒体海报只替换同一张 blip；资源、历史和保存不能各维护一套。 */
+export declare function replaceImageResourcePatches(doc: EditDoc, record: EditDoc['elements'][string] & {
+    src: ImageElement;
+}, resource: ClipboardResource, origin: string): CommandPatches;

package/dist/commands/sections.d.ts

@@ -0,0 +1,10 @@
+import type { EditDoc, SectionState } from '../types';
+import type { AddSectionCommand, CommandPatches, MoveSectionCommand, Patch, RemoveSectionCommand, RenameSectionCommand, SectionStatePatch } from './types';
+export declare function assertSectionState(doc: EditDoc, value: unknown, label: string): asserts value is SectionState;
+export declare function isSectionStatePatch(patch: Patch): patch is SectionStatePatch;
+export declare function validateSectionStatePatch(doc: EditDoc, patch: SectionStatePatch, index: number): void;
+export declare function applySectionStatePatch(doc: EditDoc, patch: SectionStatePatch): void;
+export declare function addSectionPatches(doc: EditDoc, command: AddSectionCommand, origin: string): CommandPatches;
+export declare function renameSectionPatches(doc: EditDoc, command: RenameSectionCommand, origin: string): CommandPatches;
+export declare function moveSectionPatches(doc: EditDoc, command: MoveSectionCommand, origin: string): CommandPatches;
+export declare function removeSectionPatches(doc: EditDoc, command: RemoveSectionCommand, origin: string): CommandPatches;

package/dist/commands/set-geometry.d.ts

@@ -0,0 +1,4 @@
+import type { EditDoc } from '../types';
+import type { CommandPatches } from './types';
+import type { SetGeometryCommand } from './geometry-types';
+export declare function setGeometryPatches(doc: EditDoc, command: SetGeometryCommand, origin: string): CommandPatches;

package/dist/commands/set-preset.d.ts

@@ -0,0 +1,5 @@
+import type { EditDoc } from '../types';
+import type { CommandPatches } from './types';
+import type { SetAdjCommand, SetPresetCommand } from './geometry-types';
+export declare function setPresetPatches(doc: EditDoc, command: SetPresetCommand, origin: string): CommandPatches;
+export declare function setAdjPatches(doc: EditDoc, command: SetAdjCommand, origin: string): CommandPatches;

package/dist/commands/set-table-style.d.ts

@@ -0,0 +1,3 @@
+import type { EditDoc } from '../types';
+import type { CommandPatches, SetTableStyleCommand } from './types';
+export declare function setTableStylePatches(doc: EditDoc, command: SetTableStyleCommand, origin: string): CommandPatches;

package/dist/commands/slide-property-types.d.ts

@@ -1,14 +1,23 @@
 import type { Fill, ImageTilePlacement, Transition } from '@web-ppt/core';
 import type { SlideTransitionInput } from '../slide-transition';
-import type { EditAnimationStep, ImageCrop, SlideId, SlideImageBackground, SlideNotesBinding } from '../types';
-export interface SetBackgroundCommand {
+import type { DesignTarget, EditAnimationStep, ImageCrop, LayoutDesignTarget, SlideId, SlideImageBackground, SlideNotesBinding } from '../types';
+export type SetBackgroundCommand = {
     readonly type: 'SetBackground';
     readonly id: SlideId;
+    readonly target?: never;
     /** null 恢复来源；显式无背景使用 { type: 'none' }。 */
     readonly fill: Exclude<Fill, {
         type: 'image';
     }> | null;
-}
+} | {
+    readonly type: 'SetBackground';
+    readonly target: DesignTarget;
+    readonly id?: never;
+    /** null 恢复来源；版式背景不接受图片，避免隐式扩张 OPC 资源闭包。 */
+    readonly fill: Exclude<Fill, {
+        type: 'image';
+    }> | null;
+};
 export interface SetBackgroundImageCommand {
     readonly type: 'SetBackgroundImage';
     readonly id: SlideId;
@@ -31,12 +40,18 @@ export interface SetHiddenCommand {
     /** null 恢复来源；false 可覆盖来源隐藏页。 */
     readonly v: boolean | null;
 }
-export interface SetTransitionCommand {
+export type SetTransitionCommand = {
     readonly type: 'SetTransition';
     readonly id: SlideId;
+    readonly target?: never;
     /** null 恢复来源；type=none 明确关闭切换。 */
     readonly t: SlideTransitionInput | null;
-}
+} | {
+    readonly type: 'SetTransition';
+    readonly target: LayoutDesignTarget;
+    readonly id?: never;
+    readonly t: SlideTransitionInput | null;
+};
 export interface SetAnimationsCommand {
     readonly type: 'SetAnimations';
     readonly slideId: SlideId;
@@ -133,3 +148,38 @@ export type SlideAnimationsPatch = {
     readonly origin: string;
 };
 export type SlidePropertyPatch = SlideBackgroundPatch | SlideBackgroundImagePatch | SlideHiddenPatch | SlideTransitionPatch | SlideAnimationsPatch;
+export type LayoutBackgroundPatch = {
+    readonly op: 'set';
+    readonly path: readonly ['layouts', string, 'ovr', 'background'];
+    readonly value: Exclude<Fill, {
+        type: 'image';
+    }>;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['layouts', string, 'ovr', 'background'];
+    readonly origin: string;
+};
+export type LayoutTransitionPatch = {
+    readonly op: 'set';
+    readonly path: readonly ['layouts', string, 'ovr', 'transition'];
+    readonly value: Transition;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['layouts', string, 'ovr', 'transition'];
+    readonly origin: string;
+};
+export type LayoutPropertyPatch = LayoutBackgroundPatch | LayoutTransitionPatch;
+export type MasterBackgroundPatch = {
+    readonly op: 'set';
+    readonly path: readonly ['masters', string, 'ovr', 'background'];
+    readonly value: Exclude<Fill, {
+        type: 'image';
+    }>;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['masters', string, 'ovr', 'background'];
+    readonly origin: string;
+};

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,4 +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/table-style-types.d.ts

@@ -0,0 +1,28 @@
+import type { TableStyleSettings } from '@web-ppt/core';
+import type { ElementId } from '../types';
+type TableStyleSwitches = Omit<TableStyleSettings, 'styleId'>;
+export type SetTableStyleCommand = {
+    readonly type: 'SetTableStyle';
+    readonly id: ElementId;
+} & ({
+    readonly styleId: null;
+    readonly firstRow?: never;
+    readonly lastRow?: never;
+    readonly bandRow?: never;
+    readonly firstCol?: never;
+    readonly lastCol?: never;
+    readonly bandCol?: never;
+} | ({
+    readonly styleId: string;
+} & TableStyleSwitches));
+export type ElementTableStylePatch = {
+    readonly op: 'set';
+    readonly path: readonly ['elements', ElementId, 'ovr', 'tableStyle'];
+    readonly value: TableStyleSettings;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['elements', ElementId, 'ovr', 'tableStyle'];
+    readonly origin: string;
+};
+export {};

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;
@@ -8,6 +8,7 @@ export interface TextTarget {
 export interface TextTargetContext {
     readonly record: ElementRecord;
     readonly body: TextBody;
+    readonly levelTemplate?: TextBody;
     readonly before: TextOverride | undefined;
     readonly patchTarget: TextPatchTarget;
     readonly empty: boolean;
@@ -16,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,13 +1,24 @@
-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 { 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 { SetBackgroundCommand, SetBackgroundCropCommand, SetBackgroundImageCommand, SetHiddenCommand, SetAnimationsCommand, SetTransitionCommand, SetLayoutCommand, SetNotesCommand, SlideLayoutPatch, SlideNotesPatch, SlidePropertyPatch } from './slide-property-types';
+import type { ElementHierarchyPatch, GroupCommand, UngroupCommand } from './group-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;
@@ -77,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;
@@ -88,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;
@@ -102,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;
@@ -114,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: {
@@ -128,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;
@@ -217,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';
@@ -234,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 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 | 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;
+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';
@@ -339,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 = {
@@ -395,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';
@@ -416,10 +535,74 @@ export type TableRowPatch = {
     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 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[];
+    readonly selection?: Selection;
 }
 export interface TextPosition {
     readonly p: number;
@@ -474,7 +657,7 @@ export interface TransactionResult extends ProjectionInvalidation, CommandPatche
     readonly renderSlides: Set<SlideId>;
 }
 export interface EditorChange extends ProjectionInvalidation, SlideChangeSets {
-    readonly source: 'transaction' | 'undo' | 'redo' | 'selection';
+    readonly source: 'transaction' | 'undo' | 'redo' | 'external' | 'selection';
     readonly selection: Selection;
     /** dirtyElements 含投影缓存祖先；DOM 增量分区必须以真正被 patch 的元素为准。 */
     readonly touchedElements: Set<ElementId>;
@@ -490,6 +673,25 @@ export interface EditorChange extends ProjectionInvalidation, SlideChangeSets {
     readonly paneElements: Set<ElementId>;
 }
 export type EditorSubscriber = (change: EditorChange) => void;
+export interface EditorPatchEvent {
+    readonly source: Exclude<EditorChange['source'], 'selection'>;
+    readonly patches: readonly Patch[];
+    readonly identity: EditIdentity;
+    readonly origin: string;
+    readonly label: string;
+    readonly time: number;
+}
+export type EditorPatchSubscriber = (event: EditorPatchEvent) => void;
+export interface EditorPatchSubscribeOptions {
+    /** 协同 checkpoint 必须先于 recovery 观察者看到同一事务；该阶段的订阅者不得重入编辑器。 */
+    readonly phase?: 'before-recovery' | 'after-observers';
+}
+export interface ExternalPatchOptions {
+    readonly identity?: EditIdentity;
+    readonly origin?: string;
+    readonly label?: string;
+    readonly time?: number;
+}
 export interface Transaction {
     exec(...commands: Command[]): void;
     select(selection: Selection): void;

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/commands/ungroup.d.ts

@@ -0,0 +1,4 @@
+import type { EditDoc } from '../types';
+import type { CommandPatches, UngroupCommand } from './types';
+/** 解组把每个孩子的 frame 分解到外部父空间，并以一个层级 Patch 原子替换组。 */
+export declare function ungroupPatches(doc: EditDoc, command: UngroupCommand, origin: string): CommandPatches;