@web-ppt/edit-core 0.6.0 → 0.8.0-beta.1

package/dist/commands/types.d.ts

@@ -1,5 +1,5 @@
 import type { CellBorders, Effects, Fill, Stroke, TableCell } from '@web-ppt/core';
-import type { DesignTarget, EditIdentity, ElementId, ElementImageReplacement, ElementInsertionResource, ElementRecord, ImageCrop, LinkOverride, LinkTarget, ParagraphPropertyInput, ProjectionInvalidation, RunPropertyOverrides, SlideId, TextFragment, TextOverride, SlideRecord, TableCellAddress, TextBodyPropertyOverrides } from '../types';
+import type { DesignTarget, EditIdentity, ElementId, ElementImageReplacement, ElementInsertionResource, ElementRecord, ImageCrop, LinkOverride, LinkTarget, ParagraphPropertyInput, ProjectionInvalidation, RunPropertyOverrides, SlideId, TextFragment, TextOverride, SlideRecord, TableCellAddress, TextBodyPropertyOverrides, TableRowId, TableColumnId, TableCellRef, TableRowInsertion, TableColumnInsertion, TableMergeRegion, TableCellOverrides, TableCellRowRef, TableCellColumnRef, SectionId } from '../types';
 import type { ElementClipboardPayload } from './clipboard-types';
 import type { ElementHierarchyPatch, GroupCommand, UngroupCommand } from './group-types';
 import type { ConvertToCustomGeometryCommand, ElementGeometryPatch, ElementPresetGeometryPatch, SetAdjCommand, SetGeometryCommand, SetPresetCommand } from './geometry-types';
@@ -282,53 +282,53 @@ export interface InsertRowCommand {
     readonly id: ElementId;
     /** 省略仍兼容尾部追加；null 也表示尾部。 */
     readonly at?: {
-        readonly before: import('../types').TableRowId | null;
+        readonly before: TableRowId | null;
     };
 }
 export interface InsertColumnCommand {
     readonly type: 'InsertColumn';
     readonly id: ElementId;
     readonly at?: {
-        readonly before: import('../types').TableColumnId | null;
+        readonly before: TableColumnId | null;
     };
 }
 export interface RemoveRowCommand {
     readonly type: 'RemoveRow';
     readonly id: ElementId;
-    readonly row: import('../types').TableRowId;
+    readonly row: TableRowId;
 }
 export interface RemoveColumnCommand {
     readonly type: 'RemoveColumn';
     readonly id: ElementId;
-    readonly column: import('../types').TableColumnId;
+    readonly column: TableColumnId;
 }
 export interface SetRowHeightCommand {
     readonly type: 'SetRowHeight';
     readonly id: ElementId;
-    readonly row: import('../types').TableRowId;
+    readonly row: TableRowId;
     readonly height: number;
 }
 export interface SetColumnWidthCommand {
     readonly type: 'SetColumnWidth';
     readonly id: ElementId;
-    readonly column: import('../types').TableColumnId;
+    readonly column: TableColumnId;
     readonly width: number;
 }
 export interface MergeCellsCommand {
     readonly type: 'MergeCells';
     readonly id: ElementId;
-    readonly from: import('../types').TableCellRef;
-    readonly to: import('../types').TableCellRef;
+    readonly from: TableCellRef;
+    readonly to: TableCellRef;
 }
 export interface SplitCellCommand {
     readonly type: 'SplitCell';
     readonly id: ElementId;
-    readonly cell: import('../types').TableCellRef;
+    readonly cell: TableCellRef;
 }
 export interface SetCellPropsCommand {
     readonly type: 'SetCellProps';
     readonly id: ElementId;
-    readonly cell: import('../types').TableCellRef;
+    readonly cell: TableCellRef;
     readonly props: {
         readonly fill?: Exclude<Fill, {
             type: 'image';
@@ -343,15 +343,15 @@ export type Command = SetXfrmCommand | SetFlipCommand | RemoveElementCommand | S
 type PageOnlyCommand = AddSlideCommand | MoveSlideCommand | RemoveSlideCommand | DuplicateSlideCommand | AddSectionCommand | RenameSectionCommand | MoveSectionCommand | RemoveSectionCommand | SetSlideSizeCommand | SetBackgroundCropCommand | SetBackgroundImageCommand | SetHiddenCommand | SetAnimationsCommand | SetLayoutCommand | SetNotesCommand | SetThemeCommand | AddShapeCommand | AddImageCommand | AddTableCommand | PasteElementsCommand | ReplaceTextCommand;
 /** 版式命令沿用元素命令语言；只有画布属性命令显式携带 DesignTarget。 */
 export type DesignCommand = Exclude<Command, PageOnlyCommand | SetBackgroundCommand | SetTransitionCommand> | Extract<SetBackgroundCommand, {
-    readonly target: import('../types').DesignTarget;
+    readonly target: DesignTarget;
 }> | Extract<SetTransitionCommand, {
-    readonly target: import('../types').DesignTarget;
+    readonly target: DesignTarget;
 }> | Extract<AddShapeCommand, {
-    readonly target: import('../types').DesignTarget;
+    readonly target: DesignTarget;
 }> | Extract<AddImageCommand, {
-    readonly target: import('../types').DesignTarget;
+    readonly target: DesignTarget;
 }> | Extract<AddTableCommand, {
-    readonly target: import('../types').DesignTarget;
+    readonly target: DesignTarget;
 }>;
 type SetXfrmPatch = {
     [F in XfrmField]: {
@@ -452,12 +452,12 @@ export type ElementTextPatch = {
     readonly origin: string;
 } | {
     readonly op: 'set';
-    readonly path: readonly ['elements', ElementId, 'ovr', 'tableCells', import('../types').TableCellRowRef, import('../types').TableCellColumnRef, 'text'];
+    readonly path: readonly ['elements', ElementId, 'ovr', 'tableCells', TableCellRowRef, TableCellColumnRef, 'text'];
     readonly value: TextOverride;
     readonly origin: string;
 } | {
     readonly op: 'del';
-    readonly path: readonly ['elements', ElementId, 'ovr', 'tableCells', import('../types').TableCellRowRef, import('../types').TableCellColumnRef, 'text'];
+    readonly path: readonly ['elements', ElementId, 'ovr', 'tableCells', TableCellRowRef, TableCellColumnRef, 'text'];
     readonly origin: string;
 };
 export type ElementOrderPatch = {
@@ -513,7 +513,7 @@ export interface SlideTreeSnapshot {
     /** 复制发生时已证明的原操作；恢复与重做只运输这份不可变证据。 */
     readonly extensionCopies?: string;
     /** 页面结构 Patch 同步维护稳定节成员；省略表示该页不属于任何节。 */
-    readonly sectionId?: import('../types').SectionId;
+    readonly sectionId?: SectionId;
 }
 export type SlideTreePatch = {
     readonly op: 'remove' | 'insert';
@@ -532,13 +532,13 @@ export type SlideOrderPatch = {
 export type TableRowPatch = {
     readonly op: 'insert' | 'remove';
     readonly path: readonly ['elements', ElementId, 'ovr', 'tableRows', string];
-    readonly value: import('../types').TableRowInsertion;
+    readonly value: TableRowInsertion;
     readonly origin: string;
 };
 export type TableColumnPatch = {
     readonly op: 'insert' | 'remove';
     readonly path: readonly ['elements', ElementId, 'ovr', 'tableColumns', string];
-    readonly value: import('../types').TableColumnInsertion;
+    readonly value: TableColumnInsertion;
     readonly origin: string;
 };
 export type TableGridEntryPatch = {
@@ -556,7 +556,7 @@ export type TableGridEntryPatch = {
 export type TableMergePatch = {
     readonly op: 'set';
     readonly path: readonly ['elements', ElementId, 'ovr', 'tableMerges'];
-    readonly value: readonly import('../types').TableMergeRegion[];
+    readonly value: readonly TableMergeRegion[];
     readonly origin: string;
 } | {
     readonly op: 'del';
@@ -573,7 +573,7 @@ export type TableCellPropsPatch = {
         string,
         'fill' | 'borders' | 'margins' | 'vAlign' | 'vert'
     ];
-    readonly value?: import('../types').TableCellOverrides[keyof Omit<import('../types').TableCellOverrides, 'text'>];
+    readonly value?: TableCellOverrides[keyof Omit<TableCellOverrides, 'text'>];
     readonly origin: string;
 };
 export type ExtensionPatch = {

package/dist/fill/api.d.ts

@@ -0,0 +1,29 @@
+import type { TextMeasure } from '@web-ppt/core';
+import type { PresentationDescription } from '../describe/types';
+import type { LayoutLintOptions, LayoutLintReport } from '../lint/types';
+export interface TemplateFillOptions {
+    readonly idPrefix?: string;
+    readonly signal?: AbortSignal;
+    readonly lint: LayoutLintOptions & {
+        readonly measureText: TextMeasure;
+    };
+    /** 默认在生成副本中修复可确定处理的设计和布局问题，不修改输入模板。 */
+    readonly repair?: boolean;
+    /** false 允许返回带完整诊断的产物；默认遇到任何布局问题都拒绝。 */
+    readonly requireClean?: boolean;
+}
+export interface TemplateFillBinding {
+    readonly slideNumber: number;
+    readonly slideId: string;
+    readonly layoutId: string;
+    readonly titleId: string;
+    readonly bodyIds: readonly string[];
+    readonly objectId: string | null;
+}
+export interface TemplateFillResult {
+    readonly bytes: Uint8Array;
+    readonly description: PresentationDescription;
+    readonly lint: LayoutLintReport;
+    readonly bindings: readonly TemplateFillBinding[];
+    readonly repairs: readonly import('./repair').TemplateRepair[];
+}

package/dist/fill/chart-seed-chart.d.ts

@@ -0,0 +1,7 @@
+import type { TemplateFillChart } from './types';
+import type { SeedSeriesReferences } from './chart-seed-workbook';
+export interface SeedChartStyle {
+    readonly textColor?: string;
+    readonly fontFamily?: string;
+}
+export declare function seedChartXml(chart: TemplateFillChart, references: readonly SeedSeriesReferences[], categoriesFormula: string, style: SeedChartStyle): Uint8Array;

package/dist/fill/chart-seed-workbook.d.ts

@@ -0,0 +1,12 @@
+import type { TemplateFillChart } from './types';
+export interface SeedSeriesReferences {
+    readonly name: string;
+    readonly values: string;
+    readonly x?: string;
+    readonly sizes?: string;
+}
+export declare function seedChartWorkbook(chart: TemplateFillChart): {
+    readonly bytes: Uint8Array;
+    readonly categories: string;
+    readonly series: readonly SeedSeriesReferences[];
+};

package/dist/fill/chart-seed-xml.d.ts

@@ -0,0 +1,12 @@
+import type { XmlDocument, XmlElement, XmlNode } from '@web-ppt/edit-core/xml';
+export declare const SEED_NS: {
+    readonly chart: "http://schemas.openxmlformats.org/drawingml/2006/chart";
+    readonly drawing: "http://schemas.openxmlformats.org/drawingml/2006/main";
+    readonly presentation: "http://schemas.openxmlformats.org/presentationml/2006/main";
+    readonly office: "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
+    readonly relationships: "http://schemas.openxmlformats.org/package/2006/relationships";
+    readonly types: "http://schemas.openxmlformats.org/package/2006/content-types";
+    readonly spreadsheet: "http://schemas.openxmlformats.org/spreadsheetml/2006/main";
+};
+export declare function seedElement(name: string, attributes?: Readonly<Record<string, string | number>>, children?: readonly (XmlNode | string)[]): XmlElement;
+export declare function seedDocument(name: string, namespaces: Readonly<Record<string, string>>, children: readonly XmlElement[]): XmlDocument;

package/dist/fill/chart-seed.d.ts

@@ -0,0 +1,17 @@
+import type { TemplateFillChart } from './types';
+import type { SeedChartStyle } from './chart-seed-chart';
+export interface TemplateChartPlacement extends SeedChartStyle {
+    readonly slidePart: string;
+    readonly rect: {
+        readonly x: number;
+        readonly y: number;
+        readonly w: number;
+        readonly h: number;
+    };
+    readonly chart: TemplateFillChart;
+    readonly rot?: number;
+    readonly flipH?: boolean;
+    readonly flipV?: boolean;
+}
+/** 这是纯生成阶段；已有页面和包资源只经保留型 XML 与 OPC 写入，不修改调用方字节。 */
+export declare function seedTemplateCharts(bytes: Uint8Array, placements: readonly TemplateChartPlacement[]): Uint8Array;

package/dist/fill/content.d.ts

@@ -0,0 +1,16 @@
+import type { Editor, EditDoc, ElementId } from '@web-ppt/edit-core';
+import type { FillSlidePlan, FillSlot } from './layouts';
+import type { PreparedFillImage } from './validation';
+import type { TemplateFillSlide } from './types';
+export interface FilledPage {
+    readonly slideId: string;
+    readonly slidePart: string;
+    readonly plan: FillSlidePlan;
+    readonly type: TemplateFillSlide['type'];
+}
+export declare function pageSlot(doc: EditDoc, slideId: string, slot: FillSlot): ElementId;
+export declare function materializeOutline(editor: Editor, slides: readonly TemplateFillSlide[], plans: readonly FillSlidePlan[], images: ReadonlyMap<number, PreparedFillImage>, signal?: AbortSignal): readonly FilledPage[];
+export declare function chartSlotStyle(doc: EditDoc, slot: FillSlot): {
+    textColor?: string;
+    fontFamily?: string;
+};

package/dist/fill/errors.d.ts

@@ -0,0 +1,10 @@
+import type { LayoutLintReport } from '../lint/types';
+export declare class TemplateFillError extends Error {
+    readonly reason: string;
+    readonly slideNumber: number | null;
+    readonly field: string | null;
+    readonly elementId: string | null;
+    readonly lint?: LayoutLintReport | undefined;
+    constructor(reason: string, message: string, slideNumber?: number | null, field?: string | null, elementId?: string | null, lint?: LayoutLintReport | undefined);
+}
+export declare function requireActive(signal?: AbortSignal): void;

package/dist/fill/generated-schema.d.ts

@@ -0,0 +1,291 @@
+export declare const templateFillSchema: {
+    readonly $schema: "http://json-schema.org/draft-07/schema#";
+    readonly $ref: "#/definitions/TemplateFillOutline";
+    readonly definitions: {
+        readonly TemplateFillOutline: {
+            readonly type: "object";
+            readonly properties: {
+                readonly version: {
+                    readonly type: "number";
+                    readonly const: 1;
+                };
+                readonly slides: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/definitions/TemplateFillSlide";
+                    };
+                    readonly minItems: 1;
+                };
+            };
+            readonly required: readonly ["version", "slides"];
+            readonly additionalProperties: false;
+        };
+        readonly TemplateFillSlide: {
+            readonly anyOf: readonly [{
+                readonly $ref: "#/definitions/TemplateFillTitleSlide";
+            }, {
+                readonly $ref: "#/definitions/TemplateFillSectionSlide";
+            }, {
+                readonly $ref: "#/definitions/TemplateFillContentSlide";
+            }, {
+                readonly $ref: "#/definitions/TemplateFillTwoColumnSlide";
+            }, {
+                readonly $ref: "#/definitions/TemplateFillImageSlide";
+            }, {
+                readonly $ref: "#/definitions/TemplateFillChartSlide";
+            }];
+        };
+        readonly TemplateFillTitleSlide: {
+            readonly type: "object";
+            readonly properties: {
+                readonly title: {
+                    readonly type: "string";
+                };
+                readonly notes: {
+                    readonly type: "string";
+                };
+                readonly layoutId: {
+                    readonly type: "string";
+                };
+                readonly type: {
+                    readonly type: "string";
+                    readonly const: "title";
+                };
+                readonly subtitle: {
+                    readonly type: "string";
+                };
+            };
+            readonly required: readonly ["title", "type"];
+            readonly additionalProperties: false;
+        };
+        readonly TemplateFillSectionSlide: {
+            readonly type: "object";
+            readonly properties: {
+                readonly title: {
+                    readonly type: "string";
+                };
+                readonly notes: {
+                    readonly type: "string";
+                };
+                readonly layoutId: {
+                    readonly type: "string";
+                };
+                readonly type: {
+                    readonly type: "string";
+                    readonly const: "section";
+                };
+                readonly body: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/definitions/TemplateFillParagraph";
+                    };
+                };
+            };
+            readonly required: readonly ["title", "type"];
+            readonly additionalProperties: false;
+        };
+        readonly TemplateFillParagraph: {
+            readonly type: "object";
+            readonly properties: {
+                readonly text: {
+                    readonly type: "string";
+                };
+                readonly level: {
+                    readonly type: "number";
+                    readonly enum: readonly [0, 1, 2, 3, 4, 5, 6, 7, 8];
+                };
+                readonly bullet: {
+                    readonly type: "boolean";
+                };
+            };
+            readonly required: readonly ["text"];
+            readonly additionalProperties: false;
+        };
+        readonly TemplateFillContentSlide: {
+            readonly type: "object";
+            readonly properties: {
+                readonly title: {
+                    readonly type: "string";
+                };
+                readonly notes: {
+                    readonly type: "string";
+                };
+                readonly layoutId: {
+                    readonly type: "string";
+                };
+                readonly type: {
+                    readonly type: "string";
+                    readonly const: "content";
+                };
+                readonly body: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/definitions/TemplateFillParagraph";
+                    };
+                    readonly minItems: 1;
+                };
+            };
+            readonly required: readonly ["body", "title", "type"];
+            readonly additionalProperties: false;
+        };
+        readonly TemplateFillTwoColumnSlide: {
+            readonly type: "object";
+            readonly properties: {
+                readonly title: {
+                    readonly type: "string";
+                };
+                readonly notes: {
+                    readonly type: "string";
+                };
+                readonly layoutId: {
+                    readonly type: "string";
+                };
+                readonly type: {
+                    readonly type: "string";
+                    readonly const: "two-column";
+                };
+                readonly columns: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly $ref: "#/definitions/TemplateFillParagraph";
+                        };
+                    };
+                    readonly minItems: 2;
+                    readonly maxItems: 2;
+                };
+            };
+            readonly required: readonly ["columns", "title", "type"];
+            readonly additionalProperties: false;
+        };
+        readonly TemplateFillImageSlide: {
+            readonly type: "object";
+            readonly properties: {
+                readonly title: {
+                    readonly type: "string";
+                };
+                readonly notes: {
+                    readonly type: "string";
+                };
+                readonly layoutId: {
+                    readonly type: "string";
+                };
+                readonly type: {
+                    readonly type: "string";
+                    readonly const: "image";
+                };
+                readonly image: {
+                    readonly $ref: "#/definitions/TemplateFillImage";
+                };
+                readonly body: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/definitions/TemplateFillParagraph";
+                    };
+                };
+            };
+            readonly required: readonly ["image", "title", "type"];
+            readonly additionalProperties: false;
+        };
+        readonly TemplateFillImage: {
+            readonly type: "object";
+            readonly properties: {
+                readonly bytes: {
+                    readonly type: "string";
+                };
+                readonly mime: {
+                    readonly type: "string";
+                    readonly enum: readonly ["image/png", "image/jpeg", "image/gif", "image/webp"];
+                };
+                readonly altText: {
+                    readonly type: "string";
+                };
+                readonly fit: {
+                    readonly type: "string";
+                    readonly enum: readonly ["contain", "cover"];
+                };
+            };
+            readonly required: readonly ["bytes", "mime"];
+            readonly additionalProperties: false;
+        };
+        readonly TemplateFillChartSlide: {
+            readonly type: "object";
+            readonly properties: {
+                readonly title: {
+                    readonly type: "string";
+                };
+                readonly notes: {
+                    readonly type: "string";
+                };
+                readonly layoutId: {
+                    readonly type: "string";
+                };
+                readonly type: {
+                    readonly type: "string";
+                    readonly const: "chart";
+                };
+                readonly chart: {
+                    readonly $ref: "#/definitions/TemplateFillChart";
+                };
+            };
+            readonly required: readonly ["chart", "title", "type"];
+            readonly additionalProperties: false;
+        };
+        readonly TemplateFillChart: {
+            readonly type: "object";
+            readonly properties: {
+                readonly type: {
+                    readonly type: "string";
+                    readonly enum: readonly ["bar", "line", "pie", "doughnut", "area", "scatter", "radar", "bubble"];
+                };
+                readonly categories: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly series: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/definitions/TemplateFillChartSeries";
+                    };
+                };
+                readonly title: {
+                    readonly type: "string";
+                };
+            };
+            readonly required: readonly ["type", "categories", "series"];
+            readonly additionalProperties: false;
+        };
+        readonly TemplateFillChartSeries: {
+            readonly type: "object";
+            readonly properties: {
+                readonly name: {
+                    readonly type: "string";
+                };
+                readonly values: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: readonly ["number", "null"];
+                    };
+                };
+                readonly x: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: readonly ["number", "null"];
+                    };
+                };
+                readonly sizes: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: readonly ["number", "null"];
+                    };
+                };
+            };
+            readonly required: readonly ["name", "values"];
+            readonly additionalProperties: false;
+        };
+    };
+    readonly $id: "https://web-ppt.dev/schemas/template-fill.schema.json";
+};

package/dist/fill/generated-validator.d.ts

@@ -0,0 +1,6 @@
+export declare const validate: typeof validate10;
+export default validate10;
+declare function validate10(data: any, { instancePath, parentData, parentDataProperty, rootData }?: {
+    instancePath?: string | undefined;
+    rootData?: any;
+}): boolean;

package/dist/fill/index.d.ts

@@ -0,0 +1,10 @@
+import type { BuiltinTemplateId } from '../templates/types';
+import type { TemplateFillOptions, TemplateFillResult } from './api';
+import type { TemplateFillOutline } from './types';
+export { TemplateFillError } from './errors';
+export { templateFillSchema } from './generated-schema';
+export type * from './types';
+export type { TemplateFillBinding, TemplateFillOptions, TemplateFillResult } from './api';
+export type { TemplateRepair as TemplateFillRepair } from './repair';
+/** 返回的身份来自最终文件；生成期间的临时 ID 不向调用者冒充跨保存身份。 */
+export declare function fillTemplate(source: Uint8Array | BuiltinTemplateId, input: TemplateFillOutline, options: TemplateFillOptions): Promise<TemplateFillResult>;

package/dist/fill/layouts.d.ts

@@ -0,0 +1,24 @@
+import type { EditDoc } from '@web-ppt/edit-core';
+import type { TemplateFillSlide } from './types';
+export interface FillSlot {
+    readonly id: string;
+    readonly type: string;
+    readonly index: string | null;
+    readonly rot: number;
+    readonly flipH: boolean;
+    readonly flipV: boolean;
+    readonly rect: {
+        readonly x: number;
+        readonly y: number;
+        readonly w: number;
+        readonly h: number;
+    };
+}
+export interface FillSlidePlan {
+    readonly layoutId: string;
+    readonly title: FillSlot;
+    readonly subtitle?: FillSlot;
+    readonly bodies: readonly FillSlot[];
+    readonly object?: FillSlot;
+}
+export declare function planTemplateSlides(doc: EditDoc, slides: readonly TemplateFillSlide[]): readonly FillSlidePlan[];

package/dist/fill/package.d.ts

@@ -0,0 +1,2 @@
+/** 核心解析器先验证输入规模与格式；这里只转换普通模板的精确类型，不推断宏类型。 */
+export declare function prepareTemplatePackage(bytes: Uint8Array): Uint8Array;

package/dist/fill/repair.d.ts

@@ -0,0 +1,32 @@
+import type { EditDoc, Editor } from '@web-ppt/edit-core';
+import type { LayoutCheck, LayoutLintOptions, LayoutLintReport } from '@web-ppt/edit-core/lint';
+export interface TemplateRepair {
+    readonly elementId: string | null;
+    readonly slideNumber: number | null;
+    readonly source: {
+        readonly part: string;
+        readonly spid: number;
+    } | null;
+    readonly reason: LayoutCheck;
+    readonly action: string;
+    readonly before: Readonly<Record<string, unknown>>;
+    readonly after: Readonly<Record<string, unknown>>;
+}
+export interface TemplateRepairResult {
+    readonly changed: boolean;
+    readonly initialReport: LayoutLintReport | null;
+    readonly report: LayoutLintReport | null;
+    readonly repairs: readonly TemplateRepair[];
+    readonly unavailable: readonly {
+        readonly elementId: string;
+        readonly reason: LayoutCheck;
+        readonly detail: string;
+    }[];
+}
+interface RepairOptions {
+    readonly signal?: AbortSignal;
+    readonly phase?: 'design' | 'all';
+}
+/** 修复实际编辑模型；最终报告始终由同一套完整检查重新计算。 */
+export declare function repairTemplate(doc: EditDoc, editor: Editor, lint: LayoutLintOptions, options?: RepairOptions): Promise<TemplateRepairResult>;
+export {};

package/dist/fill/text-validation.d.ts

@@ -0,0 +1,3 @@
+import type { TemplateFillOutline } from './types';
+/** 在写入 OOXML 前规范化行尾；不能依赖宽容的自有解析器替独立读取器把关。 */
+export declare function normalizedOutline(outline: TemplateFillOutline): TemplateFillOutline;