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

package/dist/editor.d.ts

@@ -1,4 +1,4 @@
-import type { Command, EditorChange, EditorOptions, EditorSubscriber, History, Selection, Transaction, TransactionOptions, TransactionResult } from './commands/types';
+import type { Command, EditorChange, EditorOptions, EditorPatchSubscriber, EditorPatchSubscribeOptions, EditorSubscriber, ExternalPatchOptions, History, Patch, Selection, Transaction, TransactionOptions, TransactionResult } from './commands/types';
 import type { OpcPatchResult } from './opc/types';
 import type { RecoverySubscriber } from './recovery-types';
 import type { EditDoc, ElementId, SlideId } from './types';
@@ -8,6 +8,7 @@ export declare class Editor {
     private readonly historyStore;
     private readonly origin;
     private readonly subscribers;
+    private readonly patchJournal;
     private readonly recoveryJournal;
     private currentSelection;
     private currentState;
@@ -23,14 +24,18 @@ export declare class Editor {
     select(selection: Selection): void;
     subscribe(subscriber: EditorSubscriber): () => void;
     subscribeRecovery(subscriber: RecoverySubscriber): () => void;
+    subscribePatches(subscriber: EditorPatchSubscriber, options?: EditorPatchSubscribeOptions): () => void;
     exec(...commands: Command[]): TransactionResult;
     transaction(callback: (transaction: Transaction) => void, label: string, options?: TransactionOptions): TransactionResult;
     undo(): EditorChange | null;
     redo(): EditorChange | null;
+    applyExternalPatches(patches: readonly Patch[], options?: ExternalPatchOptions): EditorChange | null;
     toSlide(id: SlideId): import("@web-ppt/core").Slide;
     effectiveElement(id: ElementId): import("@web-ppt/core").SlideElement;
     private commit;
     private emitRecovery;
+    private queuePatches;
+    private flushPatches;
     private emit;
     private refreshActiveImageResources;
     private historyImageResourceBytes;

package/dist/generate/custom-geometry.d.ts

@@ -0,0 +1,2 @@
+/** core 的无损路径是绝对 M/L/C/Q/A/Z；这里反向写成等比例 DrawingML custGeom。 */
+export declare function customGeometryMarkup(path: string, width: number, height: number, open: boolean): string;

package/dist/generate/index.d.ts

@@ -0,0 +1,12 @@
+import type { OpcPatchResult } from '../opc/types';
+import type { EditDoc } from '../types';
+export interface CreateBlankPptxOptions {
+    /** 页面单位与统一 Schema 一致，使用 CSS px；默认值等价于 12192000×6858000 EMU。 */
+    readonly width?: number;
+    readonly height?: number;
+}
+/** 创建带一张空白页、最小主题/母版及常用版式目录的确定性 PPTX。 */
+export declare function createBlankPptx(options?: CreateBlankPptxOptions): Uint8Array;
+/** 没有可补丁原包时从统一编辑模型构造新 PPTX；本函数不改变 EditDoc。 */
+export declare function generateEditDoc(doc: EditDoc): OpcPatchResult;
+export type { OpcPatchResult } from '../opc/types';

package/dist/generate/links.d.ts

@@ -0,0 +1,3 @@
+import type { EditDoc, LinkOverride, SlideId } from '../types';
+/** 相对跳转在生成包里固定到当前最终页序，避免依赖已经不存在的来源关系。 */
+export declare function generatedLink(doc: EditDoc, slideId: SlideId, value: string | undefined, label: string): LinkOverride | undefined;

package/dist/generate/materialize.d.ts

@@ -0,0 +1,2 @@
+import type { EditDoc } from '../types';
+export declare function materializeGeneratedParts(doc: EditDoc): Record<string, Uint8Array>;

package/dist/generate/media.d.ts

@@ -0,0 +1,13 @@
+import type { EditDoc, ElementInsertionRelationship, ElementInsertionResource, ElementInsertionSource, ElementRecord } from '../types';
+type ImageSource = {
+    readonly src: string;
+    readonly name?: string;
+    readonly id?: number;
+};
+export interface GeneratedImageClosure {
+    readonly relationship: ElementInsertionRelationship;
+    readonly resource: ElementInsertionResource | null;
+}
+export declare function imageClosure(doc: EditDoc, source: ImageSource, relationshipId: string, part: string): GeneratedImageClosure;
+export declare function imageInsertion(doc: EditDoc, record: ElementRecord, spid: number, part: string): ElementInsertionSource;
+export {};

package/dist/generate/table.d.ts

@@ -0,0 +1,4 @@
+import type { TableStyleDefinition } from '@web-ppt/core';
+import type { EditDoc, ElementInsertionSource, ElementRecord } from '../types';
+export declare function tableInsertion(record: ElementRecord, spid: number): ElementInsertionSource;
+export declare function generatedTableStyleDefinitions(doc: EditDoc): readonly TableStyleDefinition[];

package/dist/generate/template.d.ts

@@ -0,0 +1,3 @@
+/** 生成保存的固定骨架只承载包级默认值；页面内容始终从 EditDoc 物化。 */
+export declare function generatedTemplateParts(width: number, height: number, slideCount?: number, notesSlides?: readonly boolean[]): Record<string, Uint8Array>;
+export declare function generatedEmptySlideXml(): string;