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

package/dist/editor.d.ts

@@ -1,7 +1,7 @@
-import type { Command, EditorChange, EditorOptions, EditorPatchSubscriber, EditorPatchSubscribeOptions, EditorSubscriber, ExternalPatchOptions, History, Patch, Selection, Transaction, TransactionOptions, TransactionResult } from './commands/types';
+import type { Command, DesignCommand, 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';
+import type { DesignTarget, EditDoc, ElementId, SlideId } from './types';
 export declare class Editor {
     readonly doc: EditDoc;
     readonly history: History;
@@ -15,27 +15,39 @@ export declare class Editor {
     private savedState;
     private nextState;
     private activeImageResources;
+    private readonly unsubscribeExtensions;
     constructor(doc: EditDoc, options?: EditorOptions);
     get selection(): Selection;
     isDirty(): boolean;
     save(): Promise<Uint8Array>;
     saveDetailed(): Promise<OpcPatchResult>;
     markSaved(): void;
+    captureSavepoint(): () => void;
     select(selection: Selection): void;
     subscribe(subscriber: EditorSubscriber): () => void;
     subscribeRecovery(subscriber: RecoverySubscriber): () => void;
     subscribePatches(subscriber: EditorPatchSubscriber, options?: EditorPatchSubscribeOptions): () => void;
     exec(...commands: Command[]): TransactionResult;
+    execDesign(target: DesignTarget, ...commands: DesignCommand[]): TransactionResult;
     transaction(callback: (transaction: Transaction) => void, label: string, options?: TransactionOptions): TransactionResult;
     undo(): EditorChange | null;
     redo(): EditorChange | null;
+    private replayHistory;
     applyExternalPatches(patches: readonly Patch[], options?: ExternalPatchOptions): EditorChange | null;
     toSlide(id: SlideId): import("@web-ppt/core").Slide;
+    toDesignCanvas(target: DesignTarget): import("@web-ppt/core").Slide;
     effectiveElement(id: ElementId): import("@web-ppt/core").SlideElement;
+    /** 组变换折算后的外框，与画面同源；覆盖层经实例调用，避免独立打包的入口读到另一份投影缓存。 */
+    renderedElement(id: ElementId): import("@web-ppt/core").SlideElement;
+    renderedFrameToSlideMatrix(id: ElementId): import("./space").AffineMatrix;
+    renderedContentToSlideMatrix(id: ElementId): import("./space").AffineMatrix;
+    dispose(): void;
     private commit;
     private emitRecovery;
+    private transportPatches;
+    private assertReplayableHistory;
     private queuePatches;
-    private flushPatches;
+    private emitPatchChange;
     private emit;
     private refreshActiveImageResources;
     private historyImageResourceBytes;

package/dist/element-source.d.ts

@@ -0,0 +1,11 @@
+import type { EditDoc, ElementId } from './types';
+/** 按需读取原生宿主；插入片段的身份与关系已映射到当前文稿，无需先保存重开。 */
+export declare function sourceElementXml(doc: EditDoc, id: ElementId): {
+    part: string;
+    bytes: Uint8Array<ArrayBufferLike>;
+    relationships: Record<string, {
+        type: string;
+        target: string;
+        external?: true;
+    }>;
+} | undefined;

package/dist/element-spids.d.ts

@@ -0,0 +1,4 @@
+import type { EditDoc, ElementRecord } from './types';
+/** 未选兼容分支也占用同一 part 的身份空间，不能只数渲染投影。 */
+export declare function maxElementSpid(record: Pick<ElementRecord, 'meta'>): number;
+export declare function advanceElementSpid(doc: EditDoc, record: ElementRecord): void;

package/dist/extension-address-journal.d.ts

@@ -0,0 +1,9 @@
+import type { EditDoc } from './types';
+import type { Patch } from './commands/types';
+/** 每个日志独立声明地址；预检只读，失败事务不能消耗下次声明的机会。 */
+export declare class ExtensionAddressJournal {
+    private readonly declared;
+    reset(): void;
+    prepare(doc: EditDoc, patches: readonly Patch[], origin: string): readonly Patch[];
+    record(patches: readonly Patch[]): void;
+}

package/dist/extension-address-remap.d.ts

@@ -0,0 +1,14 @@
+export interface ExtensionIdentityRemap {
+    readonly ids: Readonly<Record<string, string>>;
+    readonly paths: readonly (readonly string[])[];
+    readonly values: readonly (readonly string[])[];
+    readonly prefix: string;
+}
+export declare function assertIdentityRemap(value: unknown): asserts value is ExtensionIdentityRemap | undefined;
+/** 只改声明为身份的路径位置与标量引用，标签即使恰好等于 ID 也必须原样保存。 */
+export declare function remapExtensionField(remap: ExtensionIdentityRemap | undefined, path: readonly string[], value?: unknown): {
+    path: readonly string[];
+    value: unknown;
+};
+/** 合并只接受相等或互不相交的叶；缺少原时钟的矛盾值不能凭所有者顺序裁决。 */
+export declare function mergeExtensionValue(target: unknown, source: unknown, remap?: ExtensionIdentityRemap): unknown;

package/dist/extension-addresses.d.ts

@@ -0,0 +1,20 @@
+import type { EditDoc } from './types';
+import type { DocumentExtensionPatch, Patch } from './commands/types';
+import type { ExtensionIdentityRemap } from './extension-address-remap';
+export declare const EXTENSION_ADDRESSES = "edit-addresses";
+export interface ExtensionAddress {
+    readonly target: readonly ['document', 'extensions', string, ...string[]];
+    readonly identities: Readonly<Record<string, string>>;
+    readonly remap?: ExtensionIdentityRemap;
+    readonly merge?: 'equal';
+}
+export declare const isExtensionAddressPatch: (patch: Patch) => patch is DocumentExtensionPatch;
+export declare function readExtensionAddress(value: unknown): ExtensionAddress;
+export declare function extensionAddressPatches(doc: EditDoc, origin: string): DocumentExtensionPatch[];
+export declare function canonicalExtensionPath(doc: EditDoc, path: Patch['path']): Patch['path'];
+export declare function canonicalExtensionPatch(doc: EditDoc, patch: Patch): Patch;
+export declare function validateExtensionAddress(doc: EditDoc, patch: DocumentExtensionPatch): void;
+export declare function validateExtensionAddresses(doc: EditDoc): void;
+export declare function moveExtensionAddress(doc: EditDoc, patch: DocumentExtensionPatch): void;
+/** 旧结构快照可复活框架，但不能用其中的旧覆盖重置已经独立存在的数据。 */
+export declare function clearRelocatedExtensions(doc: EditDoc): void;

package/dist/extension-copy-history.d.ts

@@ -0,0 +1,7 @@
+import type { EditDoc } from './types';
+import type { HistoryEntry, Patch, SlideTreeSnapshot } from './commands/types';
+import { type ExtensionCopyResolver } from './extension-copy';
+/** 只派生结构快照；完整领域/结构校验仍在实际插入批次执行。 */
+export declare function rebaseExtensionCopySnapshot(doc: EditDoc, before: SlideTreeSnapshot, updates: readonly Patch[], resolve?: ExtensionCopyResolver | undefined): SlideTreeSnapshot;
+/** 非记录写入仍属于被复制的对象；撤销复制可以移除它，重做必须恢复已经获胜的字段。 */
+export declare function rebaseExtensionCopyHistory(doc: EditDoc, entry: HistoryEntry, updates: readonly Patch[]): HistoryEntry;

package/dist/extension-copy.d.ts

@@ -0,0 +1,16 @@
+import type { EditDoc } from './types';
+import type { CommandPatches, Patch, SlideTreeSnapshot } from './commands/types';
+import type { ExtensionMigrationInput } from './extension-migration-receipt';
+export interface ExtensionCopyInput extends ExtensionMigrationInput {
+    readonly source: string;
+    readonly stamp: {
+        readonly clock: number;
+        readonly replicaId: string;
+    };
+}
+export type ExtensionCopyResolver = (doc: EditDoc, snapshot: SlideTreeSnapshot, previous: readonly Patch[]) => readonly ExtensionCopyInput[];
+export declare function extensionCopyMatches(snapshot: SlideTreeSnapshot, input: ExtensionCopyInput): boolean;
+/** 只检查复制快照与原操作的一致性；原版本的产生和比较仍由可选协同适配器负责。 */
+export declare function readExtensionCopies(snapshot: SlideTreeSnapshot): readonly ExtensionCopyInput[];
+/** 在命令落模前冻结证据；逆补丁和重做共用它，不能在重放时重新读取来源的新版本。 */
+export declare function prepareExtensionCopies(doc: EditDoc, commands: CommandPatches, previous: readonly Patch[]): void;

package/dist/extension-migration-receipt.d.ts

@@ -0,0 +1,34 @@
+import type { EditDoc } from './types';
+import type { DocumentExtensionPatch } from './commands/types';
+export declare const EXTENSION_MIGRATIONS = "edit-migrations";
+export interface ExtensionMigrationInput {
+    readonly path: readonly string[];
+    readonly op: 'set' | 'del';
+    readonly value?: string | number | boolean | null;
+    readonly stamp?: {
+        readonly clock: number;
+        readonly replicaId: string;
+    };
+}
+export interface ExtensionMigrationReceipt {
+    readonly version: 1;
+    readonly routes: readonly {
+        readonly source: readonly [string, string];
+        readonly address: string;
+    }[];
+    readonly inputs: readonly ExtensionMigrationInput[];
+    readonly winners: readonly number[];
+}
+type ApplyField = (doc: EditDoc, patch: DocumentExtensionPatch) => void;
+type ValidateField = (doc: EditDoc, patch: DocumentExtensionPatch, index: number) => void;
+export declare const isExtensionMigrationPatch: (patch: {
+    path: readonly unknown[];
+}) => patch is DocumentExtensionPatch;
+/** stamp 只是一次裁决的原始证据；编辑核心不据此创建或推进协同寄存器。 */
+export declare function readExtensionMigration(value: unknown): ExtensionMigrationReceipt;
+export declare function canonicalExtensionMigrationInputs(doc: EditDoc, receipt: Pick<ExtensionMigrationReceipt, 'routes' | 'inputs'>): ExtensionMigrationInput[];
+export declare function validateExtensionMigration(doc: EditDoc, patch: DocumentExtensionPatch, validate: ValidateField, apply: ApplyField): void;
+export declare function applyExtensionMigration(doc: EditDoc, patch: DocumentExtensionPatch, apply: ApplyField): void;
+export declare function extensionMigrationReceipts(doc: EditDoc, origin: string): DocumentExtensionPatch[];
+export declare function validateExtensionMigrationReceipts(doc: EditDoc): void;
+export {};

package/dist/extension-recovery-context.d.ts

@@ -0,0 +1,5 @@
+import type { EditDoc } from './types';
+/** 只授予隔离恢复模型旧协议校验能力；未来路由不得提前改变历史字段的写入地址。 */
+export declare function setLegacyExtensionReplay(doc: EditDoc, pending: ReadonlySet<string>): void;
+export declare function inheritLegacyExtensionReplay(doc: EditDoc, stage: EditDoc): void;
+export declare function isLegacyExtensionReplay(doc: EditDoc, id: string, namespace: string): boolean;

package/dist/extension-runtime.d.ts

@@ -0,0 +1,64 @@
+import type { Slide, SlideElement } from '@web-ppt/core';
+import type { CommandPatches, DocumentExtensionPatch, ExtensionCommand, ExtensionPatch, Patch } from './commands/types';
+import type { EditDoc, ElementId, ElementInsertionResource, SlideId } from './types';
+import type { OpcPartChanges } from './opc/types';
+import type { ExtensionCopyResolver } from './extension-copy';
+export interface EditExtensionSavePlan {
+    readonly changes: OpcPartChanges;
+    readonly baselines: Readonly<Record<string, Uint8Array>>;
+}
+/** undefined 允许无版本的等值回退；空数组明确否决整组迁移。 */
+export type ExtensionMigrationResolver = (doc: EditDoc, routes: readonly DocumentExtensionPatch[]) => readonly DocumentExtensionPatch[] | undefined;
+export interface EditExtensionRuntime {
+    readonly migrate?: (doc: EditDoc, pending?: readonly Patch[], resolve?: ExtensionMigrationResolver) => readonly Patch[];
+    readonly validateDocumentPatch?: (doc: EditDoc, patch: DocumentExtensionPatch, index: number) => void;
+    readonly documentElements?: (doc: EditDoc, patch?: DocumentExtensionPatch) => readonly ElementId[];
+    readonly projectDocument?: (doc: EditDoc, id: ElementId, element: SlideElement) => SlideElement;
+    /** 来源状态可能由别处的覆盖决定；此投影在局部覆盖前执行，不要求本元素已有扩展字段。 */
+    readonly projectSource?: (doc: EditDoc, id: ElementId, element: SlideElement) => SlideElement;
+    readonly generateParts?: (doc: EditDoc, parts: Record<string, Uint8Array>) => void;
+    readonly copyParts?: (doc: EditDoc, parts: Record<string, Uint8Array>) => void;
+    readonly scope?: 'element' | 'slide';
+    readonly materializePackage?: (doc: EditDoc, baselines: Record<string, Uint8Array>, created: Set<string>, changes: Record<string, Uint8Array | null>) => void;
+    readonly projectSlide?: (doc: EditDoc, id: SlideId, slide: Slide) => Slide;
+    readonly materialize?: (document: import('./xml/types').XmlDocument, record: import('./types').ElementRecord, generated: boolean, xml: import('./save/extension-elements').EditElementXml) => void;
+    readonly supportsGenerated?: (element: SlideElement) => boolean;
+    readonly validateResource?: (resource: ElementInsertionResource, bytes: Uint8Array) => boolean;
+    readonly command: (doc: EditDoc, command: ExtensionCommand, origin: string) => CommandPatches;
+    readonly validatePatch?: (doc: EditDoc, patch: ExtensionPatch, index: number) => void;
+    readonly validatePatches?: (doc: EditDoc, patches: readonly {
+        readonly patch: ExtensionPatch;
+        readonly index: number;
+    }[]) => void;
+    readonly prune?: (doc: EditDoc, id: ElementId, state: unknown) => boolean;
+    readonly project?: (doc: EditDoc, id: ElementId, element: SlideElement) => SlideElement;
+    readonly beforeSave?: (doc: EditDoc) => EditExtensionSavePlan | void | Promise<EditExtensionSavePlan | void>;
+}
+/** 版本策略属于可选会话；模型和恢复日志中只保留其产生的纯数据结果。 */
+export declare function setExtensionMigrationResolver(doc: EditDoc, resolver: ExtensionMigrationResolver, copy?: ExtensionCopyResolver): () => void;
+export declare function extensionCopyResolver(doc: EditDoc): ExtensionCopyResolver | undefined;
+export declare function refreshExtensionMigrations(doc: EditDoc): void;
+export declare function assertNamespace(namespace: string): void;
+/** 扩展补丁只能持久化标量叶；对象和数组无须遍历，本身就是无效输入。 */
+export declare function assertExtensionLeaf(value: unknown): void;
+export declare function registerEditExtension(namespace: string, runtime: EditExtensionRuntime): void;
+export declare function editExtensionGeneration(): number;
+/** 迟到的旧地址可能在扩展加载之后首次出现；只为这类字段请求迁移计划。 */
+export declare function extensionMigrationPatches(doc: EditDoc, patches: readonly Patch[], resolve?: ExtensionMigrationResolver | undefined): readonly Patch[];
+export declare function observeEditExtensionRegistration(doc: EditDoc, refresh: (elements: Set<ElementId>, slides: Set<SlideId>) => void, migrate?: (patches: readonly Patch[]) => void): () => void;
+export declare function extensionCommandPatches(doc: EditDoc, command: ExtensionCommand, origin: string): CommandPatches;
+export declare function isExtensionPatch(patch: {
+    path: readonly unknown[];
+}): patch is ExtensionPatch;
+export declare function validateExtensionPatch(doc: EditDoc, patch: ExtensionPatch, index: number, runtimeAlreadyValidated?: boolean): void;
+export declare function validateExtensionPatchBatches(doc: EditDoc, patches: readonly {
+    readonly patch: ExtensionPatch;
+    readonly index: number;
+}[]): ReadonlySet<number>;
+export declare function applyExtensionPatch(doc: EditDoc, patch: ExtensionPatch): void;
+export declare function finalizeExtensionPatch(doc: EditDoc, id: ElementId, namespace: string, scope: 'elements' | 'slides'): void;
+export declare function projectEditExtensions(doc: EditDoc, id: ElementId, element: SlideElement): SlideElement;
+export declare function observeDocumentExtension(doc: EditDoc, namespace: string): void;
+/** 保存实现位于动态入口；这里只暴露同一全局注册表的只读视图。 */
+export declare function registeredEditExtensions(): ReadonlyMap<string, EditExtensionRuntime>;
+export declare function projectSlideExtensions(doc: EditDoc, id: SlideId, slide: Slide): Slide;

package/dist/generate/comments.d.ts

@@ -0,0 +1,3 @@
+import type { Slide } from '@web-ppt/core';
+/** 批注不属于元素树；生成页面时必须另外写出，否则清空/复制元素会把只读内容静默丢掉。 */
+export declare function materializeGeneratedComments(parts: Record<string, Uint8Array>, slides: readonly Slide[]): void;

package/dist/generate/compatibility-parts.d.ts

@@ -0,0 +1,14 @@
+import type { EditDoc, ElementInsertionRelationship, ElementInsertionResource } from '../types';
+/** 不透明对象的依赖保持原字节，只有页面到对象的关系需要换成生成页的新 rId。 */
+export declare class CompatibilityParts {
+    private readonly doc;
+    private readonly parts;
+    private readonly media;
+    constructor(doc: EditDoc);
+    source(part: string): Uint8Array | undefined;
+    registerMedia(resources: readonly ElementInsertionResource[]): void;
+    relationships(part: string): ElementInsertionRelationship[];
+    private retain;
+    relocate(relation: ElementInsertionRelationship, from: string, to: string, id: string): ElementInsertionRelationship;
+    mergeInto(parts: Record<string, Uint8Array>): void;
+}

package/dist/generate/compatibility-references.d.ts

@@ -0,0 +1,3 @@
+import type { XmlElement } from '../xml/types';
+/** 隐藏分支也可能有连接线；只改 cNvPr 会让线端继续指向已经换号的旧对象。 */
+export declare function remapCompatibilityReferences(host: XmlElement, ids: Readonly<Record<string, number>>): void;

package/dist/generate/compatibility.d.ts

@@ -0,0 +1,4 @@
+import type { EditDoc, ElementInsertionSource, ElementRecord } from '../types';
+import type { CompatibilityParts } from './compatibility-parts';
+/** 整个 MC 外壳是一个框架对象；隐藏表示和只读组后代不能按普通图形重新生成。 */
+export declare function compatibilityInsertion(doc: EditDoc, record: ElementRecord, targetPart: string, targetSpid: number, usedSpids: Set<number>, parts: CompatibilityParts): ElementInsertionSource;

package/dist/generate/index.d.ts

@@ -10,3 +10,4 @@ export declare function createBlankPptx(options?: CreateBlankPptxOptions): Uint8
 /** 没有可补丁原包时从统一编辑模型构造新 PPTX；本函数不改变 EditDoc。 */
 export declare function generateEditDoc(doc: EditDoc): OpcPatchResult;
 export type { OpcPatchResult } from '../opc/types';
+export { copyPortableElements } from './portable-clipboard';

package/dist/generate/master-defaults.d.ts

@@ -0,0 +1,4 @@
+import type { Slide } from '@web-ppt/core';
+import type { EditDoc } from '../types';
+/** 生成包仍用固定单母版，但必须把当前有效设计默认值写入该母版，而不是输出空壳。 */
+export declare function materializeGeneratedMasterDefaults(doc: EditDoc, slides: readonly Slide[], parts: Record<string, Uint8Array>): void;

package/dist/generate/materialize.d.ts

@@ -1,2 +1,2 @@
-import type { EditDoc } from '../types';
-export declare function materializeGeneratedParts(doc: EditDoc): Record<string, Uint8Array>;
+import type { EditDoc, SlideId } from '../types';
+export declare function materializeGeneratedParts(doc: EditDoc, observe?: (slideId: SlideId, work: EditDoc) => void, resourceSource?: EditDoc): Record<string, Uint8Array>;

package/dist/generate/math.d.ts

@@ -0,0 +1,3 @@
+import type { MathNode } from '@web-ppt/core';
+/** 公式树保持原子身份；不能用其线性搜索文本代替原生 OMML。 */
+export declare function mathMarkup(nodes: readonly MathNode[], depth?: number): string;

package/dist/generate/portable-clipboard.d.ts

@@ -0,0 +1,4 @@
+import type { EditDoc, ElementId } from '../types';
+import type { ElementClipboardPayload } from '../commands/types';
+/** 直接从选中模型生成宿主片段；不生成 ZIP，不重新解析，也不修改源文档。 */
+export declare function copyPortableElements(doc: EditDoc, ids: readonly ElementId[]): ElementClipboardPayload;

package/dist/generate/projection-tree.d.ts

@@ -0,0 +1,8 @@
+import type { EditDoc, ElementRecord, SlideId } from '../types';
+export interface GeneratedProjectionTree {
+    readonly roots: string[];
+    readonly sourceRecords: Record<string, ElementRecord>;
+}
+export declare function allocatedProjectionSpids(records: Readonly<Record<string, ElementRecord>>, roots: readonly string[]): Map<string, number>;
+/** 生成包没有版式关系，先把有效版式视觉变成页面自有的稳定记录树。 */
+export declare function generatedProjectionTree(doc: EditDoc, slideId: SlideId): GeneratedProjectionTree;

package/dist/generate/template.d.ts

@@ -1,3 +1,70 @@
+import type { PresentationTheme, ThemeColorSlot } from '@web-ppt/core';
 /** 生成保存的固定骨架只承载包级默认值；页面内容始终从 EditDoc 物化。 */
-export declare function generatedTemplateParts(width: number, height: number, slideCount?: number, notesSlides?: readonly boolean[]): Record<string, Uint8Array>;
+export declare function generatedTemplateParts(width: number, height: number, slideCount?: number, notesSlides?: readonly boolean[], theme?: PresentationTheme): Record<string, Uint8Array>;
 export declare function generatedEmptySlideXml(): string;
+export type GeneratedTemplateColor = ({
+    readonly slot: ThemeColorSlot;
+    readonly rgb?: never;
+} | {
+    readonly slot?: never;
+    readonly rgb: string;
+}) & {
+    readonly alpha?: number;
+};
+export interface GeneratedTemplateDecoration {
+    readonly name: string;
+    readonly preset: 'rect' | 'ellipse' | 'line';
+    readonly rect: {
+        readonly x: number;
+        readonly y: number;
+        readonly w: number;
+        readonly h: number;
+    };
+    readonly fill?: GeneratedTemplateColor;
+    readonly stroke?: GeneratedTemplateColor & {
+        readonly width?: number;
+    };
+    readonly rotation?: number;
+}
+export interface GeneratedTemplatePlaceholder {
+    readonly name: string;
+    readonly type: 'ctrTitle' | 'title' | 'subTitle' | 'body' | 'sldNum';
+    readonly rect: {
+        readonly x: number;
+        readonly y: number;
+        readonly w: number;
+        readonly h: number;
+    };
+    readonly index?: number;
+}
+export interface GeneratedTemplateLayout {
+    readonly part: number;
+    readonly type: 'title' | 'obj' | 'twoObj' | 'secHead' | 'blank';
+    readonly name: string;
+    readonly placeholders: readonly GeneratedTemplatePlaceholder[];
+    readonly decorations?: readonly GeneratedTemplateDecoration[];
+    readonly background?: GeneratedTemplateColor;
+}
+export interface GeneratedTemplateTextStyle {
+    readonly font: 'major' | 'minor';
+    readonly color: GeneratedTemplateColor;
+    readonly size: number;
+    readonly step?: number;
+    readonly align?: 'l' | 'ctr' | 'r';
+    readonly bold?: boolean;
+    readonly bullet?: boolean;
+}
+export interface GeneratedTemplateDesign {
+    readonly theme: PresentationTheme;
+    readonly masterBackground: GeneratedTemplateColor;
+    readonly masterDecorations: readonly GeneratedTemplateDecoration[];
+    readonly textStyles: {
+        readonly title: GeneratedTemplateTextStyle;
+        readonly body: GeneratedTemplateTextStyle;
+        readonly other: GeneratedTemplateTextStyle;
+    };
+    readonly layouts: readonly GeneratedTemplateLayout[];
+    readonly initialLayoutPart: number;
+}
+/** 内置设计配方复用生成保存骨架；默认空白入口不经过本函数，因而保持原字节。 */
+export declare function generatedDesignedTemplateParts(width: number, height: number, design: GeneratedTemplateDesign): Record<string, Uint8Array>;

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

@@ -0,0 +1,2 @@
+import type { TextBody } from '@web-ppt/core';
+export declare function generatedTextBody(body: TextBody, part: string, spid: number, prefix?: string, tableStyleAware?: boolean): string;

package/dist/generate/text-effects.d.ts

@@ -0,0 +1,5 @@
+import type { TextRun } from '@web-ppt/core';
+import type { XmlElement } from '../xml/types';
+export declare const hasNativeText: (run: TextRun) => boolean;
+export declare function validateNativeText(run: TextRun): void;
+export declare function materializeNativeText(properties: XmlElement, run: TextRun): void;

package/dist/generate/text-override.d.ts

@@ -0,0 +1,8 @@
+import type { TextBody } from '@web-ppt/core';
+import type { EditDoc, ElementInsertionResource, SlideId, TextOverride } from '../types';
+export interface GeneratedTextContext {
+    readonly part: string;
+    readonly relationshipPrefix: string;
+    readonly resources: Map<string, ElementInsertionResource>;
+}
+export declare function textOverride(doc: EditDoc, slideId: SlideId, body: TextBody | null | undefined, context: GeneratedTextContext, tableStyleAware?: boolean): TextOverride | undefined;

package/dist/generate/validation.d.ts

@@ -0,0 +1,3 @@
+import type { EditDoc } from '../types';
+/** 生成保存没有可覆盖的 OPC 目标；只在校验视图中把自带字节的媒体转成新资源。 */
+export declare function generatedValidationDoc(doc: EditDoc): EditDoc;

package/dist/generate/warp.d.ts

@@ -0,0 +1,2 @@
+import type { TextWarp } from '@web-ppt/core';
+export declare function warpMarkup(warp: TextWarp | undefined): string;