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

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

@@ -0,0 +1,91 @@
+import type { GeomSpec, SlideElement } from '@web-ppt/core';
+import type { AffineMatrix } from '../space';
+import type { EditableKind, SlideId, TableCellAddress } from '../types';
+export interface ElementClipboardRecordMeta {
+    /** 同一次复制操作的来源证明；粘贴时用来拒绝拼接多个来源的伪造树。 */
+    readonly copyBatchId: string;
+    readonly editable: EditableKind;
+    readonly anchored: boolean;
+    readonly sourceSpid?: number;
+    readonly geom?: GeomSpec;
+    /** 复制时根元素的 frame → slide 视觉矩阵；后代不需要重复携带。 */
+    readonly frameToSlide?: AffineMatrix;
+    readonly link?: ClipboardPortableLink;
+    readonly textLinks?: readonly ClipboardTextLink[];
+}
+export type ClipboardPortableLink = {
+    readonly kind: 'external';
+    readonly href: string;
+} | {
+    readonly kind: 'slide';
+    readonly sourceSlideId: SlideId;
+    readonly packageTarget?: {
+        readonly rootHash: string;
+        readonly closureHash: string;
+    };
+} | {
+    readonly kind: 'none';
+} | {
+    readonly kind: 'unsupported';
+} | {
+    readonly kind: 'relative';
+    readonly action: 'next' | 'previous' | 'first' | 'last';
+};
+export interface ClipboardTextLink {
+    readonly paragraph: number;
+    readonly run: number;
+    readonly cell?: TableCellAddress;
+    readonly value: ClipboardPortableLink;
+}
+export interface ClipboardXmlRoot {
+    readonly markup: string;
+    readonly namespaces: Readonly<Record<string, string>>;
+    readonly hostSpids: readonly string[];
+    readonly relationships?: readonly ClipboardRelationship[];
+}
+export interface ClipboardRelationship {
+    /** 宿主片段中原始的 r:id / r:embed / r:link 值。 */
+    readonly sourceId: string;
+    readonly type: string;
+    readonly target?: string;
+    readonly targetMode?: 'External';
+    readonly resourceHash?: string;
+    /** 复杂 OOXML 对象只在目标包拥有同一闭包时复用，不把未知格式静默扁平化。 */
+    readonly packageTarget?: {
+        /** 根内容与关系图都不包含 part 路径，目标包据此重新定位等价闭包。 */
+        readonly rootHash: string;
+        readonly closureHash: string;
+    };
+}
+export interface ClipboardElementRecord {
+    readonly id: string;
+    readonly parent: string | null;
+    readonly src: SlideElement;
+    readonly meta: ElementClipboardRecordMeta;
+    readonly children: readonly string[];
+}
+export interface ClipboardResource {
+    readonly hash: string;
+    readonly mime: string;
+    readonly extension: string;
+    readonly bytes: string;
+}
+export interface ElementClipboardPayload {
+    readonly format: 'web-ppt-elements';
+    readonly version: 1;
+    readonly source: {
+        readonly width: number;
+        readonly height: number;
+        readonly copyBatchId: string;
+    };
+    readonly bounds: {
+        readonly left: number;
+        readonly top: number;
+    };
+    readonly roots: readonly string[];
+    readonly records: Readonly<Record<string, ClipboardElementRecord>>;
+    readonly ooxml: {
+        readonly roots: Readonly<Record<string, ClipboardXmlRoot>>;
+    };
+    readonly resources: readonly ClipboardResource[];
+}

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

@@ -0,0 +1,8 @@
+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;

package/dist/commands/dispatch.d.ts

@@ -0,0 +1,7 @@
+import type { EditDoc, ElementId } from '../types';
+import type { Command, CommandPatches } from './types';
+export declare function assertPureCommand(input: Command): void;
+/** 批处理冲突检测与命令注册共享目标语义；非法动态输入留给纯数据校验给出具体错误。 */
+export declare function commandTargetIds(command: Command): readonly ElementId[];
+export declare function commandSelectsInsertedElement(command: Command): boolean;
+export declare function commandPatches(doc: EditDoc, command: Command, origin: string): CommandPatches;

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

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

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

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

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

@@ -0,0 +1,5 @@
+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;

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

@@ -0,0 +1,5 @@
+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;

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

@@ -0,0 +1,17 @@
+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 assertImageResource(value: unknown, label: string, doc?: EditDoc): asserts value is ElementInsertionResource;
+/** 无来源溯源的背景只能是公开上传白名单，不能把包内扩展格式伪装成上传。 */
+export declare function assertUploadImageResource(resource: ElementInsertionResource, label: string): void;
+/** 一批远端资源不能把不同字节分配给同一目标；相同内容复用同一 part 是合法去重。 */
+export declare function assertImageResourceTargets(doc: EditDoc, resources: Readonly<Record<string, ElementInsertionResource>>): void;
+export declare function isElementCropPatch(patch: Patch): patch is ElementCropPatch;
+export declare function isElementImageReplacementPatch(patch: Patch): patch is ElementImageReplacementPatch;
+export declare function isImageResourcePatch(patch: Patch): patch is ImageResourcePatch;
+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 declare function applyElementImageReplacementPatch(doc: EditDoc, patch: ElementImageReplacementPatch): void;
+export declare function applyImageResourcePatch(doc: EditDoc, patch: ImageResourcePatch): void;

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

@@ -0,0 +1,11 @@
+import type { EditDoc, ElementId } from '../types';
+import type { CommandPatches, ElementInteractionPatch, SetElementHiddenCommand, SetLockedCommand } from './types';
+export declare function isElementInteractionPatch(patch: {
+    readonly path: readonly unknown[];
+}): patch is ElementInteractionPatch;
+export declare function validateElementInteractionPatch(doc: EditDoc, patch: ElementInteractionPatch, index: number): void;
+export declare function applyElementInteractionPatch(doc: EditDoc, patch: ElementInteractionPatch): void;
+export declare function setLockedPatches(doc: EditDoc, command: SetLockedCommand, origin: string): CommandPatches;
+export declare function setElementHiddenPatches(doc: EditDoc, command: SetElementHiddenCommand, origin: string): CommandPatches;
+export declare function elementHasLockedAncestor(doc: EditDoc, id: ElementId): boolean;
+export declare function assertElementUnlocked(doc: EditDoc, id: ElementId): void;

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

@@ -0,0 +1,5 @@
+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;

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

@@ -0,0 +1,8 @@
+import type { EditDoc } from '../types';
+import type { CommandPatches, ElementNamePatch, SetNameCommand } from './types';
+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 declare function setNamePatches(doc: EditDoc, command: SetNameCommand, origin: string): CommandPatches;

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

@@ -0,0 +1,7 @@
+import type { EditDoc } from '../types';
+import type { ElementOrderPatch, Patch } from './types';
+export declare function isElementOrderPatch(patch: Patch): patch is ElementOrderPatch;
+export declare function validateElementOrderPatch(doc: EditDoc, patch: ElementOrderPatch, index: number): void;
+export declare function validateElementOrderPatchSet(doc: EditDoc, patches: readonly Patch[]): void;
+export declare function applyElementOrderValue(doc: EditDoc, patch: ElementOrderPatch): string;
+export declare function applyElementOrderPatch(doc: EditDoc, patch: ElementOrderPatch): void;

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

@@ -0,0 +1,5 @@
+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;

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

@@ -0,0 +1,6 @@
+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 applyElementTextPatch(doc: EditDoc, patch: ElementTextPatch): void;

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

@@ -0,0 +1,5 @@
+import type { EditDoc } from '../types';
+import type { CommandPatches, ElementTransformPatch, 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;

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

@@ -0,0 +1,8 @@
+import type { EditDoc, ElementRecord } from '../types';
+import type { CommandPatches, ElementTreePatch, ElementTreeSnapshot, Patch, RemoveElementCommand } from './types';
+export declare function willRemoveElementStructure(record: ElementRecord | undefined): boolean;
+export declare function isElementTreePatch(patch: Patch): patch is ElementTreePatch;
+export declare function removeElementPatches(doc: EditDoc, command: RemoveElementCommand, origin: string): CommandPatches;
+export declare function validateElementTreePatch(doc: EditDoc, patch: ElementTreePatch, index: number): void;
+export declare function applyElementTreePatch(doc: EditDoc, patch: ElementTreePatch): void;
+export declare function elementTreeSlide(doc: EditDoc, snapshot: ElementTreeSnapshot): string;

package/dist/commands/fit-text-shape.d.ts

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

package/dist/commands/format-painter-types.d.ts

@@ -0,0 +1,17 @@
+import type { ElementId, TableCellAddress } from '../types';
+import type { TextRange } from './types';
+export declare const FORMAT_MASK_FIELDS: readonly ["fill", "stroke", "effects", "run", "paragraph", "body"];
+export type FormatMaskField = typeof FORMAT_MASK_FIELDS[number];
+export declare function assertFormatMask(value: unknown, label?: string): asserts value is readonly FormatMaskField[];
+export interface ApplyFormatCommand {
+    readonly type: 'ApplyFormat';
+    readonly from: ElementId;
+    readonly to: ElementId;
+    readonly mask: readonly FormatMaskField[];
+    readonly fromCell?: TableCellAddress;
+    readonly toCell?: TableCellAddress;
+    /** 省略表示整个来源文本体；只对 run/paragraph 生效。 */
+    readonly fromRange?: TextRange;
+    /** 省略表示整个目标文本体；只对 run/paragraph 生效。 */
+    readonly toRange?: TextRange;
+}

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

@@ -0,0 +1,7 @@
+export type SupportedImageMime = 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp';
+export declare function detectImageMime(bytes: Uint8Array): SupportedImageMime | null;
+export declare function validateImageFormat(bytes: Uint8Array, mime: unknown, command?: string): {
+    extension: string;
+};
+/** 模型资源还会复用 OPC 已有图片；它比上传白名单宽，但仍按字节验证真实容器。 */
+export declare function validateStoredImageFormat(bytes: Uint8Array, mime: unknown, extension: unknown, label: string, allowPackageSource?: boolean): boolean;

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

@@ -0,0 +1,4 @@
+import type { ClipboardResource } from './types';
+export declare const MAX_REPLACE_IMAGE_BYTES: number;
+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/insert-row.d.ts

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

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

@@ -0,0 +1,9 @@
+export interface InsertionRect {
+    readonly x: number;
+    readonly y: number;
+    readonly w: number;
+    readonly h: number;
+}
+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;

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

@@ -0,0 +1,4 @@
+import type { EditDoc } from '../types';
+import type { CommandPatches, PasteElementsCommand } from './types';
+/** 所有身份、树记录与位置先在内存中构造完毕，再作为一组结构 patch 原子落模。 */
+export declare function pasteElementsPatches(doc: EditDoc, command: PasteElementsCommand, origin: string): CommandPatches;

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

@@ -0,0 +1,18 @@
+import type { EditDoc, ElementInsertionRelationship, ElementInsertionResource } 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[];
+}
+/** 图片替换与剪贴板共用目标 part/关系分配，避免命令伪造一棵空剪贴板树。 */
+export declare function prepareMediaResourceClosure(doc: EditDoc, destinationPart: string, sourceId: string, type: string, source: Omit<ElementInsertionResource, 'targetPart' | 'created'>): 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?: {
+    readonly preverifiedResourceHashes?: ReadonlySet<string>;
+}): Map<string, PreparedInsertionClosure>;

package/dist/commands/patch.d.ts

@@ -0,0 +1,6 @@
+import type { EditDoc, ProjectionInvalidation } from '../types';
+import type { Patch } from './types';
+/** JSON/协同 seam：结构快照必须先在写时复制的完整模型上验真。 */
+export declare function applyPatches(doc: EditDoc, patches: readonly Patch[]): ProjectionInvalidation;
+/** 仅供同一事务内刚生成的命令 Patch；事务末尾由 Editor 统一校验完整模型。 */
+export declare function applyLocalPatches(doc: EditDoc, patches: readonly Patch[]): ProjectionInvalidation;

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

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

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

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

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

@@ -0,0 +1,5 @@
+import type { ReplaceTextCommand } from '../text-search-types';
+import type { EditDoc } from '../types';
+import type { CommandPatches } from './types';
+export declare function replaceTextTargetIds(doc: EditDoc, command: ReplaceTextCommand): readonly string[];
+export declare function replaceTextPatches(doc: EditDoc, command: ReplaceTextCommand, origin: string): CommandPatches;

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

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

package/dist/commands/set-body-props.d.ts

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

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

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

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

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

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

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

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

@@ -0,0 +1,4 @@
+import type { EditDoc } from '../types';
+import type { CommandPatches, SetFlipCommand } from './types';
+export declare const SET_FLIP_COMMAND_FIELDS: readonly ["h", "v"];
+export declare function setFlipPatches(doc: EditDoc, command: SetFlipCommand, origin: string): CommandPatches;

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

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

package/dist/commands/set-para-props.d.ts

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

package/dist/commands/set-run-props.d.ts

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

package/dist/commands/set-slide-properties.d.ts

@@ -0,0 +1,7 @@
+import type { EditDoc } from '../types';
+import type { CommandPatches, SetBackgroundCommand, SetBackgroundCropCommand, SetBackgroundImageCommand, SetHiddenCommand, SetTransitionCommand } from './types';
+export declare function setBackgroundPatches(doc: EditDoc, command: SetBackgroundCommand, origin: string): CommandPatches;
+export declare function setBackgroundImagePatches(doc: EditDoc, command: SetBackgroundImageCommand, origin: string): CommandPatches;
+export declare function setBackgroundCropPatches(doc: EditDoc, command: SetBackgroundCropCommand, origin: string): CommandPatches;
+export declare function setHiddenPatches(doc: EditDoc, command: SetHiddenCommand, origin: string): CommandPatches;
+export declare function setTransitionPatches(doc: EditDoc, command: SetTransitionCommand, origin: string): CommandPatches;

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

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

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

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

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

@@ -0,0 +1,5 @@
+import type { EditDoc } from '../types';
+import type { CommandPatches, SetZCommand } from './types';
+export declare function assertSetZCommand(doc: EditDoc, command: SetZCommand): import("..").ElementRecord;
+export declare function setZBatchPatches(doc: EditDoc, commands: readonly SetZCommand[], origin: string): CommandPatches;
+export declare function setZPatches(doc: EditDoc, command: SetZCommand, origin: string): CommandPatches;

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

@@ -0,0 +1,4 @@
+import type { ImageTile } from '@web-ppt/core';
+/** 命令入口与远端 patch 共用同一平铺边界，避免协同载荷绕过本地校验。 */
+export declare function normalizeSlideImageTile(value: unknown, label: string): ImageTile | undefined;
+export declare function normalizeSlideImageTilePlacement(value: unknown, label: string): ImageTile | undefined;

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

@@ -0,0 +1,8 @@
+import type { EditDoc } from '../types';
+import type { CommandPatches, SetLayoutCommand, SlideLayoutPatch } from './types';
+export declare function isSlideLayoutPatch(patch: {
+    readonly path: readonly unknown[];
+}): patch is SlideLayoutPatch;
+export declare function validateSlideLayoutPatch(doc: EditDoc, patch: SlideLayoutPatch, index: number): void;
+export declare function applySlideLayoutPatch(doc: EditDoc, patch: SlideLayoutPatch): void;
+export declare function setLayoutPatches(doc: EditDoc, command: SetLayoutCommand, origin: string): CommandPatches;

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

@@ -0,0 +1,8 @@
+import type { EditDoc } from '../types';
+import type { CommandPatches, SetNotesCommand, SlideNotesPatch } from './types';
+export declare function isSlideNotesPatch(patch: {
+    readonly path: readonly unknown[];
+}): patch is SlideNotesPatch;
+export declare function validateSlideNotesPatch(doc: EditDoc, patch: SlideNotesPatch, index: number): void;
+export declare function applySlideNotesPatch(doc: EditDoc, patch: SlideNotesPatch): void;
+export declare function setNotesPatches(doc: EditDoc, command: SetNotesCommand, origin: string): CommandPatches;

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

@@ -0,0 +1,7 @@
+import type { EditDoc } from '../types';
+import type { CommandPatches, MoveSlideCommand, Patch, SlideOrderPatch } from './types';
+export declare function isSlideOrderPatch(patch: Patch): patch is SlideOrderPatch;
+export declare function validateSlideOrderPatch(doc: EditDoc, patch: SlideOrderPatch, index: number): void;
+export declare function slideOrderPatchStart(doc: EditDoc, patch: SlideOrderPatch): number;
+export declare function applySlideOrderPatch(doc: EditDoc, patch: SlideOrderPatch): void;
+export declare function moveSlidePatches(doc: EditDoc, command: MoveSlideCommand, origin: string): CommandPatches;

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

@@ -0,0 +1,135 @@
+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 {
+    readonly type: 'SetBackground';
+    readonly id: SlideId;
+    /** null 恢复来源；显式无背景使用 { type: 'none' }。 */
+    readonly fill: Exclude<Fill, {
+        type: 'image';
+    }> | null;
+}
+export interface SetBackgroundImageCommand {
+    readonly type: 'SetBackgroundImage';
+    readonly id: SlideId;
+    readonly bytes: Uint8Array;
+    readonly mime: string;
+    readonly crop?: ImageCrop;
+    readonly alpha?: number;
+    /** 缺少 tile 表示拉伸铺满页面。 */
+    readonly tile?: ImageTilePlacement;
+}
+export interface SetBackgroundCropCommand {
+    readonly type: 'SetBackgroundCrop';
+    readonly id: SlideId;
+    /** null 只清除裁剪，仍保留当前图片背景。 */
+    readonly crop: ImageCrop | null;
+}
+export interface SetHiddenCommand {
+    readonly type: 'SetHidden';
+    readonly id: SlideId;
+    /** null 恢复来源；false 可覆盖来源隐藏页。 */
+    readonly v: boolean | null;
+}
+export interface SetTransitionCommand {
+    readonly type: 'SetTransition';
+    readonly id: SlideId;
+    /** null 恢复来源；type=none 明确关闭切换。 */
+    readonly t: SlideTransitionInput | null;
+}
+export interface SetAnimationsCommand {
+    readonly type: 'SetAnimations';
+    readonly slideId: SlideId;
+    /** null 恢复来源；空列表明确移除页面动画。 */
+    readonly steps: readonly EditAnimationStep[] | null;
+}
+export interface SetLayoutCommand {
+    readonly type: 'SetLayout';
+    readonly id: SlideId;
+    readonly layoutId: string;
+}
+export interface SetNotesCommand {
+    readonly type: 'SetNotes';
+    readonly id: SlideId;
+    readonly text: string;
+}
+export type SlideNotesPatch = {
+    readonly op: 'set';
+    readonly path: readonly ['slides', SlideId, 'ovr', 'notes'];
+    readonly value: string;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['slides', SlideId, 'ovr', 'notes'];
+    readonly origin: string;
+} | {
+    readonly op: 'set';
+    readonly path: readonly ['slides', SlideId, 'notes'];
+    readonly value: SlideNotesBinding;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['slides', SlideId, 'notes'];
+    readonly origin: string;
+};
+export type SlideLayoutPatch = {
+    readonly op: 'set';
+    readonly path: readonly ['slides', SlideId, 'layoutId'];
+    readonly value: string;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['slides', SlideId, 'layoutId'];
+    readonly origin: string;
+};
+export type SlideBackgroundPatch = {
+    readonly op: 'set';
+    readonly path: readonly ['slides', SlideId, 'ovr', 'background'];
+    readonly value: Fill;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['slides', SlideId, 'ovr', 'background'];
+    readonly origin: string;
+};
+export type SlideBackgroundImagePatch = {
+    readonly op: 'set';
+    readonly path: readonly ['slides', SlideId, 'backgroundImage'];
+    readonly value: SlideImageBackground;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['slides', SlideId, 'backgroundImage'];
+    readonly origin: string;
+};
+export type SlideHiddenPatch = {
+    readonly op: 'set';
+    readonly path: readonly ['slides', SlideId, 'ovr', 'hidden'];
+    readonly value: boolean;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['slides', SlideId, 'ovr', 'hidden'];
+    readonly origin: string;
+};
+export type SlideTransitionPatch = {
+    readonly op: 'set';
+    readonly path: readonly ['slides', SlideId, 'ovr', 'transition'];
+    readonly value: Transition;
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['slides', SlideId, 'ovr', 'transition'];
+    readonly origin: string;
+};
+export type SlideAnimationsPatch = {
+    readonly op: 'set';
+    readonly path: readonly ['slides', SlideId, 'ovr', 'animations'];
+    readonly value: readonly EditAnimationStep[];
+    readonly origin: string;
+} | {
+    readonly op: 'del';
+    readonly path: readonly ['slides', SlideId, 'ovr', 'animations'];
+    readonly origin: string;
+};
+export type SlidePropertyPatch = SlideBackgroundPatch | SlideBackgroundImagePatch | SlideHiddenPatch | SlideTransitionPatch | SlideAnimationsPatch;

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

@@ -0,0 +1,20 @@
+import { type Fill } from '@web-ppt/core';
+import type { EditDoc, ElementInsertionResource, SlideImageBackground, SlideRecord } from '../types';
+import type { Patch, SlideAnimationsPatch, SlideBackgroundImagePatch, SlideBackgroundPatch, SlideHiddenPatch, SlidePropertyPatch, SlideTransitionPatch } from './types';
+export declare const UPLOAD_BACKGROUND_SOURCE_ID = "rIdSlideBackground";
+export declare function assertSlideImageFill(value: unknown, label: string): asserts value is Extract<Fill, {
+    type: 'image';
+}>;
+export declare function assertSlideImageBackground(value: unknown, record: SlideRecord, resources: Readonly<Record<string, ElementInsertionResource>>, label: string, doc: EditDoc): asserts value is SlideImageBackground;
+/** sourceWidth/sourceHeight 不写入 OOXML；必须由同一图片与 DPI 重算，否则保存重开会跳变。 */
+export declare function assertSlideImageBackgroundDimensions(doc: EditDoc, record: SlideRecord, fill: Extract<Fill, {
+    type: 'image';
+}>, background: SlideImageBackground, resources: Readonly<Record<string, ElementInsertionResource>>, label: string): void;
+export declare function isSlideBackgroundPatch(patch: Patch): patch is SlideBackgroundPatch;
+export declare function isSlideHiddenPatch(patch: Patch): patch is SlideHiddenPatch;
+export declare function isSlideBackgroundImagePatch(patch: Patch): patch is SlideBackgroundImagePatch;
+export declare function isSlideTransitionPatch(patch: Patch): patch is SlideTransitionPatch;
+export declare function isSlideAnimationsPatch(patch: Patch): patch is SlideAnimationsPatch;
+export declare function isSlidePropertyPatch(patch: Patch): patch is SlidePropertyPatch;
+export declare function validateSlidePropertyPatch(doc: EditDoc, patch: SlidePropertyPatch, index: number, resources?: Readonly<Record<string, ElementInsertionResource>>): void;
+export declare function applySlidePropertyPatch(doc: EditDoc, patch: SlidePropertyPatch): void;

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

@@ -0,0 +1,6 @@
+import type { EditDoc } from '../types';
+import type { Patch, SlideChangeSets, SlideTreePatch } from './types';
+export declare function isSlideTreePatch(patch: Patch): patch is SlideTreePatch;
+export declare function validateSlideTreePatch(doc: EditDoc, patch: SlideTreePatch, index: number): void;
+export declare function applySlideTreePatch(doc: EditDoc, patch: SlideTreePatch): void;
+export declare function slidePatchSets(doc: EditDoc, patches: readonly Patch[]): SlideChangeSets;

package/dist/commands/spid.d.ts

@@ -0,0 +1,4 @@
+import type { EditDoc } from '../types';
+/** 来源 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-row.d.ts

@@ -0,0 +1,5 @@
+import type { EditDoc } from '../types';
+import type { Patch, TableRowPatch } from './types';
+export declare function isTableRowPatch(patch: Patch): patch is TableRowPatch;
+export declare function validateTableRowPatch(doc: EditDoc, patch: TableRowPatch, index: number): void;
+export declare function applyTableRowPatch(doc: EditDoc, patch: TableRowPatch): void;