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

package/dist/clipboard-package.d.ts

@@ -0,0 +1,4 @@
+import type { OpcPackage } from '@web-ppt/core';
+import type { EditDoc } from './types';
+/** 资源身份描述复制时的有效内容；临时部件不提交到源包或保存基线。 */
+export declare function clipboardPackage(doc: EditDoc): OpcPackage;

package/dist/clipboard-source.d.ts

@@ -1,7 +1,8 @@
 import type { OpcPackage } from '@web-ppt/core';
 import type { ClipboardRelationship, ClipboardResource } from './commands/types';
-import type { ElementInsertionSource } from './types';
+import type { EditDoc, ElementRecord, ElementInsertionSource } from './types';
 import type { XmlElement } from './xml/types';
+export declare function insertionOwner(doc: EditDoc, id: string): ElementRecord | null;
 export declare function relationshipPartFor(part: string): string;
 export declare function relativeTarget(fromPart: string, targetPart: string): string;
 export declare function resolveRelationshipTarget(fromPart: string, target: string): string;
@@ -11,13 +12,16 @@ export interface PackageTargetIdentity {
 }
 /** 用内容与关系图描述复杂对象；OPC 路径只参与读取，绝不进入剪贴板协议。 */
 export declare function packageTargetIdentity(pkg: OpcPackage, targetPart: string): PackageTargetIdentity;
+/** 内容寻址选中的路径可能不是原宿主路径；复用身份遍历结果保留确切依赖，不再扫描全包。 */
+export declare function packageTargetParts(pkg: OpcPackage, part: string): readonly string[];
 export declare function resolvePackageTarget(pkg: OpcPackage, identity: PackageTargetIdentity): string | null;
 export declare function packageContentType(pkg: OpcPackage, part: string, extension: string): string;
 /** 新 part 尚未有字节，仍必须尊重包中预先存在的精确 Override。 */
 export declare function packageContentTypeOverride(pkg: OpcPackage, part: string): string | undefined;
+export declare function relationshipIds(host: XmlElement, includeEmpty?: boolean): string[];
 export interface ClipboardClosure {
     relationships: ClipboardRelationship[];
     resources: ClipboardResource[];
 }
 /** 只复制宿主实际引用的关系；不把整张幻灯片的无关资源塞入系统剪贴板。 */
-export declare function clipboardClosure(pkg: OpcPackage, sourcePart: string, host: XmlElement, insertions?: readonly Pick<ElementInsertionSource, 'relationships' | 'resources'>[]): ClipboardClosure;
+export declare function clipboardClosure(pkg: OpcPackage, sourcePart: string, host: XmlElement, insertions?: readonly Pick<ElementInsertionSource, 'relationships' | 'resources'>[], effectivePackage?: () => OpcPackage): ClipboardClosure;

package/dist/clipboard-trees.d.ts

@@ -0,0 +1,9 @@
+import type { ClipboardResource, ClipboardXmlRoot } from './commands/types';
+import type { EditDoc, ElementId } from './types';
+/** 复制取得有效树；解组只移交来源，覆盖仍由原记录持有，避免追加行等操作被执行两次。 */
+export declare function elementTreeSources(doc: EditDoc, roots: readonly ElementId[], sourceOnly?: boolean): {
+    ooxml: {
+        roots: Record<string, ClipboardXmlRoot>;
+    };
+    resources: ClipboardResource[];
+};

package/dist/collaboration-identity.d.ts

@@ -0,0 +1,3 @@
+import type { EditDoc } from './types';
+/** provider 分配唯一 slot 后，在任何消息收发前固化本副本的逻辑与 OOXML 身份区间。 */
+export declare function configureCollaborationIdentity(doc: EditDoc, replicaId: string, slot: number, count?: number): void;

package/dist/commands/add-slide-identity.d.ts

@@ -5,4 +5,8 @@ export declare function allocateSlideOpcIdentity(doc: EditDoc): {
     presentationRelationshipId: string;
 };
 export declare function allocateNotesPart(doc: EditDoc): string;
+/** 协同绑定期固化全部全局 OPC 数值区间，后续远端补丁不会改变本副本的分配边界。 */
+export declare function prepareSlideOpcNamespaces(doc: EditDoc): void;
+/** presentation 关系与列表只解析一次；调用方可按 part 批量取得稳定数值身份。 */
+export declare function presentationSlideIdsByPart(doc: EditDoc): ReadonlyMap<string, number>;
 export declare function presentationSlideIdForPart(doc: EditDoc, part: string): number | undefined;

package/dist/commands/bullet-image-resource.d.ts

@@ -0,0 +1,11 @@
+import type { EditDoc, ElementImageReplacement, ElementInsertionResource } from '../types';
+import type { ImageResourcePatch } from './types';
+type CompactImageResource = Omit<ElementInsertionResource, 'targetPart' | 'created'> & {
+    readonly sourcePart?: string;
+};
+export declare function resolveBulletImageResource(doc: EditDoc, src: string, label: string): CompactImageResource;
+export declare function prepareBulletImageResource(doc: EditDoc, part: string, sourceRid: string, resource: CompactImageResource, origin: string): {
+    readonly image: ElementImageReplacement;
+    readonly resourcePatch?: ImageResourcePatch;
+};
+export {};

package/dist/commands/clear-format.d.ts

@@ -0,0 +1,4 @@
+import type { EditDoc } from '../types';
+import type { ClearFormatCommand, CommandPatches } from './types';
+/** 清除格式只动视觉直设；超链接、字段、公式和段落身份都由原 mark 原样保留。 */
+export declare function clearFormatPatches(doc: EditDoc, command: ClearFormatCommand, origin: string): CommandPatches;

package/dist/commands/common-object-slide-patch.d.ts

@@ -0,0 +1,4 @@
+import type { EditDoc } from '../types';
+import type { Patch } from './types';
+export declare function validateCommonObjectSlidePatch(doc: EditDoc, patch: Patch, index: number): boolean;
+export declare function applyCommonObjectSlidePatch(doc: EditDoc, patch: Patch): boolean;

package/dist/commands/common-object-slide-types.d.ts

@@ -0,0 +1,68 @@
+import type { ElementId, SectionId, SectionState, SlideId } from '../types';
+export interface SetAltTextCommand {
+    readonly type: 'SetAltText';
+    readonly id: ElementId;
+    /** null 单独恢复该字段的来源属性。 */
+    readonly title: string | null;
+    readonly descr: string | null;
+}
+export interface DistributeElementsCommand {
+    readonly type: 'DistributeElements';
+    readonly ids: readonly ElementId[];
+    readonly axis: 'horizontal' | 'vertical';
+}
+export interface AddSectionCommand {
+    readonly type: 'AddSection';
+    readonly name: string;
+    readonly slideIds: readonly SlideId[];
+    readonly at: {
+        readonly after: SectionId | null;
+    };
+}
+export interface RenameSectionCommand {
+    readonly type: 'RenameSection';
+    readonly id: SectionId;
+    readonly name: string;
+}
+export interface MoveSectionCommand {
+    readonly type: 'MoveSection';
+    readonly id: SectionId;
+    readonly at: {
+        readonly after: SectionId | null;
+    };
+}
+export interface RemoveSectionCommand {
+    readonly type: 'RemoveSection';
+    readonly id: SectionId;
+}
+export interface SetSlideSizeCommand {
+    readonly type: 'SetSlideSize';
+    /** null 恢复对应来源尺寸。 */
+    readonly w: number | null;
+    readonly h: number | null;
+    /** 默认仅改画布；ensureFit 需先注册 @web-ppt/edit-core/resize 按需模块。 */
+    readonly fit?: 'none' | 'ensureFit';
+}
+export type ElementAltTextPatch = {
+    readonly op: 'set';
+    readonly path: readonly ['elements', ElementId, 'ovr', 'altText', 'title' | 'descr'];
+    readonly value: string;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['elements', ElementId, 'ovr', 'altText', 'title' | 'descr'];
+    readonly origin: string;
+};
+export type SectionStatePatch = {
+    readonly op: 'set';
+    /** 完整快照保证本地撤销精确；末两段让协同按节、按意图独立仲裁。 */
+    readonly path: readonly ['document', 'sections', SectionId, 'state' | 'name' | 'order'];
+    readonly value: SectionState;
+    readonly origin: string;
+};
+export type DocumentSizePatch = {
+    readonly op: 'set';
+    readonly path: readonly ['document', 'size', 'w' | 'h'];
+    readonly value: number;
+    readonly origin: string;
+};

package/dist/commands/convert-to-custom-geometry.d.ts

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

package/dist/commands/direct-format-patches.d.ts

@@ -1,8 +1,14 @@
 import type { Effects, Fill, Stroke } from '@web-ppt/core';
 import type { EditDoc } from '../types';
 import type { CommandPatches } from './types';
-export declare function directFillPatches(doc: EditDoc, id: string, value: Exclude<Fill, {
-    type: 'image';
-}>, origin: string): CommandPatches;
-export declare function directStrokePatches(doc: EditDoc, id: string, value: Stroke | null, origin: string): CommandPatches;
-export declare function directEffectsPatches(doc: EditDoc, id: string, value: Effects, origin: string): CommandPatches;
+type FormatField = 'fill' | 'stroke' | 'effects';
+type FormatValue = {
+    fill: Exclude<Fill, {
+        type: 'image';
+    }>;
+    stroke: Stroke | null;
+    effects: Effects;
+};
+/** 三种直设格式共用覆盖/继承语义；字段的值域仍由各命令入口校验。 */
+export declare function directFormatPatches<F extends FormatField>(doc: EditDoc, id: string, field: F, value: FormatValue[F], origin: string): CommandPatches;
+export {};

package/dist/commands/distribute-elements.d.ts

@@ -0,0 +1,4 @@
+import type { EditDoc } from '../types';
+import type { CommandPatches, DistributeElementsCommand } from './types';
+/** 两端保持不动，中间对象按旋转后的世界 AABB 间隙等距排列。 */
+export declare function distributeElementsPatches(doc: EditDoc, command: DistributeElementsCommand, origin: string): CommandPatches;

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

@@ -0,0 +1,10 @@
+import type { EditDoc } from '../types';
+import type { CommandPatches, InsertColumnCommand, MergeCellsCommand, RemoveColumnCommand, RemoveRowCommand, SetCellPropsCommand, SetColumnWidthCommand, SetRowHeightCommand, SplitCellCommand } from './types';
+export declare function insertColumnPatches(doc: EditDoc, command: InsertColumnCommand, origin: string): CommandPatches;
+export declare function removeRowPatches(doc: EditDoc, command: RemoveRowCommand, origin: string): CommandPatches;
+export declare function removeColumnPatches(doc: EditDoc, command: RemoveColumnCommand, origin: string): CommandPatches;
+export declare function setRowHeightPatches(doc: EditDoc, command: SetRowHeightCommand, origin: string): CommandPatches;
+export declare function setColumnWidthPatches(doc: EditDoc, command: SetColumnWidthCommand, origin: string): CommandPatches;
+export declare function mergeCellsPatches(doc: EditDoc, command: MergeCellsCommand, origin: string): CommandPatches;
+export declare function splitCellPatches(doc: EditDoc, command: SplitCellCommand, origin: string): CommandPatches;
+export declare function setCellPropsPatches(doc: EditDoc, command: SetCellPropsCommand, origin: string): CommandPatches;

package/dist/commands/element-alt-text.d.ts

@@ -0,0 +1,8 @@
+import type { EditDoc } from '../types';
+import type { CommandPatches, ElementAltTextPatch, SetAltTextCommand } from './types';
+export declare function isElementAltTextPatch(patch: {
+    readonly path: readonly unknown[];
+}): patch is ElementAltTextPatch;
+export declare function validateElementAltTextPatch(doc: EditDoc, patch: ElementAltTextPatch, index: number): void;
+export declare function applyElementAltTextPatch(doc: EditDoc, patch: ElementAltTextPatch): void;
+export declare function setAltTextPatches(doc: EditDoc, command: SetAltTextCommand, origin: string): CommandPatches;

package/dist/commands/element-arrangement.d.ts

@@ -0,0 +1,17 @@
+import type { SpacePoint } from '../space';
+import type { EditDoc, ElementId } from '../types';
+import type { CommandPatches } from './types';
+export interface ElementWorldBounds {
+    readonly left: number;
+    readonly top: number;
+    readonly right: number;
+    readonly bottom: number;
+}
+export interface ArrangementTarget {
+    readonly id: ElementId;
+    readonly bounds: ElementWorldBounds;
+}
+export declare function elementWorldBounds(doc: EditDoc, id: ElementId): ElementWorldBounds;
+/** 排列命令共享“同页、可移动、最外层”边界，避免对齐与分布逐渐产生两套语义。 */
+export declare function arrangementTargets(doc: EditDoc, ids: readonly ElementId[], minimum: number, label: string): ArrangementTarget[];
+export declare function translateElementInSlide(doc: EditDoc, id: ElementId, worldDelta: SpacePoint, origin: string, label: string): CommandPatches;

package/dist/commands/element-effects.d.ts

@@ -2,4 +2,4 @@ import type { EditDoc } from '../types';
 import type { ElementEffectsPatch, Patch } from './types';
 export declare function isElementEffectsPatch(patch: Patch): patch is ElementEffectsPatch;
 export declare function validateElementEffectsPatch(doc: EditDoc, patch: ElementEffectsPatch, index: number): void;
-export declare function applyElementEffectsPatch(doc: EditDoc, patch: ElementEffectsPatch): void;
+export { applyRecordOverridePatch as applyElementEffectsPatch } from './record-override';

package/dist/commands/element-fill.d.ts

@@ -2,4 +2,4 @@ import type { EditDoc } from '../types';
 import type { ElementFillPatch, Patch } from './types';
 export declare function isElementFillPatch(patch: Patch): patch is ElementFillPatch;
 export declare function validateElementFillPatch(doc: EditDoc, patch: ElementFillPatch, index: number): void;
-export declare function applyElementFillPatch(doc: EditDoc, patch: ElementFillPatch): void;
+export { applyRecordOverridePatch as applyElementFillPatch } from './record-override';

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

@@ -0,0 +1,9 @@
+import type { EditDoc } from '../types';
+import type { Patch } from './types';
+import type { ElementGeometryPatch, ElementPresetGeometryPatch } from './geometry-types';
+export declare function isElementGeometryPatch(patch: Patch): patch is ElementGeometryPatch;
+export declare function isElementPresetGeometryPatch(patch: Patch): patch is ElementPresetGeometryPatch;
+export declare function validateElementPresetGeometryPatch(doc: EditDoc, patch: ElementPresetGeometryPatch, index: number): void;
+export { applyRecordOverridePatch as applyElementPresetGeometryPatch } from './record-override';
+export declare function validateElementGeometryPatch(doc: EditDoc, patch: ElementGeometryPatch, index: number): void;
+export { applyRecordOverridePatch as applyElementGeometryPatch } from './record-override';

package/dist/commands/element-hierarchy.d.ts

@@ -0,0 +1,6 @@
+import type { EditDoc } from '../types';
+import type { ElementHierarchyPatch, ElementHierarchyState, Patch } from './types';
+export declare function isElementHierarchyPatch(patch: Patch): patch is ElementHierarchyPatch;
+export declare function validateElementHierarchyPatch(doc: EditDoc, patch: ElementHierarchyPatch, index: number): void;
+export declare function applyElementHierarchyPatch(doc: EditDoc, patch: ElementHierarchyPatch): void;
+export declare function elementHierarchySlide(doc: EditDoc, state: ElementHierarchyState): string;

package/dist/commands/element-image-content.d.ts

@@ -1,6 +1,6 @@
 import type { EditDoc, ElementImageReplacement, ElementInsertionResource } from '../types';
 import type { ElementCropPatch, ElementImageReplacementPatch, ImageResourcePatch, Patch } from './types';
-export declare function assertImageReplacement(value: unknown, sourcePart: string, resources: Readonly<Record<string, ElementInsertionResource>>, label: string): asserts value is ElementImageReplacement;
+export declare function assertImageReplacement(value: unknown, sourcePart: string | undefined, resources: Readonly<Record<string, ElementInsertionResource>>, label: string): asserts value is ElementImageReplacement;
 export declare function assertImageResource(value: unknown, label: string, doc?: EditDoc): asserts value is ElementInsertionResource;
 /** 无来源溯源的背景只能是公开上传白名单，不能把包内扩展格式伪装成上传。 */
 export declare function assertUploadImageResource(resource: ElementInsertionResource, label: string): void;
@@ -12,6 +12,6 @@ export declare function isImageResourcePatch(patch: Patch): patch is ImageResour
 export declare function validateElementCropPatch(doc: EditDoc, patch: ElementCropPatch, index: number): void;
 export declare function validateElementImageReplacementPatch(doc: EditDoc, patch: ElementImageReplacementPatch, index: number, resources?: Readonly<Record<string, ElementInsertionResource>>): void;
 export declare function validateImageResourcePatch(doc: EditDoc, patch: ImageResourcePatch, index: number): void;
-export declare function applyElementCropPatch(doc: EditDoc, patch: ElementCropPatch): void;
+export { applyRecordOverridePatch as applyElementCropPatch } from './record-override';
 export declare function applyElementImageReplacementPatch(doc: EditDoc, patch: ElementImageReplacementPatch): void;
 export declare function applyImageResourcePatch(doc: EditDoc, patch: ImageResourcePatch): void;

package/dist/commands/element-link.d.ts

@@ -2,4 +2,4 @@ import type { EditDoc } from '../types';
 import type { ElementLinkPatch, Patch } from './types';
 export declare function isElementLinkPatch(patch: Patch): patch is ElementLinkPatch;
 export declare function validateElementLinkPatch(doc: EditDoc, patch: ElementLinkPatch, index: number): void;
-export declare function applyElementLinkPatch(doc: EditDoc, patch: ElementLinkPatch): void;
+export { applyRecordOverridePatch as applyElementLinkPatch } from './record-override';

package/dist/commands/element-name.d.ts

@@ -4,5 +4,5 @@ export declare function isElementNamePatch(patch: {
     readonly path: readonly unknown[];
 }): patch is ElementNamePatch;
 export declare function validateElementNamePatch(doc: EditDoc, patch: ElementNamePatch, index: number): void;
-export declare function applyElementNamePatch(doc: EditDoc, patch: ElementNamePatch): void;
+export { applyRecordOverridePatch as applyElementNamePatch } from './record-override';
 export declare function setNamePatches(doc: EditDoc, command: SetNameCommand, origin: string): CommandPatches;

package/dist/commands/element-stroke.d.ts

@@ -2,4 +2,4 @@ import type { EditDoc } from '../types';
 import type { ElementStrokePatch, Patch } from './types';
 export declare function isElementStrokePatch(patch: Patch): patch is ElementStrokePatch;
 export declare function validateElementStrokePatch(doc: EditDoc, patch: ElementStrokePatch, index: number): void;
-export declare function applyElementStrokePatch(doc: EditDoc, patch: ElementStrokePatch): void;
+export { applyRecordOverridePatch as applyElementStrokePatch } from './record-override';

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

@@ -0,0 +1,5 @@
+import type { EditDoc } from '../types';
+import type { ElementTableStylePatch, Patch } from './types';
+export declare function isElementTableStylePatch(patch: Patch): patch is ElementTableStylePatch;
+export declare function validateElementTableStylePatch(doc: EditDoc, patch: ElementTableStylePatch, index: number): void;
+export declare function applyElementTableStylePatch(doc: EditDoc, patch: ElementTableStylePatch): void;

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

@@ -2,5 +2,5 @@ import type { EditDoc, TableRowInsertion } from '../types';
 import type { CommandPatches, ElementTextPatch, Patch } from './types';
 export declare function isElementTextPatch(patch: Patch): patch is ElementTextPatch;
 export declare function clearElementTextPatches(doc: EditDoc, id: string, origin: string): CommandPatches;
-export declare function validateElementTextPatch(doc: EditDoc, patch: ElementTextPatch, index: number, stagedTableRows?: Record<string, TableRowInsertion>): void;
+export declare function validateElementTextPatch(doc: EditDoc, patch: ElementTextPatch, index: number, stagedTableRows?: Record<string, TableRowInsertion>, stagedImageResources?: Readonly<Record<string, import('../types').ElementInsertionResource>>): void;
 export declare function applyElementTextPatch(doc: EditDoc, patch: ElementTextPatch): void;

package/dist/commands/element-transform.d.ts

@@ -1,5 +1,5 @@
 import type { EditDoc } from '../types';
-import type { CommandPatches, ElementTransformPatch, XfrmField } from './types';
+import type { CommandPatches, XfrmField } from './types';
 /** 变换命令共用权限与 patch 语义，避免位置和翻转两条路径逐渐分叉。 */
 export declare function elementTransformPatches(doc: EditDoc, id: string, values: Partial<Record<XfrmField, unknown>>, fields: readonly XfrmField[], origin: string, label: string): CommandPatches;
-export declare function applyElementTransformPatch(doc: EditDoc, patch: ElementTransformPatch): void;
+export { applyRecordOverridePatch as applyElementTransformPatch } from './record-override';

package/dist/commands/frame-decomposition.d.ts

@@ -0,0 +1,10 @@
+import type { AffineMatrix } from '../space';
+/** PPTX frame 只能表达旋转、缩放与镜像；仿射矩阵含斜切时必须由调用者拒绝。 */
+export declare function decomposeFrameMatrix(matrix: AffineMatrix, width: number, height: number, shearError: string): {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    rot: number;
+    reflectH: boolean;
+};

package/dist/commands/generated-creation-defaults.d.ts

@@ -0,0 +1,4 @@
+import type { ShapeCreationDefaults, TableCreationDefaults } from '@web-ppt/core';
+/** `.ppt` 没有 OOXML 主题创建默认值；生成包因此用与固定骨架配套的显式中性值。 */
+export declare const GENERATED_SHAPE_DEFAULTS: ShapeCreationDefaults;
+export declare const GENERATED_TABLE_DEFAULTS: TableCreationDefaults;

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

@@ -0,0 +1,44 @@
+import type { CustomGeometry, GeomSpec } from '@web-ppt/core';
+import type { ElementId } from '../types';
+export interface SetGeometryCommand {
+    readonly type: 'SetGeometry';
+    readonly id: ElementId;
+    /** null 恢复来源几何；预设形状必须先走显式自由形状转换命令。 */
+    readonly geometry: CustomGeometry | null;
+}
+export interface ConvertToCustomGeometryCommand {
+    readonly type: 'ConvertToCustomGeometry';
+    readonly id: ElementId;
+}
+export interface SetPresetCommand {
+    readonly type: 'SetPreset';
+    readonly id: ElementId;
+    /** 切换预设会按规范清空旧 avLst；其它形状属性不进入该命令。 */
+    readonly preset: string;
+}
+export interface SetAdjCommand {
+    readonly type: 'SetAdj';
+    readonly id: ElementId;
+    readonly name: string;
+    readonly value: number;
+}
+export type ElementGeometryPatch = {
+    readonly op: 'set';
+    readonly path: readonly ['elements', ElementId, 'ovr', 'geometry'];
+    readonly value: CustomGeometry;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['elements', ElementId, 'ovr', 'geometry'];
+    readonly origin: string;
+};
+export type ElementPresetGeometryPatch = {
+    readonly op: 'set';
+    readonly path: readonly ['elements', ElementId, 'ovr', 'presetGeometry'];
+    readonly value: GeomSpec;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['elements', ElementId, 'ovr', 'presetGeometry'];
+    readonly origin: string;
+};

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

@@ -0,0 +1,24 @@
+import type { ElementId, ElementRecord, RemovedElementRecord, SlideId } from '../types';
+export interface GroupCommand {
+    readonly type: 'Group';
+    readonly ids: readonly ElementId[];
+}
+export interface UngroupCommand {
+    readonly type: 'Ungroup';
+    readonly id: ElementId;
+}
+export interface ElementHierarchyState {
+    /** 结构变化发生前后都存在的外部父级，用于精确失效所属页或祖先。 */
+    readonly parent: SlideId | ElementId;
+    readonly affected: readonly ElementId[];
+    readonly records: Readonly<Record<ElementId, ElementRecord | null>>;
+    readonly children: Readonly<Record<SlideId | ElementId, readonly ElementId[]>>;
+    readonly removed: Readonly<Record<ElementId, RemovedElementRecord | null>>;
+}
+/** 组合/解组同时改变多个父链，必须作为一个不可见中间态的结构原子落模。 */
+export type ElementHierarchyPatch = {
+    readonly op: 'set';
+    readonly path: readonly ['elements', ElementId, 'hierarchy'];
+    readonly value: ElementHierarchyState;
+    readonly origin: string;
+};

package/dist/commands/group.d.ts

@@ -0,0 +1,4 @@
+import type { EditDoc } from '../types';
+import type { CommandPatches, GroupCommand } from './types';
+/** 新组是空 OOXML 容器；孩子保留原身份与变换，只改变直属父链。 */
+export declare function groupPatches(doc: EditDoc, command: GroupCommand, origin: string): CommandPatches;

package/dist/commands/hierarchy-record.d.ts

@@ -0,0 +1,5 @@
+import type { ElementRecord } from '../types';
+/**
+ * 层级命令从不改解析来源；只复制可变覆盖与元数据，避免大选区为历史反复深拷贝整棵只读 src。
+ */
+export declare function cloneHierarchyRecord(record: ElementRecord): ElementRecord;

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

@@ -1,4 +1,11 @@
-import type { ClipboardResource } from './types';
+import type { ClipboardResource, ImageResourcePatch } from './types';
+import type { EditDoc, ElementInsertionResource } from '../types';
 export declare const MAX_REPLACE_IMAGE_BYTES: number;
+export declare function generatedImageResource(resource: ClipboardResource): ElementInsertionResource;
+/** 已被文档保留的资源不能随另一个使用者撤销；新增资源与使用它的覆盖共同进退。 */
+export declare function imageResourcePatches(doc: EditDoc, resources: readonly ElementInsertionResource[], origin: string): {
+    forward: ImageResourcePatch[];
+    inverse: ImageResourcePatch[];
+};
 export declare function copyImageBytes(value: unknown, label: string, maxBytes?: number): Uint8Array;
 export declare function createImageResource(bytesInput: unknown, mime: unknown, label: string, maxBytes?: number): ClipboardResource;

package/dist/commands/insertion-host.d.ts

@@ -0,0 +1,16 @@
+import type { DesignTarget, EditDoc, ElementId, LayoutRecord, MasterRecord, SlideId, SlideRecord } from '../types';
+export interface InsertionCanvas {
+    readonly kind: 'slide' | 'layout' | 'master';
+    readonly id: SlideId | string;
+    readonly children: readonly ElementId[];
+    readonly part: string | null;
+}
+/** 有可补丁原包时返回 OOXML 宿主；否则让命令只改统一模型，保存时由生成器物化宿主。 */
+export declare function incrementalInsertionPart(doc: EditDoc, slide: SlideRecord): string | null;
+export declare function incrementalLayoutInsertionPart(doc: EditDoc, layout: LayoutRecord): string | null;
+export declare function incrementalMasterInsertionPart(doc: EditDoc, master: MasterRecord): string | null;
+/** 三种插入命令共享同一画布寻址，避免各自近似处理版式与页面宿主。 */
+export declare function resolveInsertionCanvas(doc: EditDoc, command: {
+    readonly target?: DesignTarget;
+    readonly slideId?: SlideId;
+}, label: string): InsertionCanvas;

package/dist/commands/insertion-rect.d.ts

@@ -7,3 +7,5 @@ export interface InsertionRect {
 export declare const EMU_PER_PX = 9525;
 export declare const pxToEmu: (value: number) => number;
 export declare function assertInsertionRect(value: unknown, label: string): asserts value is InsertionRect;
+/** OOXML 允许线条的单轴尺寸为零；已有元素 frame 的约束不同于新增实体的正尺寸。 */
+export declare function assertFrameRect(value: unknown, label: string): asserts value is InsertionRect;

package/dist/commands/layout-property.d.ts

@@ -0,0 +1,7 @@
+import type { EditDoc } from '../types';
+import type { LayoutBackgroundPatch, LayoutPropertyPatch, LayoutTransitionPatch, Patch } from './types';
+export declare function isLayoutBackgroundPatch(patch: Patch): patch is LayoutBackgroundPatch;
+export declare function isLayoutTransitionPatch(patch: Patch): patch is LayoutTransitionPatch;
+export declare function isLayoutPropertyPatch(patch: Patch): patch is LayoutPropertyPatch;
+export declare function validateLayoutPropertyPatch(doc: EditDoc, patch: LayoutPropertyPatch, index: number): void;
+export { applyRecordOverridePatch as applyLayoutPropertyPatch } from './record-override';

package/dist/commands/master-property.d.ts

@@ -0,0 +1,5 @@
+import type { EditDoc } from '../types';
+import type { MasterBackgroundPatch, Patch } from './types';
+export declare function isMasterBackgroundPatch(patch: Patch): patch is MasterBackgroundPatch;
+export declare function validateMasterBackgroundPatch(doc: EditDoc, patch: MasterBackgroundPatch, index: number): void;
+export { applyRecordOverridePatch as applyMasterBackgroundPatch } from './record-override';

package/dist/commands/master-text-style-types.d.ts

@@ -0,0 +1,27 @@
+import type { MasterTextCategory } from '@web-ppt/core';
+import type { MasterDesignTarget, MasterParagraphPropertyInput, MasterRunPropertyOverrides, MasterParagraphPropertyOverrides } from '../types';
+export interface SetMasterTextStyleCommand {
+    readonly type: 'SetMasterTextStyle';
+    readonly target: MasterDesignTarget;
+    readonly category: MasterTextCategory;
+    readonly level: number;
+    /** null 字段恢复母版来源；level 由命令路径决定，不能在段落值里重复声明。 */
+    readonly paragraph?: MasterParagraphPropertyInput;
+    /** 母版默认字符样式不承载超链接。 */
+    readonly run?: MasterRunPropertyOverrides;
+}
+type SetPatch<S extends 'paragraph' | 'run', F extends string, V> = {
+    readonly op: 'set';
+    readonly path: readonly ['masters', string, 'ovr', 'textStyles', MasterTextCategory, number, S, F];
+    readonly value: V;
+    readonly origin: string;
+};
+type DeletePatch<S extends 'paragraph' | 'run', F extends string> = {
+    readonly op: 'del';
+    readonly path: readonly ['masters', string, 'ovr', 'textStyles', MasterTextCategory, number, S, F];
+    readonly origin: string;
+};
+export type MasterParagraphTextStylePatch = SetPatch<'paragraph', keyof MasterParagraphPropertyOverrides & string, NonNullable<MasterParagraphPropertyOverrides[keyof MasterParagraphPropertyOverrides]>> | DeletePatch<'paragraph', keyof MasterParagraphPropertyOverrides & string>;
+export type MasterRunTextStylePatch = SetPatch<'run', keyof MasterRunPropertyOverrides & string, NonNullable<MasterRunPropertyOverrides[keyof MasterRunPropertyOverrides]>> | DeletePatch<'run', keyof MasterRunPropertyOverrides & string>;
+export type MasterTextStylePatch = MasterParagraphTextStylePatch | MasterRunTextStylePatch;
+export {};

package/dist/commands/master-text-style.d.ts

@@ -0,0 +1,7 @@
+import type { EditDoc } from '../types';
+import type { CommandPatches, Patch } from './types';
+import type { MasterTextStylePatch, SetMasterTextStyleCommand } from './master-text-style-types';
+export declare function isMasterTextStylePatch(patch: Patch): patch is MasterTextStylePatch;
+export declare function setMasterTextStylePatches(doc: EditDoc, command: SetMasterTextStyleCommand, origin: string): CommandPatches;
+export declare function validateMasterTextStylePatch(doc: EditDoc, patch: MasterTextStylePatch, index: number): void;
+export declare function applyMasterTextStylePatch(doc: EditDoc, patch: MasterTextStylePatch): void;

package/dist/commands/paste-resources.d.ts

@@ -1,18 +1,22 @@
-import type { EditDoc, ElementInsertionRelationship, ElementInsertionResource } from '../types';
+import type { EditDoc, ElementInsertionRelationship, ElementInsertionResource, ElementInsertionSource } from '../types';
 import type { ElementClipboardPayload } from './types';
 import type { ClipboardClosure } from '../clipboard-source';
 import type { OpcPackage } from '@web-ppt/core';
 export interface PreparedInsertionClosure {
-    relationships: ElementInsertionRelationship[];
-    resources: ElementInsertionResource[];
+    readonly relationships: readonly ElementInsertionRelationship[];
+    readonly resources: readonly ElementInsertionResource[];
 }
+export declare function activeClosures(doc: EditDoc, part?: string): Pick<ElementInsertionSource, 'relationships' | 'resources'>[];
 /** 图片替换与剪贴板共用目标 part/关系分配，避免命令伪造一棵空剪贴板树。 */
-export declare function prepareMediaResourceClosure(doc: EditDoc, destinationPart: string, sourceId: string, type: string, source: Omit<ElementInsertionResource, 'targetPart' | 'created'>): PreparedInsertionClosure;
+export declare function prepareMediaResourceClosure(doc: EditDoc, destinationPart: string, sourceId: string, type: string, source: Omit<ElementInsertionResource, 'targetPart' | 'created'> & {
+    readonly sourcePart?: string;
+}): PreparedInsertionClosure;
 /** 继承背景来自当前包的已知宿主；按关系闭包逐项改写，不能为一次裁剪扫描整包媒体。 */
 export declare function prepareTrustedSourceClosure(doc: EditDoc, pkg: OpcPackage, source: ClipboardClosure, sourcePart: string, destinationPart: string): PreparedInsertionClosure;
 /** 来源与目标是同一 slide 时复用现有关系，裁剪不应制造未引用的新 rId。 */
 export declare function prepareExistingSourceClosure(pkg: OpcPackage, source: ClipboardClosure, sourcePart: string): PreparedInsertionClosure;
 /** 先验证完整闭包并分配所有目标名；调用返回前不得触碰 EditDoc。 */
-export declare function prepareInsertionClosures(doc: EditDoc, payload: ElementClipboardPayload, roots: readonly string[], destinationPart: string, options?: {
+export declare function prepareInsertionClosures(doc: EditDoc, payload: Pick<ElementClipboardPayload, 'ooxml' | 'resources'>, roots: readonly string[], destinationPart: string, options?: {
     readonly preverifiedResourceHashes?: ReadonlySet<string>;
+    readonly sourceOnly?: boolean;
 }): Map<string, PreparedInsertionClosure>;

package/dist/commands/patch-apply.d.ts

@@ -0,0 +1,3 @@
+import type { EditDoc } from '../types';
+import type { Patch } from './types';
+export declare function applyPatchValues(doc: EditDoc, patches: readonly Patch[]): void;

package/dist/commands/patch-count.d.ts

@@ -0,0 +1 @@
+export declare function assertPatchCount(count: number): void;

package/dist/commands/patch-invalidation.d.ts

@@ -0,0 +1,4 @@
+import type { EditDoc } from '../types';
+import type { Patch } from './types';
+export declare function collectPatchInvalidation(doc: EditDoc, patch: Patch, dirtyElements: Set<string>, dirtySlides: Set<string>, addressTargets: Set<string>): void;
+export declare function canInvalidateAgainst(doc: EditDoc, patch: Patch): boolean;

package/dist/commands/patch-stage.d.ts

@@ -0,0 +1,4 @@
+import type { EditDoc } from '../types';
+import type { Patch } from './types';
+/** 结构补丁只复制可能被写入的记录；大文稿验证不应深克隆整份模型。 */
+export declare function structuralPatchStage(doc: EditDoc, patches: readonly Patch[]): EditDoc;

package/dist/commands/patch.d.ts

@@ -1,5 +1,9 @@
 import type { EditDoc, ProjectionInvalidation } from '../types';
 import type { Patch } from './types';
+/** 协同等调用方可在不触碰真实模型的前提下验真一批外部 Patch。 */
+export declare function assertPatchesApplicable(doc: EditDoc, patches: readonly Patch[]): void;
+/** 返回写时复制的外部 Patch 预演模型；调用方只能读取，真实文档始终不变。 */
+export declare function stageExternalPatches(doc: EditDoc, patches: readonly Patch[]): EditDoc;
 /** JSON/协同 seam：结构快照必须先在写时复制的完整模型上验真。 */
 export declare function applyPatches(doc: EditDoc, patches: readonly Patch[]): ProjectionInvalidation;
 /** 仅供同一事务内刚生成的命令 Patch；事务末尾由 Editor 统一校验完整模型。 */

package/dist/commands/record-clone.d.ts

@@ -0,0 +1,3 @@
+import type { ElementRecord } from '../types';
+/** 九级文字样式是解析期只读目录；单记录快照复用它，批量历史再统一深拷贝。 */
+export declare function cloneElementRecord(record: ElementRecord): ElementRecord;

package/dist/commands/record-override.d.ts

@@ -0,0 +1,5 @@
+import type { EditDoc } from '../types';
+import type { ElementGeometryPatch, ElementPresetGeometryPatch } from './geometry-types';
+import type { LayoutPropertyPatch, MasterBackgroundPatch, SlidePropertyPatch, SlideBackgroundImagePatch, ElementTransformPatch, ElementCropPatch, ElementEffectsPatch, ElementFillPatch, ElementLinkPatch, ElementNamePatch, ElementStrokePatch } from './types';
+/** 值已通过各领域校验，应用阶段共用克隆/删除语义，避免属性实现漂移。 */
+export declare function applyRecordOverridePatch(doc: EditDoc, patch: LayoutPropertyPatch | MasterBackgroundPatch | Exclude<SlidePropertyPatch, SlideBackgroundImagePatch> | ElementGeometryPatch | ElementPresetGeometryPatch | ElementTransformPatch | ElementCropPatch | ElementEffectsPatch | ElementFillPatch | ElementLinkPatch | ElementNamePatch | ElementStrokePatch): void;