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

package/dist/retained-element-origins.d.ts

@@ -0,0 +1,6 @@
+import type { EditDoc, ElementRecord } from './types';
+/** 从当前活树保留身份，不信任删除快照中的旧覆盖；旧恢复日志也经过同一入口。 */
+export declare function retainElementOrigins(doc: EditDoc, records: Iterable<ElementRecord>): void;
+/** 恢复后的活树重新提供身份；不让多次撤销留下另一份常驻索引。 */
+export declare function restoreElementOrigins(doc: EditDoc, records: Iterable<ElementRecord>): void;
+export declare function assertRetainedElementOrigins(doc: EditDoc): void;

package/dist/run-property-fields.d.ts

@@ -0,0 +1,12 @@
+/** 字符格式的唯一字段注册表；校验、投影、重基与保存均从这里派生。 */
+export declare const STYLE_PROPERTY_FIELDS: readonly ["font", "size", "color", "b", "i", "underline", "strikeType", "highlight", "spacing", "caps", "baseline"];
+export type StylePropertyField = typeof STYLE_PROPERTY_FIELDS[number];
+export type DirectRunField = Exclude<StylePropertyField, 'font'> | 'u' | 'strike';
+export declare const RUN_STYLE_DIRECT_FIELDS: readonly (readonly [Exclude<StylePropertyField, "font">, number])[];
+export declare const RUN_DIRECT_FIELDS: readonly [...(readonly ["size" | "color" | "b" | "i" | "underline" | "strikeType" | "highlight" | "spacing" | "caps" | "baseline", number])[], readonly ["u", number], readonly ["strike", number]];
+export declare const RUN_REBASE_FIELDS: ("u" | "size" | "color" | "b" | "i" | "strike" | "underline" | "strikeType" | "highlight" | "spacing" | "caps" | "baseline")[];
+export declare const RUN_PROPERTY_FIELDS: readonly ["font", "size", "color", "b", "i", "underline", "strikeType", "highlight", "spacing", "caps", "baseline", "u", "strike", "link"];
+export declare const FONT_DIRECT_BITS: number;
+export declare const FONT_OVERRIDE_BIT: number;
+export declare function directRunBit(field: DirectRunField): number;
+export declare const LAYOUT_RUN_DIRECT_FIELDS: readonly [...(readonly ["size" | "color" | "b" | "i" | "underline" | "strikeType" | "highlight" | "spacing" | "caps" | "baseline", number])[], readonly ["u", number], readonly ["strike", number], readonly ["outline", number], readonly ["gradient", number], readonly ["underlineColor", number]];

package/dist/run-property-schema.d.ts

@@ -1,3 +1,5 @@
+import { TEXT_CAPS_STYLES, TEXT_STRIKE_STYLES, TEXT_UNDERLINE_STYLES } from '@web-ppt/core';
 import type { RunPropertyOverrides } from './types';
-export declare const RUN_PROPERTY_FIELDS: readonly ["font", "size", "color", "b", "i", "u", "strike", "link"];
+export { RUN_PROPERTY_FIELDS } from './run-property-fields';
+export { TEXT_CAPS_STYLES, TEXT_STRIKE_STYLES, TEXT_UNDERLINE_STYLES };
 export declare function assertRunPropertyOverrides(value: unknown, label: string, allowEmpty?: boolean): asserts value is RunPropertyOverrides;

package/dist/run-style.d.ts

@@ -0,0 +1,15 @@
+import type { TextRun, TextStrikeStyle, TextUnderlineStyle } from '@web-ppt/core';
+import type { RunProperties, RunPropertyOverrides, TextMark } from './types';
+export { STYLE_PROPERTY_FIELDS } from './run-property-fields';
+export declare const underlineOf: (run: Pick<TextRun, "u" | "underline">) => TextUnderlineStyle;
+export declare const strikeTypeOf: (run: Pick<TextRun, "strike" | "strikeType">) => TextStrikeStyle;
+export declare function runProperties(run: Omit<TextRun, 'text'>): RunProperties;
+export declare const DEFAULT_RUN: Omit<TextRun, 'text'>;
+export declare const DEFAULT_PROPERTIES: RunProperties;
+/** DrawingML 没有 highlight="none"；透明直设用于覆盖版式/母版的继承高亮。 */
+export declare const NO_HIGHLIGHT = "rgba(0,0,0,0)";
+export declare function visibleHighlight(value: string | null | undefined): string | null;
+export declare function sameRunOverrides(left?: RunPropertyOverrides, right?: RunPropertyOverrides): boolean;
+export declare function sameInherited(left?: RunProperties, right?: RunProperties): boolean;
+export declare function formattedMark(mark: TextMark, input: RunPropertyOverrides): TextMark;
+export declare function clearedMark(mark: TextMark): TextMark;

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

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

package/dist/save/comments.d.ts

@@ -0,0 +1,3 @@
+import type { EditDoc, SlideRecord } from '../types';
+/** 每页拥有自己的批注 part；不能像图片那样共享，否则副本与原页会成为同一组批注。 */
+export declare function materializeDuplicateComments(doc: EditDoc, slides: readonly SlideRecord[], baselines: Record<string, Uint8Array>, created: Set<string>, changes: Record<string, Uint8Array | null>): void;

package/dist/save/effects.d.ts

@@ -1,6 +1,7 @@
 import type { Effects } from '@web-ppt/core';
 import type { ElementRecord } from '../types';
-import type { XmlDocument } from '../xml/types';
+import type { XmlDocument, XmlElement } from '../xml/types';
+export declare function appendShadow(list: XmlElement, shadow: NonNullable<Effects['shadow']>): void;
 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/extension-availability.d.ts

@@ -0,0 +1,3 @@
+import type { EditDoc } from '../types';
+/** 生成与补丁保存共用扩展可用性门禁，恢复后不能静默丢弃尚未加载的覆盖。 */
+export declare function assertSaveExtensions(doc: EditDoc): void;

package/dist/save/extension-elements.d.ts

@@ -0,0 +1,26 @@
+import type { SlideElement } from '@web-ppt/core';
+import type { ElementRecord } from '../types';
+import type { XmlDocument } from '../xml/types';
+import { findXmlChild, xmlElementChildren } from '../xml/query';
+import { removeXmlChild, insertXmlChildUnchecked } from '../xml/nodes';
+import { setXmlAttribute } from '../xml/mutate';
+import { insertXmlInOrder } from '../xml/order';
+import { locateElementHost } from './xfrm';
+import { namespacedElement } from './xml-element';
+import { appendDrawingColor } from './drawing-color';
+declare const xml: {
+    findXmlChild: typeof findXmlChild;
+    xmlElementChildren: typeof xmlElementChildren;
+    removeXmlChild: typeof removeXmlChild;
+    insertXmlChildUnchecked: typeof insertXmlChildUnchecked;
+    setXmlAttribute: typeof setXmlAttribute;
+    insertXmlInOrder: typeof insertXmlInOrder;
+    locateElementHost: typeof locateElementHost;
+    namespacedElement: typeof namespacedElement;
+    appendDrawingColor: typeof appendDrawingColor;
+};
+export type EditElementXml = typeof xml;
+export declare function hasElementExtensionOverrides(record: ElementRecord): boolean;
+export declare function materializeElementExtensions(tree: XmlDocument, record: ElementRecord, generated: boolean): void;
+export declare function extensionSupportsGenerated(element: SlideElement): boolean;
+export {};

package/dist/save/index.d.ts

@@ -1,5 +1,10 @@
 import type { OpcPatchResult } from '../opc/types';
 import type { EditDoc } from '../types';
+import type { EditExtensionSavePlan } from '../extension-runtime';
+/** 编辑器入口延迟到首次保存才加载扩展保存聚合器。 */
+export declare function saveEditDocWithExtensions(doc: EditDoc): Promise<OpcPatchResult>;
+/** 字节生成不代表交付成功；宿主负责确认保存点和释放独立生成的结果包。 */
+export declare function serializeEditDoc(doc: EditDoc): Promise<OpcPatchResult>;
 /** 始终从首次触碰的基线重建 part，避免连续保存把旧覆盖烘进源树而破坏撤销。 */
-export declare function saveEditDoc(doc: EditDoc): OpcPatchResult;
+export declare function saveEditDoc(doc: EditDoc, extensionPlan?: EditExtensionSavePlan): OpcPatchResult;
 export type { OpcFallbackReason, OpcPatchResult, OpcSaveMode } from '../opc/types';

package/dist/save/insertion.d.ts

@@ -4,14 +4,15 @@ 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>;
-    skipReparents?: boolean;
+    skipReparents?: ReadonlySet<string>;
     scope?: ReadonlySet<string>;
     links?: HyperlinkSaveContext;
+    sourceOnly?: boolean;
 }): void;
 /** 从来源基线构造当前有效元素树，供复制原始宿主及其所有后代。 */
-export declare function materializeElementRoots(doc: EditDoc, roots: readonly ElementRecord[], source: Uint8Array): XmlDocument;
-export declare function materializeInsertionFragment(doc: EditDoc, record: ElementRecord): XmlDocument;
+export declare function materializeElementRoots(doc: EditDoc, roots: readonly ElementRecord[], source: Uint8Array, sourceOnly?: boolean): XmlDocument;
+export declare function materializeInsertionFragment(doc: EditDoc, record: ElementRecord, sourceOnly?: boolean): XmlDocument;
 /** 新宿主先进入目标树，后续变换与层级补丁才能继续复用统一的 spid 定位。 */
-export declare function patchInsertedElements(document: XmlDocument, doc: EditDoc, records: readonly ElementRecord[], skip?: ReadonlySet<string>): Set<string>;
+export declare function patchInsertedElements(document: XmlDocument, doc: EditDoc, records: readonly ElementRecord[], skip?: ReadonlySet<string>, sourceOnly?: boolean): Set<string>;
 /** 层级编辑移动原宿主本身，未知扩展、关系引用与 spid 因此都不需要重建。 */
-export declare function patchReparentedElements(document: XmlDocument, doc: EditDoc, records: readonly ElementRecord[]): void;
+export declare function patchReparentedElements(document: XmlDocument, doc: EditDoc, records: readonly ElementRecord[], skip?: ReadonlySet<string>): void;

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

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

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

@@ -0,0 +1,5 @@
+import type { MasterRecord } from '../types';
+import type { XmlDocument } from '../xml/types';
+export declare function hasMasterPropertyOverrides(record: MasterRecord): boolean;
+/** 只触碰 cSld/bg 与 txStyles；hf、clrMap、extLst 以及未知扩展原位保留。 */
+export declare function patchMasterProperties(document: XmlDocument, record: MasterRecord): void;

package/dist/save/paragraph-overrides.d.ts

@@ -0,0 +1,3 @@
+import type { FlatTextParagraph } from '../types';
+import type { XmlElement } from '../xml/types';
+export declare function applyParagraphOverrides(properties: XmlElement, paragraph: FlatTextParagraph, lnSpcReduction: number): void;

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

@@ -6,6 +6,7 @@ export declare function createdSlideRelationships(slide: SlideRecord, source?: U
 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 patchGeneratedPresentationMetadata(source: Uint8Array, doc: EditDoc): 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/table.d.ts

@@ -1,9 +1,11 @@
 import type { ElementRecord } from '../types';
 import type { XmlDocument } from '../xml/types';
 export declare function hasTableRowOverrides(record: ElementRecord): boolean;
+export declare function hasTableCellAppearanceOverrides(record: ElementRecord): boolean;
 export declare function hasTableStyleOverride(record: ElementRecord): boolean;
 /** tblPr 只保存六个开关与 styleId；单元格直接格式继续原位直通。 */
 export declare function patchTableStyle(document: XmlDocument, record: ElementRecord): void;
+export declare function patchTableCellAppearances(document: XmlDocument, record: ElementRecord): void;
 /** 从首次触碰基线重建，连续保存不会重复烘入相同行。 */
 export declare function patchTableRows(document: XmlDocument, record: ElementRecord): void;
 /** frame 与内部网格必须同生共变；Office 不会替编辑模型猜测各行列的新整数尺寸。 */

package/dist/save/xfrm.d.ts

@@ -7,13 +7,19 @@ export interface HostSpec {
     readonly properties: string | null;
     readonly frame: boolean;
 }
-export interface LocatedHost {
+export interface HostVariant {
     host: XmlElement;
-    parent: XmlElement;
     spec: HostSpec;
 }
+export interface LocatedHost extends HostVariant {
+    parent: XmlElement;
+    /** 兼容对象只有一个层级宿主，但每个分支都有自己的可写框架。 */
+    variants?: readonly HostVariant[];
+}
 /** 批量定位同一 part 的宿主只遍历 XML 一次，避免大页层级保存退化为节点数平方。 */
 export declare function locateElementHosts(document: XmlDocument, records: readonly Pick<ElementRecord, 'id' | 'meta'>[]): Map<string, LocatedHost>;
+export declare function elementHostVariants(document: XmlDocument, record: Pick<ElementRecord, 'id' | 'meta'>): readonly HostVariant[];
+export declare function elementNonVisualProperties(document: XmlDocument, record: Pick<ElementRecord, 'id' | 'meta'>): XmlElement[];
 export declare function locateElementHost(document: XmlDocument, record: Pick<ElementRecord, 'id' | 'meta'>): LocatedHost;
 export declare function hasXfrmOverrides(record: ElementRecord): boolean;
 /** 把一个元素的显式覆盖写到自己的宿主变换节点，不读取或改写框架内部内容。 */