pptx-viewer-mcp 2.4.1 → 2.5.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { Doc } from "yjs";
-import { ChartAxisEdit, ParsedTableStyleBorders, ParsedTableStyleFill, ParsedTableStyleText, PptxAppProperties, PptxChartErrBars, PptxChartMarkerSymbol, PptxChartUserShape, PptxCoreProperties, PptxCustomProperty, PptxData, PptxData as PptxData$1, PptxData as PptxData$2, PptxElement, PptxElement as PptxElement$1, PptxHandler, PptxJsonAssetStats, PptxPresentationProperties, PptxSlide, PptxSlide as PptxSlide$1, PptxTableCell3D, PptxThemeColorRef, PptxThemeColorScheme, PptxThemeFontScheme, PresentationDiff, ShapeStyle, TableStylePartName } from "pptx-viewer-core";
+import { ChartAxisEdit, OleNestedDeckSlideDetail, OlePayloadEditorKind, OleSheetGrid, ParsedTableStyleBorders, ParsedTableStyleFill, ParsedTableStyleText, PptxAppProperties, PptxChartErrBars, PptxChartMarkerSymbol, PptxChartUserShape, PptxCoreProperties, PptxCustomProperty, PptxData, PptxData as PptxData$1, PptxData as PptxData$2, PptxElement, PptxElement as PptxElement$1, PptxHandler, PptxJsonAssetStats, PptxPresentationProperties, PptxSlide, PptxSlide as PptxSlide$1, PptxTableCell3D, PptxThemeColorRef, PptxThemeColorScheme, PptxThemeFontScheme, PresentationDiff, ShapeStyle, TableStylePartName } from "pptx-viewer-core";
 //#region src/types.d.ts
 /**
  * Platform-agnostic context passed to every tool function.
@@ -103,14 +103,14 @@ interface ExecutionContext {
  * If a Y.Doc room is active the current in-memory state is dehydrated
  * so that unsaved edits are included in the tool's view of the document.
  */
-declare function loadPresentation(filePath: string, execCtx: ExecutionContext): Promise<{
+export declare function loadPresentation(filePath: string, execCtx: ExecutionContext): Promise<{
   pptxData: PptxData$1;
   rawBytes: Uint8Array;
 }>;
 /**
  * Save mutated PptxData back: routes through collaboration Y.Doc or disk.
  */
-declare function savePresentation(filePath: string, pptxData: PptxData$1, rawBytes: Uint8Array, execCtx: ExecutionContext, tableStyleSaveOptions?: TableStyleSaveOptions): Promise<{
+export declare function savePresentation(filePath: string, pptxData: PptxData$1, rawBytes: Uint8Array, execCtx: ExecutionContext, tableStyleSaveOptions?: TableStyleSaveOptions): Promise<{
   savedToDisk: boolean;
   routedThroughCollaboration: boolean;
 }>;
@@ -118,7 +118,7 @@ declare function savePresentation(filePath: string, pptxData: PptxData$1, rawByt
  * Execute a pure tool function with full collaboration-aware load/save pipeline.
  * Handles dehydrate-from-room → tool → hydrate-back-to-room routing automatically.
  */
-declare function executeToolWithContext<T>(filePath: string, execCtx: ExecutionContext, toolFn: (ctx: ToolContext) => ToolResult<T> | Promise<ToolResult<T>>): Promise<T & {
+export declare function executeToolWithContext<T>(filePath: string, execCtx: ExecutionContext, toolFn: (ctx: ToolContext) => ToolResult<T> | Promise<ToolResult<T>>): Promise<T & {
   savedToDisk?: boolean;
   routedThroughCollaboration?: boolean;
 }>;
@@ -134,7 +134,7 @@ interface GetSlideResult {
   commentCount: number;
   elements: Record<string, unknown>[];
 }
-declare function getSlide(ctx: ToolContext, params: {
+export declare function getSlide(ctx: ToolContext, params: {
   slideIndex: number;
 }): ToolResult<GetSlideResult>;
 interface AddSlideParams {
@@ -145,7 +145,7 @@ interface AddSlideResult {
   newSlideIndex: number;
   slideCount: number;
 }
-declare function addSlide(ctx: ToolContext, params: AddSlideParams): ToolResult<AddSlideResult>;
+export declare function addSlide(ctx: ToolContext, params: AddSlideParams): ToolResult<AddSlideResult>;
 interface DeleteSlidesParams {
   slideIndexes: number[];
 }
@@ -153,18 +153,18 @@ interface DeleteSlidesResult {
   deletedCount: number;
   slideCount: number;
 }
-declare function deleteSlides(ctx: ToolContext, params: DeleteSlidesParams): ToolResult<DeleteSlidesResult>;
+export declare function deleteSlides(ctx: ToolContext, params: DeleteSlidesParams): ToolResult<DeleteSlidesResult>;
 interface ReorderSlidesParams {
   newOrder: number[];
 }
-declare function reorderSlides(ctx: ToolContext, params: ReorderSlidesParams): ToolResult<{
+export declare function reorderSlides(ctx: ToolContext, params: ReorderSlidesParams): ToolResult<{
   slideCount: number;
 }>;
 interface DuplicateSlideParams {
   slideIndex: number;
   targetIndex?: number;
 }
-declare function duplicateSlide(ctx: ToolContext, params: DuplicateSlideParams): ToolResult<{
+export declare function duplicateSlide(ctx: ToolContext, params: DuplicateSlideParams): ToolResult<{
   newSlideIndex: number;
   slideCount: number;
 }>;
@@ -176,7 +176,7 @@ interface UpdateSlidePropertiesParams {
   notes?: string;
   hidden?: boolean;
 }
-declare function updateSlideProperties(ctx: ToolContext, params: UpdateSlidePropertiesParams): ToolResult<{
+export declare function updateSlideProperties(ctx: ToolContext, params: UpdateSlidePropertiesParams): ToolResult<{
   slideIndex: number;
 }>;
 interface SetSlideTransitionParams {
@@ -187,7 +187,7 @@ interface SetSlideTransitionParams {
   advanceOnClick?: boolean;
   advanceAfterMs?: number;
 }
-declare function setSlideTransition(ctx: ToolContext, params: SetSlideTransitionParams): ToolResult<{
+export declare function setSlideTransition(ctx: ToolContext, params: SetSlideTransitionParams): ToolResult<{
   slideIndex: number;
   transitionType: string;
 }>;
@@ -195,20 +195,20 @@ interface SetCanvasSizeParams {
   width: number;
   height: number;
 }
-declare function setCanvasSize(ctx: ToolContext, params: SetCanvasSizeParams): ToolResult<{
+export declare function setCanvasSize(ctx: ToolContext, params: SetCanvasSizeParams): ToolResult<{
   canvasWidth: number;
   canvasHeight: number;
 }>;
 //#endregion
 //#region src/tools/helpers.d.ts
-declare function generateElementId(): string;
-declare function generateSlideId(): string;
+export declare function generateElementId(): string;
+export declare function generateSlideId(): string;
 /** Build a concise text representation of a slide element for tool output. */
-declare function describeElement(el: PptxElement$1): Record<string, unknown>;
+export declare function describeElement(el: PptxElement$1): Record<string, unknown>;
 /** Extract text from a slide's elements for search purposes. */
-declare function extractSlideText(slide: PptxSlide$1): string;
+export declare function extractSlideText(slide: PptxSlide$1): string;
 /** Validate slideIndex is within range, return error string or null. */
-declare function validateSlideIndex(slideIndex: number, slideCount: number): string | null;
+export declare function validateSlideIndex(slideIndex: number, slideCount: number): string | null;
 //#endregion
 //#region src/tools/element-tools.d.ts
 interface AddElementParams {
@@ -245,7 +245,7 @@ interface AddElementResult {
   elementId: string;
   slideIndex: number;
 }
-declare function addElement(ctx: ToolContext, params: AddElementParams): ToolResult<AddElementResult>;
+export declare function addElement(ctx: ToolContext, params: AddElementParams): ToolResult<AddElementResult>;
 interface UpdateElementParams {
   slideIndex: number;
   elementId: string;
@@ -281,7 +281,7 @@ interface UpdateElementParams {
   /** Accessibility title; see {@link applyElementTitle} for the accepted kinds. */
   title?: string;
 }
-declare function updateElement(ctx: ToolContext, params: UpdateElementParams): ToolResult<{
+export declare function updateElement(ctx: ToolContext, params: UpdateElementParams): ToolResult<{
   elementId: string;
 }>;
 interface RenameElementParams {
@@ -290,7 +290,7 @@ interface RenameElementParams {
   /** New element name (`cNvPr/@name`); an empty string clears the name. */
   name: string;
 }
-declare function renameElement(ctx: ToolContext, params: RenameElementParams): ToolResult<{
+export declare function renameElement(ctx: ToolContext, params: RenameElementParams): ToolResult<{
   elementId: string;
   name: string;
 }>;
@@ -298,7 +298,7 @@ interface DeleteElementsParams {
   slideIndex: number;
   elementIds: string[];
 }
-declare function deleteElements(ctx: ToolContext, params: DeleteElementsParams): ToolResult<{
+export declare function deleteElements(ctx: ToolContext, params: DeleteElementsParams): ToolResult<{
   deletedCount: number;
 }>;
 interface ArrangeElementsParams {
@@ -309,7 +309,7 @@ interface ArrangeElementsParams {
   elementId?: string;
   layerAction?: 'bringToFront' | 'sendToBack' | 'bringForward' | 'sendBackward';
 }
-declare function arrangeElements(ctx: ToolContext, params: ArrangeElementsParams): ToolResult<{
+export declare function arrangeElements(ctx: ToolContext, params: ArrangeElementsParams): ToolResult<{
   slideIndex: number;
 }>;
 interface CloneElementParams {
@@ -322,7 +322,7 @@ interface CloneElementParams {
 interface CloneElementResult {
   clonedIds: string[];
 }
-declare function cloneElement(ctx: ToolContext, params: CloneElementParams): ToolResult<CloneElementResult>;
+export declare function cloneElement(ctx: ToolContext, params: CloneElementParams): ToolResult<CloneElementResult>;
 interface SetElementAnimationParams {
   slideIndex: number;
   elementId: string;
@@ -332,7 +332,7 @@ interface SetElementAnimationParams {
   delayMs?: number;
   order?: number;
 }
-declare function setElementAnimation(ctx: ToolContext, params: SetElementAnimationParams): ToolResult<{
+export declare function setElementAnimation(ctx: ToolContext, params: SetElementAnimationParams): ToolResult<{
   elementId: string;
 }>;
 interface GroupElementsParams {
@@ -342,7 +342,7 @@ interface GroupElementsParams {
 interface GroupElementsResult {
   groupId: string;
 }
-declare function groupElements(ctx: ToolContext, params: GroupElementsParams): ToolResult<GroupElementsResult>;
+export declare function groupElements(ctx: ToolContext, params: GroupElementsParams): ToolResult<GroupElementsResult>;
 interface UngroupElementsParams {
   slideIndex: number;
   groupElementId: string;
@@ -350,7 +350,7 @@ interface UngroupElementsParams {
 interface UngroupElementsResult {
   restoredIds: string[];
 }
-declare function ungroupElements(ctx: ToolContext, params: UngroupElementsParams): ToolResult<UngroupElementsResult>;
+export declare function ungroupElements(ctx: ToolContext, params: UngroupElementsParams): ToolResult<UngroupElementsResult>;
 interface BatchUpdateElementsParams {
   slideIndex: number;
   elementIds: string[];
@@ -362,7 +362,7 @@ interface BatchUpdateElementsParams {
   opacity?: number;
   hidden?: boolean;
 }
-declare function batchUpdateElements(ctx: ToolContext, params: BatchUpdateElementsParams): ToolResult<{
+export declare function batchUpdateElements(ctx: ToolContext, params: BatchUpdateElementsParams): ToolResult<{
   updatedCount: number;
 }>;
 //#endregion
@@ -376,7 +376,7 @@ interface UpdateTableCellsParams {
     text: string;
   }>;
 }
-declare function updateTableCells(ctx: ToolContext, params: UpdateTableCellsParams): ToolResult<{
+export declare function updateTableCells(ctx: ToolContext, params: UpdateTableCellsParams): ToolResult<{
   updatedCount: number;
 }>;
 interface ManageTableStructureParams {
@@ -387,7 +387,7 @@ interface ManageTableStructureParams {
   referenceIndex?: number;
   cellTexts?: string[];
 }
-declare function manageTableStructure(ctx: ToolContext, params: ManageTableStructureParams): ToolResult<{
+export declare function manageTableStructure(ctx: ToolContext, params: ManageTableStructureParams): ToolResult<{
   rowCount: number;
   columnCount: number;
 }>;
@@ -408,7 +408,7 @@ interface SetTableStyleSectionParams {
  * left untouched (matches `applyTableStyleEntryToNode`'s merge semantics).
  * Throws if `styleId` names no loaded style: use `create_table_style` first.
  */
-declare function setTableStyleSection(ctx: ToolContext, params: SetTableStyleSectionParams): ToolResult<{
+export declare function setTableStyleSection(ctx: ToolContext, params: SetTableStyleSectionParams): ToolResult<{
   styleId: string;
   section: TableStylePartName;
 }>;
@@ -419,7 +419,7 @@ interface CreateTableStyleParams {
   /** Repoint `ppt/tableStyles.xml`'s `@def` at the new style on save. */
   setAsDefault?: boolean;
 }
-declare function createTableStyle(ctx: ToolContext, params: CreateTableStyleParams): ToolResult<{
+export declare function createTableStyle(ctx: ToolContext, params: CreateTableStyleParams): ToolResult<{
   styleId: string;
 }>;
 interface DeleteTableStyleParams {
@@ -427,7 +427,7 @@ interface DeleteTableStyleParams {
   /** Delete even though a table on some slide still references this style. */
   force?: boolean;
 }
-declare function deleteTableStyle(ctx: ToolContext, params: DeleteTableStyleParams): ToolResult<{
+export declare function deleteTableStyle(ctx: ToolContext, params: DeleteTableStyleParams): ToolResult<{
   deleted: boolean;
 }>;
 interface AssignTableStyleParams {
@@ -453,7 +453,7 @@ interface AssignTableStyleParams {
  * both new and previously-loaded tables (`save-table-merge-helpers.ts`); this
  * tool just exposes that assignment over MCP.
  */
-declare function assignTableStyle(ctx: ToolContext, params: AssignTableStyleParams): ToolResult<{
+export declare function assignTableStyle(ctx: ToolContext, params: AssignTableStyleParams): ToolResult<{
   elementId: string;
   styleId: string;
 }>;
@@ -518,7 +518,7 @@ interface UpdateElementStyleParams {
    */
   title?: string;
 }
-declare function updateElementStyle(ctx: ToolContext, params: UpdateElementStyleParams): ToolResult<{
+export declare function updateElementStyle(ctx: ToolContext, params: UpdateElementStyleParams): ToolResult<{
   elementId: string;
 }>;
 interface AccessibilityIssue {
@@ -535,7 +535,7 @@ interface AccessibilityCheckResult {
   infoCount: number;
   issues: AccessibilityIssue[];
 }
-declare function runAccessibilityCheck(ctx: ToolContext): ToolResult<AccessibilityCheckResult>;
+export declare function runAccessibilityCheck(ctx: ToolContext): ToolResult<AccessibilityCheckResult>;
 //#endregion
 //#region src/tools/content-tools.d.ts
 interface FindTextParams {
@@ -556,7 +556,7 @@ interface FindTextResult {
   matchCount: number;
   matches: TextMatch[];
 }
-declare function findText(ctx: ToolContext, params: FindTextParams): ToolResult<FindTextResult>;
+export declare function findText(ctx: ToolContext, params: FindTextParams): ToolResult<FindTextResult>;
 interface ReplaceTextParams {
   query: string;
   replacement: string;
@@ -569,7 +569,7 @@ interface ReplaceTextResult {
   replacement: string;
   replacementCount: number;
 }
-declare function replaceText(ctx: ToolContext, params: ReplaceTextParams): ToolResult<ReplaceTextResult>;
+export declare function replaceText(ctx: ToolContext, params: ReplaceTextParams): ToolResult<ReplaceTextResult>;
 interface ManageCommentsParams {
   action: 'list' | 'add' | 'delete' | 'resolve';
   slideIndex?: number;
@@ -593,7 +593,7 @@ interface ManageCommentsResult {
   commentId?: string;
   count?: number;
 }
-declare function manageComments(ctx: ToolContext, params: ManageCommentsParams): ToolResult<ManageCommentsResult>;
+export declare function manageComments(ctx: ToolContext, params: ManageCommentsParams): ToolResult<ManageCommentsResult>;
 //#endregion
 //#region src/tools/conversion-tools.d.ts
 interface ConvertToMarkdownParams {
@@ -634,7 +634,7 @@ interface ConvertToMarkdownResult {
   totalSlides: number;
   imagesExtracted: number;
 }
-declare function convertToMarkdown(ctx: ToolContext, params: ConvertToMarkdownParams): Promise<ToolResult<ConvertToMarkdownResult>>;
+export declare function convertToMarkdown(ctx: ToolContext, params: ConvertToMarkdownParams): Promise<ToolResult<ConvertToMarkdownResult>>;
 //#endregion
 //#region src/tools/theme-tools.d.ts
 interface ThemeInfo {
@@ -643,7 +643,7 @@ interface ThemeInfo {
   fontScheme?: PptxThemeFontScheme;
   availablePresets: string[];
 }
-declare function getThemeInfo(ctx: ToolContext): ToolResult<ThemeInfo>;
+export declare function getThemeInfo(ctx: ToolContext): ToolResult<ThemeInfo>;
 interface ApplyThemePresetParams {
   presetName: string;
 }
@@ -651,7 +651,7 @@ interface ApplyThemePresetResult {
   appliedPreset: string;
   colorScheme: PptxThemeColorScheme;
 }
-declare function applyThemePreset(ctx: ToolContext, params: ApplyThemePresetParams): ToolResult<ApplyThemePresetResult>;
+export declare function applyThemePreset(ctx: ToolContext, params: ApplyThemePresetParams): ToolResult<ApplyThemePresetResult>;
 interface UpdateThemeColorsParams {
   dk1?: string;
   lt1?: string;
@@ -666,14 +666,14 @@ interface UpdateThemeColorsParams {
   hlink?: string;
   folHlink?: string;
 }
-declare function updateThemeColors(ctx: ToolContext, params: UpdateThemeColorsParams): ToolResult<{
+export declare function updateThemeColors(ctx: ToolContext, params: UpdateThemeColorsParams): ToolResult<{
   colorScheme: PptxThemeColorScheme;
 }>;
 interface UpdateThemeFontsParams {
   majorFont?: string;
   minorFont?: string;
 }
-declare function updateThemeFonts(ctx: ToolContext, params: UpdateThemeFontsParams): ToolResult<{
+export declare function updateThemeFonts(ctx: ToolContext, params: UpdateThemeFontsParams): ToolResult<{
   fontScheme: PptxThemeFontScheme;
 }>;
 //#endregion
@@ -701,7 +701,7 @@ interface UpdateChartParams {
   };
   categories?: string[];
 }
-declare function updateChart(ctx: ToolContext, params: UpdateChartParams): ToolResult<{
+export declare function updateChart(ctx: ToolContext, params: UpdateChartParams): ToolResult<{
   elementId: string;
 }>;
 interface AddChartSeriesParams {
@@ -711,7 +711,7 @@ interface AddChartSeriesParams {
   values: number[];
   color?: string;
 }
-declare function addChartSeriesT(ctx: ToolContext, params: AddChartSeriesParams): ToolResult<{
+export declare function addChartSeriesT(ctx: ToolContext, params: AddChartSeriesParams): ToolResult<{
   elementId: string;
   seriesCount: number;
 }>;
@@ -720,7 +720,7 @@ interface RemoveChartSeriesParams {
   elementId: string;
   seriesIndex: number;
 }
-declare function removeChartSeriesT(ctx: ToolContext, params: RemoveChartSeriesParams): ToolResult<{
+export declare function removeChartSeriesT(ctx: ToolContext, params: RemoveChartSeriesParams): ToolResult<{
   elementId: string;
   seriesCount: number;
 }>;
@@ -730,7 +730,7 @@ interface UpdateChartSeriesDataParams {
   seriesIndex: number;
   values: number[];
 }
-declare function updateChartSeriesData(ctx: ToolContext, params: UpdateChartSeriesDataParams): ToolResult<{
+export declare function updateChartSeriesData(ctx: ToolContext, params: UpdateChartSeriesDataParams): ToolResult<{
   elementId: string;
 }>;
 interface CreateChartParams {
@@ -756,7 +756,7 @@ interface CreateChartResult {
   elementId: string;
   slideIndex: number;
 }
-declare function createChart(ctx: ToolContext, params: CreateChartParams): ToolResult<CreateChartResult>;
+export declare function createChart(ctx: ToolContext, params: CreateChartParams): ToolResult<CreateChartResult>;
 //#endregion
 //#region src/tools/chart-formatting-tools.d.ts
 interface FormatChartDataPointParams {
@@ -779,7 +779,7 @@ interface FormatChartDataPointParams {
     fillColor?: string;
   } | null;
 }
-declare function formatChartDataPoint(ctx: ToolContext, params: FormatChartDataPointParams): ToolResult<{
+export declare function formatChartDataPoint(ctx: ToolContext, params: FormatChartDataPointParams): ToolResult<{
   elementId: string;
 }>;
 interface FormatChartDataLabelParams {
@@ -813,7 +813,7 @@ interface FormatChartDataLabelParams {
     color?: string;
   } | null;
 }
-declare function formatChartDataLabel(ctx: ToolContext, params: FormatChartDataLabelParams): ToolResult<{
+export declare function formatChartDataLabel(ctx: ToolContext, params: FormatChartDataLabelParams): ToolResult<{
   elementId: string;
 }>;
 interface FormatChartSeriesParams {
@@ -843,7 +843,7 @@ interface FormatChartSeriesParams {
     dashStyle?: string;
   }) | null;
 }
-declare function formatChartSeries(ctx: ToolContext, params: FormatChartSeriesParams): ToolResult<{
+export declare function formatChartSeries(ctx: ToolContext, params: FormatChartSeriesParams): ToolResult<{
   elementId: string;
 }>;
 interface SetChartHelperLineParams {
@@ -857,7 +857,7 @@ interface SetChartHelperLineParams {
     dashStyle?: string;
   } | null;
 }
-declare function setChartHelperLineT(ctx: ToolContext, params: SetChartHelperLineParams): ToolResult<{
+export declare function setChartHelperLineT(ctx: ToolContext, params: SetChartHelperLineParams): ToolResult<{
   elementId: string;
 }>;
 interface SetChartColorMapOverrideParams {
@@ -866,7 +866,7 @@ interface SetChartColorMapOverrideParams {
   /** `null` removes the override entirely. */
   overrides: Record<string, string> | null;
 }
-declare function setChartColorMapOverrideT(ctx: ToolContext, params: SetChartColorMapOverrideParams): ToolResult<{
+export declare function setChartColorMapOverrideT(ctx: ToolContext, params: SetChartColorMapOverrideParams): ToolResult<{
   elementId: string;
 }>;
 //#endregion
@@ -898,7 +898,7 @@ interface ListChartUserShapesParams {
   slideIndex: number;
   elementId: string;
 }
-declare function listChartUserShapesT(ctx: ToolContext, params: ListChartUserShapesParams): ToolResult<{
+export declare function listChartUserShapesT(ctx: ToolContext, params: ListChartUserShapesParams): ToolResult<{
   shapes: PptxChartUserShape[];
 }>;
 interface AddChartUserShapeParams {
@@ -906,7 +906,7 @@ interface AddChartUserShapeParams {
   elementId: string;
   shape: ChartUserShapeInput;
 }
-declare function addChartUserShapeT(ctx: ToolContext, params: AddChartUserShapeParams): ToolResult<{
+export declare function addChartUserShapeT(ctx: ToolContext, params: AddChartUserShapeParams): ToolResult<{
   elementId: string;
   index: number;
 }>;
@@ -916,7 +916,7 @@ interface UpdateChartUserShapeParams {
   index: number;
   patch: Partial<ChartUserShapeInput>;
 }
-declare function updateChartUserShapeT(ctx: ToolContext, params: UpdateChartUserShapeParams): ToolResult<{
+export declare function updateChartUserShapeT(ctx: ToolContext, params: UpdateChartUserShapeParams): ToolResult<{
   elementId: string;
 }>;
 interface RemoveChartUserShapeParams {
@@ -924,7 +924,7 @@ interface RemoveChartUserShapeParams {
   elementId: string;
   index: number;
 }
-declare function removeChartUserShapeT(ctx: ToolContext, params: RemoveChartUserShapeParams): ToolResult<{
+export declare function removeChartUserShapeT(ctx: ToolContext, params: RemoveChartUserShapeParams): ToolResult<{
   elementId: string;
 }>;
 //#endregion
@@ -949,7 +949,7 @@ interface ManageSmartArtResult {
   nodes?: SmartArtNodeInfo[];
   decomposedCount?: number;
 }
-declare function manageSmartArt(ctx: ToolContext, params: ManageSmartArtParams): ToolResult<ManageSmartArtResult>;
+export declare function manageSmartArt(ctx: ToolContext, params: ManageSmartArtParams): ToolResult<ManageSmartArtResult>;
 //#endregion
 //#region src/tools/merge-tools.d.ts
 interface MergePresentationParams {
@@ -966,19 +966,19 @@ interface MergePresentationResult {
   slidesAdded: number;
   totalSlides: number;
 }
-declare function mergePresentationT(ctx: ToolContext, params: MergePresentationParams): ToolResult<MergePresentationResult>;
+export declare function mergePresentationT(ctx: ToolContext, params: MergePresentationParams): ToolResult<MergePresentationResult>;
 interface DiffPresentationsParams {
   /** The other presentation data to diff against. */
   otherData: PptxData$1;
 }
-declare function diffPresentationsT(ctx: ToolContext, params: DiffPresentationsParams): ToolResult<PresentationDiff>;
+export declare function diffPresentationsT(ctx: ToolContext, params: DiffPresentationsParams): ToolResult<PresentationDiff>;
 //#endregion
 //#region src/tools/template-tools.d.ts
 interface FindPlaceholdersResult {
   placeholders: string[];
   count: number;
 }
-declare function findPlaceholdersT(ctx: ToolContext): ToolResult<FindPlaceholdersResult>;
+export declare function findPlaceholdersT(ctx: ToolContext): ToolResult<FindPlaceholdersResult>;
 interface ApplyTemplateParams {
   data: Record<string, unknown>;
 }
@@ -986,7 +986,7 @@ interface ApplyTemplateResult {
   applied: boolean;
   slideCount: number;
 }
-declare function applyTemplateT(ctx: ToolContext, params: ApplyTemplateParams): ToolResult<ApplyTemplateResult>;
+export declare function applyTemplateT(ctx: ToolContext, params: ApplyTemplateParams): ToolResult<ApplyTemplateResult>;
 //#endregion
 //#region src/tools/metadata-tools.d.ts
 interface MetadataResult {
@@ -995,7 +995,7 @@ interface MetadataResult {
   customProperties?: PptxCustomProperty[];
   slideCount: number;
 }
-declare function getMetadata(ctx: ToolContext): ToolResult<MetadataResult>;
+export declare function getMetadata(ctx: ToolContext): ToolResult<MetadataResult>;
 interface UpdateMetadataParams {
   title?: string;
   subject?: string;
@@ -1011,7 +1011,7 @@ interface UpdateMetadataParams {
     value: string | number | boolean;
   }>;
 }
-declare function updateMetadata(ctx: ToolContext, params: UpdateMetadataParams): ToolResult<{
+export declare function updateMetadata(ctx: ToolContext, params: UpdateMetadataParams): ToolResult<{
   updated: string[];
 }>;
 //#endregion
@@ -1037,7 +1037,7 @@ interface ManageSectionsResult {
   section?: SectionInfo | null;
   success?: boolean;
 }
-declare function manageSections(ctx: ToolContext, params: ManageSectionsParams): ToolResult<ManageSectionsResult>;
+export declare function manageSections(ctx: ToolContext, params: ManageSectionsParams): ToolResult<ManageSectionsResult>;
 //#endregion
 //#region src/tools/export-tools.d.ts
 interface ExportToSvgParams {
@@ -1050,7 +1050,7 @@ interface ExportToSvgResult {
   svgStrings: string[];
   slideCount: number;
 }
-declare function exportToSvg(ctx: ToolContext, params: ExportToSvgParams): ToolResult<ExportToSvgResult>;
+export declare function exportToSvg(ctx: ToolContext, params: ExportToSvgParams): ToolResult<ExportToSvgResult>;
 interface ExportSlideSvgParams {
   slideIndex: number;
   defaultFontFamily?: string;
@@ -1060,7 +1060,7 @@ interface ExportSlideSvgResult {
   svg: string;
   slideIndex: number;
 }
-declare function exportSlideSvg(ctx: ToolContext, params: ExportSlideSvgParams): ToolResult<ExportSlideSvgResult>;
+export declare function exportSlideSvg(ctx: ToolContext, params: ExportSlideSvgParams): ToolResult<ExportSlideSvgResult>;
 //#endregion
 //#region src/tools/json-tools.d.ts
 interface ExportToJsonParams {
@@ -1080,7 +1080,7 @@ interface ExportToJsonResult {
  * Serialize the presentation to the portable, self-contained
  * `pptx-viewer-json` document format (binary assets embedded as base64).
  */
-declare function exportToJson(ctx: ToolContext, params: ExportToJsonParams): ToolResult<ExportToJsonResult>;
+export declare function exportToJson(ctx: ToolContext, params: ExportToJsonParams): ToolResult<ExportToJsonResult>;
 interface ImportFromJsonParams {
   /** The `pptx-viewer-json` document text to import. */
   json: string;
@@ -1097,7 +1097,7 @@ interface ImportFromJsonResult {
  * `pptxData` object is mutated in place so hosts holding a reference (viewer
  * bridges, the save pipeline) observe the imported deck.
  */
-declare function importFromJson(ctx: ToolContext, params: ImportFromJsonParams): ToolResult<ImportFromJsonResult>;
+export declare function importFromJson(ctx: ToolContext, params: ImportFromJsonParams): ToolResult<ImportFromJsonResult>;
 //#endregion
 //#region src/tools/hyperlink-tools.d.ts
 interface ManageHyperlinksParams {
@@ -1123,7 +1123,7 @@ interface ManageHyperlinksResult {
   hyperlinks?: HyperlinkInfo[];
   elementId?: string;
 }
-declare function manageHyperlinks(ctx: ToolContext, params: ManageHyperlinksParams): ToolResult<ManageHyperlinksResult>;
+export declare function manageHyperlinks(ctx: ToolContext, params: ManageHyperlinksParams): ToolResult<ManageHyperlinksResult>;
 //#endregion
 //#region src/tools/geometry-tools.d.ts
 interface ReplaceGeometryParams {
@@ -1140,7 +1140,7 @@ interface ReplaceGeometryParams {
   /** Adjustment values for the new geometry. */
   adjustments?: Record<string, number>;
 }
-declare function replaceGeometry(ctx: ToolContext, params: ReplaceGeometryParams): ToolResult<{
+export declare function replaceGeometry(ctx: ToolContext, params: ReplaceGeometryParams): ToolResult<{
   elementId: string;
   geometryType: string;
 }>;
@@ -1156,7 +1156,7 @@ interface SetElementLockParams {
   noSelect?: boolean;
   noTextEdit?: boolean;
 }
-declare function setElementLockT(ctx: ToolContext, params: SetElementLockParams): ToolResult<{
+export declare function setElementLockT(ctx: ToolContext, params: SetElementLockParams): ToolResult<{
   elementId: string;
   locked: boolean;
 }>;
@@ -1179,18 +1179,18 @@ interface ValidatePresentationResult {
  * handling: the MCP server must pass rawBytes alongside the context.
  * We store a reference in ToolContext via resolveMedia or pass it directly.
  */
-declare function validatePresentation(rawBytes: ArrayBuffer): Promise<ValidatePresentationResult>;
+export declare function validatePresentation(rawBytes: ArrayBuffer): Promise<ValidatePresentationResult>;
 interface RepairPresentationResult {
   repairCount: number;
   repairs: string[];
 }
-declare function repairPresentation(rawBytes: ArrayBuffer): Promise<{
+export declare function repairPresentation(rawBytes: ArrayBuffer): Promise<{
   result: RepairPresentationResult;
   repairedBytes: ArrayBuffer;
 }>;
 //#endregion
 //#region src/tools/presentation-tools.d.ts
-declare function getPresentationProperties(ctx: ToolContext): ToolResult<{
+export declare function getPresentationProperties(ctx: ToolContext): ToolResult<{
   properties: PptxPresentationProperties | undefined;
   slideCount: number;
   width?: number;
@@ -1207,7 +1207,7 @@ interface UpdatePresentationPropertiesParams {
   showSlidesTo?: number;
   penColor?: string;
 }
-declare function updatePresentationProperties(ctx: ToolContext, params: UpdatePresentationPropertiesParams): ToolResult<{
+export declare function updatePresentationProperties(ctx: ToolContext, params: UpdatePresentationPropertiesParams): ToolResult<{
   properties: PptxPresentationProperties;
 }>;
 //#endregion
@@ -1221,7 +1221,7 @@ interface GetLayoutsResult {
   layouts: LayoutInfo[];
   count: number;
 }
-declare function getLayouts(ctx: ToolContext): ToolResult<GetLayoutsResult>;
+export declare function getLayouts(ctx: ToolContext): ToolResult<GetLayoutsResult>;
 interface ApplyLayoutParams {
   slideIndex: number;
   layoutName?: string;
@@ -1231,7 +1231,102 @@ interface ApplyLayoutResult {
   slideIndex: number;
   layoutName: string;
 }
-declare function applyLayout(ctx: ToolContext, params: ApplyLayoutParams): ToolResult<ApplyLayoutResult>;
+export declare function applyLayout(ctx: ToolContext, params: ApplyLayoutParams): ToolResult<ApplyLayoutResult>;
 //#endregion
-export { type AccessibilityCheckResult, type AccessibilityIssue, type AddChartSeriesParams, type AddChartUserShapeParams, type AddElementParams, type AddElementResult, type AddSlideParams, type AddSlideResult, type ApplyLayoutParams, type ApplyLayoutResult, type ApplyTemplateParams, type ApplyTemplateResult, type ApplyThemePresetParams, type ApplyThemePresetResult, type ArrangeElementsParams, type AssignTableStyleParams, type BatchUpdateElementsParams, type ChartUserShapeInput, type CloneElementParams, type CloneElementResult, type CollaborationProvider, type CommentInfo, type ConvertToMarkdownParams, type ConvertToMarkdownResult, type CreateChartParams, type CreateChartResult, type CreateTableStyleParams, type DeleteElementsParams, type DeleteSlidesParams, type DeleteSlidesResult, type DeleteTableStyleParams, type DiffPresentationsParams, type DuplicateSlideParams, type ExecutionContext, type ExportSlideSvgParams, type ExportSlideSvgResult, type ExportToJsonParams, type ExportToJsonResult, type ExportToSvgParams, type ExportToSvgResult, type FileSystemProvider, type FindPlaceholdersResult, type FindTextParams, type FindTextResult, type FormatChartDataLabelParams, type FormatChartDataPointParams, type FormatChartSeriesParams, type GetLayoutsResult, type GetSlideResult, type GroupElementsParams, type GroupElementsResult, type HyperlinkInfo, type ImportFromJsonParams, type ImportFromJsonResult, type LayoutInfo, type ListChartUserShapesParams, type ManageCommentsParams, type ManageCommentsResult, type ManageHyperlinksParams, type ManageHyperlinksResult, type ManageSectionsParams, type ManageSectionsResult, type ManageSmartArtParams, type ManageSmartArtResult, type ManageTableStructureParams, type MergePresentationParams, type MergePresentationResult, type MetadataResult, type PptxData, type PptxElement, PptxHandler, type PptxSlide, type RemoveChartSeriesParams, type RemoveChartUserShapeParams, type RenameElementParams, type ReorderSlidesParams, type RepairPresentationResult, type ReplaceGeometryParams, type ReplaceTextParams, type ReplaceTextResult, type SectionInfo, type SetCanvasSizeParams, type SetChartColorMapOverrideParams, type SetChartHelperLineParams, type SetElementAnimationParams, type SetElementLockParams, type SetSlideTransitionParams, type SetTableStyleSectionParams, type SmartArtNodeInfo, type TextMatch, type ThemeInfo, type ToolContext, type ToolResult, type UngroupElementsParams, type UngroupElementsResult, type UpdateChartParams, type UpdateChartSeriesDataParams, type UpdateChartUserShapeParams, type UpdateElementParams, type UpdateElementStyleParams, type UpdateMetadataParams, type UpdatePresentationPropertiesParams, type UpdateSlidePropertiesParams, type UpdateTableCellsParams, type UpdateThemeColorsParams, type UpdateThemeFontsParams, type ValidatePresentationResult, type ViewerProvider, addChartSeriesT, addChartUserShapeT, addElement, addSlide, applyLayout, applyTemplateT, applyThemePreset, arrangeElements, assignTableStyle, batchUpdateElements, cloneElement, convertToMarkdown, createChart, createTableStyle, deleteElements, deleteSlides, deleteTableStyle, describeElement, diffPresentationsT, duplicateSlide, executeToolWithContext, exportSlideSvg, exportToJson, exportToSvg, extractSlideText, findPlaceholdersT, findText, formatChartDataLabel, formatChartDataPoint, formatChartSeries, generateElementId, generateSlideId, getLayouts, getMetadata, getPresentationProperties, getSlide, getThemeInfo, groupElements, importFromJson, listChartUserShapesT, loadPresentation, manageComments, manageHyperlinks, manageSections, manageSmartArt, manageTableStructure, mergePresentationT, removeChartSeriesT, removeChartUserShapeT, renameElement, reorderSlides, repairPresentation, replaceGeometry, replaceText, runAccessibilityCheck, savePresentation, setCanvasSize, setChartColorMapOverrideT, setChartHelperLineT, setElementAnimation, setElementLockT, setSlideTransition, setTableStyleSection, ungroupElements, updateChart, updateChartSeriesData, updateChartUserShapeT, updateElement, updateElementStyle, updateMetadata, updatePresentationProperties, updateSlideProperties, updateTableCells, updateThemeColors, updateThemeFonts, validatePresentation, validateSlideIndex };
+//#region src/tools/ole-tools.d.ts
+interface GetOleContentParams {
+  slideIndex: number;
+  elementId: string;
+}
+interface GetOleContentResult {
+  elementId: string;
+  /** Which in-place editor applies to the object's current payload. */
+  kind: OlePayloadEditorKind;
+  /** Whether `ole_set_*` can act on this object; `false` steers to `ole_replace_file`. */
+  editable: boolean;
+  /** Human-readable note, set when `editable` is `false`. */
+  message?: string;
+  /** Present when `kind` is `sheet-xlsx` or `sheet-xls`. */
+  sheet?: OleSheetGrid;
+  /** Present when `kind` is `document-docx` or `document-doc`. */
+  paragraphs?: string[];
+  /** Present when `kind` is `deck-pptx`: every slide's text-element inventory. */
+  deckSlides?: OleNestedDeckSlideDetail[];
+}
+/**
+ * Describe an OLE object's editable content: the resolved payload kind, plus
+ * whichever of the sheet grid / paragraph list / nested-deck slide summaries
+ * applies. `file` (anything unsupported, or a missing/unreadable payload, or
+ * a `document-doc` this editor declined to touch, see `getOleDocumentParagraphs`
+ * in `pptx-viewer-core`) comes back as not editable in place; the caller
+ * should use {@link replaceOleFileT} instead.
+ */
+export declare function getOleContent(ctx: ToolContext, params: GetOleContentParams): Promise<ToolResult<GetOleContentResult>>;
+interface SetOleContentResult {
+  elementId: string;
+  /** `false` when the edit was a no-op (e.g. value unchanged, or wrong payload kind). */
+  changed: boolean;
+}
+interface SetOleSheetCellParams {
+  slideIndex: number;
+  elementId: string;
+  row: number;
+  col: number;
+  value: string;
+}
+/** Edit one cell of an Excel-payload (`.xlsx`/`.xls`) OLE object's first worksheet. */
+export declare function setOleSheetCell(ctx: ToolContext, params: SetOleSheetCellParams): Promise<ToolResult<SetOleContentResult>>;
+interface SetOleDocumentParagraphParams {
+  slideIndex: number;
+  elementId: string;
+  paragraphIndex: number;
+  text: string;
+}
+/** Replace one paragraph's text in a Word-payload (`.docx` or legacy binary `.doc`) OLE object. */
+export declare function setOleDocumentParagraph(ctx: ToolContext, params: SetOleDocumentParagraphParams): Promise<ToolResult<SetOleContentResult>>;
+interface SetOleDeckSlideTitleParams {
+  slideIndex: number;
+  elementId: string;
+  deckSlideIndex: number;
+  /** The id of the text-bearing shape to edit, from `ole_get_content`'s `deckSlides[n].elements[i].elementId`. */
+  deckElementId: string;
+  title: string;
+}
+/**
+ * Replace one specific text-bearing shape's text on one slide of a
+ * nested-deck (embedded PowerPoint) OLE object: a full round-trip through
+ * the nested deck's own `PptxHandler` load/save, so any text-bearing shape
+ * on any slide is a real edit target, not only a fixed "title" slot. Call
+ * `ole_get_content` first to discover each slide's `elementId`s.
+ */
+export declare function setOleDeckSlideTitle(ctx: ToolContext, params: SetOleDeckSlideTitleParams): Promise<ToolResult<SetOleContentResult>>;
+interface SetOleObjectNameParams {
+  slideIndex: number;
+  elementId: string;
+  /** New Object Name (`p:oleObj/@name`); blank/whitespace clears it. */
+  name: string;
+}
+/**
+ * Rename an OLE object's Object Name (`p:oleObj/@name`). When the object is
+ * displayed `showAsIcon`, this also regenerates the baked-in icon caption
+ * (see `setOleObjectName` in `pptx-viewer-core`) so the new name is visible
+ * once the deck is reopened in real PowerPoint.
+ */
+export declare function setOleObjectNameT(ctx: ToolContext, params: SetOleObjectNameParams): Promise<ToolResult<SetOleContentResult>>;
+interface ReplaceOleFileParams {
+  slideIndex: number;
+  elementId: string;
+  /** New payload as a base64 data URL, e.g. `data:application/pdf;base64,...`. */
+  fileData: string;
+  /** Optional new file name; also updates the resolved MIME type. */
+  fileName?: string;
+}
+/**
+ * Replace an OLE object's payload wholesale with an arbitrary file. Always
+ * available regardless of the object's current kind, and the only edit
+ * available for a generic "Package" object or an unsupported format.
+ */
+export declare function replaceOleFileT(ctx: ToolContext, params: ReplaceOleFileParams): Promise<ToolResult<SetOleContentResult>>;
+//#endregion
+export { type AccessibilityCheckResult, type AccessibilityIssue, type AddChartSeriesParams, type AddChartUserShapeParams, type AddElementParams, type AddElementResult, type AddSlideParams, type AddSlideResult, type ApplyLayoutParams, type ApplyLayoutResult, type ApplyTemplateParams, type ApplyTemplateResult, type ApplyThemePresetParams, type ApplyThemePresetResult, type ArrangeElementsParams, type AssignTableStyleParams, type BatchUpdateElementsParams, type ChartUserShapeInput, type CloneElementParams, type CloneElementResult, type CollaborationProvider, type CommentInfo, type ConvertToMarkdownParams, type ConvertToMarkdownResult, type CreateChartParams, type CreateChartResult, type CreateTableStyleParams, type DeleteElementsParams, type DeleteSlidesParams, type DeleteSlidesResult, type DeleteTableStyleParams, type DiffPresentationsParams, type DuplicateSlideParams, type ExecutionContext, type ExportSlideSvgParams, type ExportSlideSvgResult, type ExportToJsonParams, type ExportToJsonResult, type ExportToSvgParams, type ExportToSvgResult, type FileSystemProvider, type FindPlaceholdersResult, type FindTextParams, type FindTextResult, type FormatChartDataLabelParams, type FormatChartDataPointParams, type FormatChartSeriesParams, type GetLayoutsResult, type GetOleContentParams, type GetOleContentResult, type GetSlideResult, type GroupElementsParams, type GroupElementsResult, type HyperlinkInfo, type ImportFromJsonParams, type ImportFromJsonResult, type LayoutInfo, type ListChartUserShapesParams, type ManageCommentsParams, type ManageCommentsResult, type ManageHyperlinksParams, type ManageHyperlinksResult, type ManageSectionsParams, type ManageSectionsResult, type ManageSmartArtParams, type ManageSmartArtResult, type ManageTableStructureParams, type MergePresentationParams, type MergePresentationResult, type MetadataResult, type PptxData, type PptxElement, PptxHandler, type PptxSlide, type RemoveChartSeriesParams, type RemoveChartUserShapeParams, type RenameElementParams, type ReorderSlidesParams, type RepairPresentationResult, type ReplaceGeometryParams, type ReplaceOleFileParams, type ReplaceTextParams, type ReplaceTextResult, type SectionInfo, type SetCanvasSizeParams, type SetChartColorMapOverrideParams, type SetChartHelperLineParams, type SetElementAnimationParams, type SetElementLockParams, type SetOleContentResult, type SetOleDeckSlideTitleParams, type SetOleDocumentParagraphParams, type SetOleObjectNameParams, type SetOleSheetCellParams, type SetSlideTransitionParams, type SetTableStyleSectionParams, type SmartArtNodeInfo, type TextMatch, type ThemeInfo, type ToolContext, type ToolResult, type UngroupElementsParams, type UngroupElementsResult, type UpdateChartParams, type UpdateChartSeriesDataParams, type UpdateChartUserShapeParams, type UpdateElementParams, type UpdateElementStyleParams, type UpdateMetadataParams, type UpdatePresentationPropertiesParams, type UpdateSlidePropertiesParams, type UpdateTableCellsParams, type UpdateThemeColorsParams, type UpdateThemeFontsParams, type ValidatePresentationResult, type ViewerProvider };
 //# sourceMappingURL=index.d.ts.map