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

package/dist/save/duplicate-slide-parts.d.ts

@@ -0,0 +1,15 @@
+import type { EditDoc, RemovedElementRecord, SlideRecord } from '../types';
+export interface DuplicateNotesParts {
+    readonly slidePart: string;
+    readonly sourcePart: string;
+    readonly targetPart: string;
+}
+export declare function duplicateSlideSource(doc: EditDoc, slide: SlideRecord, baselines: Readonly<Record<string, Uint8Array>>): Uint8Array | undefined;
+export declare function duplicateRelationshipSource(doc: EditDoc, slide: SlideRecord, baselines: Readonly<Record<string, Uint8Array>>): Uint8Array | undefined;
+export declare function duplicateSlideRemovals(slide: SlideRecord): RemovedElementRecord[];
+export declare function duplicateNotesParts(slides: readonly SlideRecord[]): DuplicateNotesParts[];
+export declare function patchDuplicateSlideRelationships(source: Uint8Array, notes: DuplicateNotesParts | undefined): Uint8Array;
+export declare function cloneDuplicateNotesParts(doc: EditDoc, baselines: Readonly<Record<string, Uint8Array>>, notes: DuplicateNotesParts): {
+    notes: Uint8Array;
+    relationships: Uint8Array;
+};

package/dist/save/effects.d.ts

@@ -0,0 +1,6 @@
+import type { Effects } from '@web-ppt/core';
+import type { ElementRecord } from '../types';
+import type { XmlDocument } from '../xml/types';
+export declare function hasEffectsOverride(record: ElementRecord): boolean;
+export declare function materializeElementEffects(document: XmlDocument, record: ElementRecord, effects: Effects): void;
+export declare function patchElementEffects(document: XmlDocument, record: ElementRecord): void;

package/dist/save/hyperlink.d.ts

@@ -0,0 +1,18 @@
+import type { EditDoc, ElementInsertionRelationship, ElementRecord, LinkOverride, LinkTarget } from '../types';
+import type { XmlDocument, XmlElement } from '../xml/types';
+export declare const HYPERLINK_RELATIONSHIP = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink";
+export declare const SLIDE_RELATIONSHIP = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide";
+export interface HyperlinkSaveContext {
+    readonly sourcePart: string;
+    relationId(target: LinkTarget): string | null;
+    retireRelationship(id: string): void;
+    retiredRelationshipIds(): ReadonlySet<string>;
+    removeDanglingHyperlinks(document: XmlDocument): void;
+    generatedRelationships(): readonly ElementInsertionRelationship[];
+}
+export declare function hasDanglingSlideRelationships(doc: EditDoc, sourcePart: string, source: Uint8Array | undefined): boolean;
+export declare function createHyperlinkSaveContext(doc: EditDoc, sourcePart: string, source: Uint8Array | undefined, additions: readonly ElementInsertionRelationship[]): HyperlinkSaveContext;
+export declare function hasHyperlinkOverrides(record: ElementRecord): boolean;
+export declare function patchHyperlinkNode(parent: XmlElement, override: LinkOverride, context: HyperlinkSaveContext): void;
+export declare function patchElementHyperlink(document: XmlDocument, record: ElementRecord, context: HyperlinkSaveContext): void;
+export declare function patchHyperlinkRelationshipPart(source: Uint8Array | undefined, additions: readonly ElementInsertionRelationship[], context: HyperlinkSaveContext, slideBytes: Uint8Array): Uint8Array;

package/dist/save/image-content.d.ts

@@ -0,0 +1,4 @@
+import type { ElementRecord } from '../types';
+import type { XmlDocument } from '../xml/types';
+export declare function hasImageContentOverrides(record: ElementRecord): boolean;
+export declare function patchElementImageContent(document: XmlDocument, record: ElementRecord): void;

package/dist/save/index.d.ts

@@ -0,0 +1,5 @@
+import type { OpcPatchResult } from '../opc/types';
+import type { EditDoc } from '../types';
+/** 始终从首次触碰的基线重建 part，避免连续保存把旧覆盖烘进源树而破坏撤销。 */
+export declare function saveEditDoc(doc: EditDoc): OpcPatchResult;
+export type { OpcFallbackReason, OpcPatchResult, OpcSaveMode } from '../opc/types';

package/dist/save/insertion.d.ts

@@ -0,0 +1,14 @@
+import type { XmlDocument } from '../xml/types';
+import type { EditDoc, ElementRecord, RemovedElementRecord } from '../types';
+import type { HyperlinkSaveContext } from './hyperlink';
+/** 删除、插入、覆盖的先后顺序与整页保存一致；复制片段也复用这一条物化路径。 */
+export declare function materializeElementTreeState(document: XmlDocument, doc: EditDoc, part: string, records: readonly ElementRecord[], removals: readonly RemovedElementRecord[], options?: {
+    skipInsertions?: ReadonlySet<string>;
+    scope?: ReadonlySet<string>;
+    links?: HyperlinkSaveContext;
+}): void;
+/** 从来源基线构造当前有效元素树，供复制原始宿主及其所有后代。 */
+export declare function materializeElementRoots(doc: EditDoc, roots: readonly ElementRecord[], source: Uint8Array): XmlDocument;
+export declare function materializeInsertionFragment(doc: EditDoc, record: ElementRecord): XmlDocument;
+/** 新宿主先进入目标树，后续变换与层级补丁才能继续复用统一的 spid 定位。 */
+export declare function patchInsertedElements(document: XmlDocument, doc: EditDoc, records: readonly ElementRecord[], skip?: ReadonlySet<string>): Set<string>;

package/dist/save/layout-fallback-source.d.ts

@@ -0,0 +1,4 @@
+import type { EditDoc, ElementRecord, SlideRecord } from '../types';
+import type { XmlElement } from '../xml/types';
+/** 保存期间按 part 缓存保留型 XML；继承 custGeom 复制公式树，而不是从烘焙 path 反推。 */
+export declare function createLayoutFallbackGeometryResolver(doc: EditDoc): (slide: SlideRecord, record: ElementRecord) => XmlElement | undefined;

package/dist/save/layout-fallback.d.ts

@@ -0,0 +1,7 @@
+import type { GeomSpec, SlideElement } from '@web-ppt/core';
+import type { XmlDocument, XmlElement } from '../xml/types';
+import type { ElementRecord } from '../types';
+/**
+ * 目标版式没有对应占位符时，只固定原来由旧版式继承的字段；页面本来直设的 XML 必须逐字保留。
+ */
+export declare function materializeLayoutFallback(document: XmlDocument, record: ElementRecord, effective: SlideElement, geom: GeomSpec | undefined, sourceGeometry?: XmlElement): void;

package/dist/save/materialize.d.ts

@@ -0,0 +1,5 @@
+import type { EditDoc, ElementRecord } from '../types';
+import type { XmlDocument } from '../xml/types';
+import type { HyperlinkSaveContext } from './hyperlink';
+/** 插入片段与整页保存必须经过同一条覆盖物化管线，避免二次复制丢失编辑。 */
+export declare function materializeElementOverrides(document: XmlDocument, doc: EditDoc, part: string, records: readonly ElementRecord[], scope?: ReadonlySet<string>, structuralContentAlreadyMaterialized?: ReadonlySet<string>, links?: HyperlinkSaveContext): void;

package/dist/save/name.d.ts

@@ -0,0 +1,5 @@
+import type { ElementRecord } from '../types';
+import type { XmlDocument } from '../xml/types';
+export declare function hasNameOverride(record: ElementRecord): boolean;
+/** 名称只落在宿主 cNvPr；不重建 non-visual 树，避免碰未知扩展与锁定节点。 */
+export declare function patchElementName(document: XmlDocument, record: ElementRecord): void;

package/dist/save/notes.d.ts

@@ -0,0 +1,12 @@
+import type { EditDoc, SlideRecord } from '../types';
+/** 只替换 body 占位符段落；其它形状、关系、扩展和文本格式保持原树。 */
+export declare function patchNotesText(source: Uint8Array, value: string): Uint8Array;
+/** 备注关系属于页面元数据；只重定向指定 rId，不能重建整个关系 part。 */
+export declare function patchSlideNotesRelationship(slide: SlideRecord, source?: Uint8Array): Uint8Array;
+export interface NotesSavePlan {
+    readonly relationshipSlides: Map<string, SlideRecord>;
+    readonly trackedParts: Set<string>;
+}
+/** 捕获第一次触碰的基线，并把会话创建的 notes part 纳入可撤销生命周期。 */
+export declare function prepareNotesSave(doc: EditDoc, baselines: Record<string, Uint8Array>, createdParts: Set<string>): NotesSavePlan;
+export declare function materializeNotesParts(doc: EditDoc, baselines: Readonly<Record<string, Uint8Array>>, plan: NotesSavePlan, changes: Record<string, Uint8Array | null>): void;

package/dist/save/order.d.ts

@@ -0,0 +1,5 @@
+import type { EditDoc, ElementRecord } from '../types';
+import type { XmlDocument } from '../xml/types';
+export declare function hasOrderOverride(record: ElementRecord): boolean;
+/** 同一父级只执行一次宿主重排；未知节点与只读投影占据的 XML 槽位不会被搬动。 */
+export declare function patchElementOrders(document: XmlDocument, doc: EditDoc, part: string, scope?: ReadonlySet<string>): void;

package/dist/save/remove-element.d.ts

@@ -0,0 +1,4 @@
+import type { RemovedElementRecord } from '../types';
+import type { XmlDocument } from '../xml/types';
+/** 删除宿主节点但不碰 rels 或媒体；共享资源只能在保存期可达性分析后回收。 */
+export declare function patchRemovedElement(document: XmlDocument, record: RemovedElementRecord): void;

package/dist/save/remove-slide-parts.d.ts

@@ -0,0 +1,11 @@
+import type { EditDoc } from '../types';
+export interface RemovedSlidePackageParts {
+    readonly slideParts: ReadonlySet<string>;
+    readonly packageParts: ReadonlySet<string>;
+    readonly contentTypeParts: ReadonlySet<string>;
+}
+export declare function removedSlidePartNames(doc: EditDoc, knownCreatedParts?: ReadonlySet<string>): Set<string>;
+/** 保存后撤销尚未写回时，只有缺失来源页及其 notes 闭包可由基线暂时托管。 */
+export declare function detachedSlideBaselineParts(doc: EditDoc): Set<string>;
+/** 只清理页面拥有的 OPC 身份；关系目标默认保留，notes 仅在没有活动页引用时删除。 */
+export declare function removedSlidePackageParts(doc: EditDoc, knownCreatedParts: ReadonlySet<string>): RemovedSlidePackageParts;

package/dist/save/shape-format.d.ts

@@ -0,0 +1,14 @@
+import type { Fill, Stroke } from '@web-ppt/core';
+import type { ElementRecord } from '../types';
+import type { XmlDocument, XmlElement } from '../xml/types';
+export declare function appendVectorFill(properties: XmlElement, fill: Exclude<Fill, {
+    type: 'image';
+}>): void;
+export declare function removeDrawingFillChildren(properties: XmlElement): void;
+/** 目标版式不再提供占位符时，把旧版式的有效矢量填充固定到页面宿主。 */
+export declare function materializeElementFill(document: XmlDocument, record: ElementRecord, fill: Exclude<Fill, {
+    type: 'image';
+}> | null): void;
+export declare function materializeElementStroke(document: XmlDocument, record: ElementRecord, stroke: Stroke | null): void;
+export declare function hasShapeFormatOverrides(record: ElementRecord): boolean;
+export declare function patchElementShapeFormat(document: XmlDocument, record: ElementRecord): void;

package/dist/save/slide-parts.d.ts

@@ -0,0 +1,11 @@
+import type { EditDoc, SlideRecord } from '../types';
+export declare function createdSlides(doc: EditDoc): SlideRecord[];
+export declare function emptySlideXml(): Uint8Array;
+export declare function createdSlideRelationships(slide: SlideRecord, source?: Uint8Array): Uint8Array;
+/** 复用既有 rId，只改内部 Target；未知关系、属性与顺序均留在原树。 */
+export declare function patchSlideLayoutRelationship(slide: SlideRecord, source?: Uint8Array): Uint8Array;
+/** PowerPoint 会重算字段，LibreOffice 不一定；只刷新 a:fld 的缓存文字，不降级成普通 run。 */
+export declare function patchSlideNumberFields(source: Uint8Array, slideNumber: number): Uint8Array;
+export declare function patchPresentationSlides(source: Uint8Array, relationships: Uint8Array, doc: EditDoc): Uint8Array;
+export declare function patchPresentationRelationships(source: Uint8Array, doc: EditDoc): Uint8Array;
+export declare function patchSlideContentTypes(source: Uint8Array, doc: EditDoc, removedParts?: ReadonlySet<string>): Uint8Array;

package/dist/save/slide-properties.d.ts

@@ -0,0 +1,4 @@
+import type { EditDoc, SlideRecord } from '../types';
+import type { XmlDocument } from '../xml/types';
+export declare function hasSlidePropertyOverrides(record: SlideRecord): boolean;
+export declare function patchSlideProperties(document: XmlDocument, doc: EditDoc, record: SlideRecord): void;

package/dist/save/table.d.ts

@@ -0,0 +1,7 @@
+import type { ElementRecord } from '../types';
+import type { XmlDocument } from '../xml/types';
+export declare function hasTableRowOverrides(record: ElementRecord): boolean;
+/** 从首次触碰基线重建，连续保存不会重复烘入相同行。 */
+export declare function patchTableRows(document: XmlDocument, record: ElementRecord): void;
+/** frame 与内部网格必须同生共变；Office 不会替编辑模型猜测各行列的新整数尺寸。 */
+export declare function patchTableGeometry(document: XmlDocument, record: ElementRecord): void;

package/dist/save/text-body.d.ts

@@ -0,0 +1,4 @@
+import type { TextBodyPropertyOverrides } from '../types';
+import type { XmlElement } from '../xml/types';
+/** 只改用户触碰的 bodyPr 字段；null 删除本层声明，让 OOXML 继承链重新生效。 */
+export declare function patchTextBodyProperties(bodyPr: XmlElement, overrides: TextBodyPropertyOverrides | undefined): void;

package/dist/save/text.d.ts

@@ -0,0 +1,6 @@
+import type { ElementRecord } from '../types';
+import type { XmlDocument } from '../xml/types';
+import type { HyperlinkSaveContext } from './hyperlink';
+export declare function hasTextOverrides(record: ElementRecord): boolean;
+/** 形状与表格只在宿主定位上不同，段落保留算法必须共用。 */
+export declare function patchElementText(document: XmlDocument, record: ElementRecord, links?: HyperlinkSaveContext): void;

package/dist/save/transition.d.ts

@@ -0,0 +1,4 @@
+import type { Transition } from '@web-ppt/core';
+import type { XmlDocument } from '../xml/types';
+/** 只替换 transition 自己占据的 schema 槽位；无关 MCE、timing 与扩展原地保留。 */
+export declare function patchSlideTransition(document: XmlDocument, value: Transition, blockInherited?: boolean): void;

package/dist/save/xfrm.d.ts

@@ -0,0 +1,22 @@
+import type { SlideElement } from '@web-ppt/core';
+import type { ElementRecord } from '../types';
+import type { XmlDocument, XmlElement } from '../xml/types';
+export interface HostSpec {
+    readonly namespaceUri: string;
+    readonly nonVisual: string;
+    readonly properties: string | null;
+    readonly frame: boolean;
+}
+export interface LocatedHost {
+    host: XmlElement;
+    parent: XmlElement;
+    spec: HostSpec;
+}
+/** 批量定位同一 part 的宿主只遍历 XML 一次，避免大页层级保存退化为节点数平方。 */
+export declare function locateElementHosts(document: XmlDocument, records: readonly Pick<ElementRecord, 'id' | 'meta'>[]): Map<string, LocatedHost>;
+export declare function locateElementHost(document: XmlDocument, record: Pick<ElementRecord, 'id' | 'meta'>): LocatedHost;
+export declare function hasXfrmOverrides(record: ElementRecord): boolean;
+/** 把一个元素的显式覆盖写到自己的宿主变换节点，不读取或改写框架内部内容。 */
+export declare function patchElementXfrm(document: XmlDocument, record: ElementRecord): void;
+/** 版式目标缺失时写入完整有效 frame，使 Office 重开不再依赖已经断开的旧版式宿主。 */
+export declare function materializeElementXfrm(document: XmlDocument, record: ElementRecord, effective: SlideElement): void;

package/dist/save/xml-element.d.ts

@@ -0,0 +1,3 @@
+import type { XmlElement } from '../xml/types';
+/** 沿用源 part 已绑定的前缀；没有绑定时才为新命名空间声明稳定前缀。 */
+export declare function namespacedElement(parent: XmlElement, namespaceUri: string, localName: string): XmlElement;