pptx-viewer-mcp 1.1.27 → 1.2.0

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { PptxData, PptxElement, PptxSlide, ShapeStyle } from 'pptx-viewer-core';
+import { PptxData, PptxElement, PptxSlide, ShapeStyle, PptxThemeColorScheme, PptxThemeFontScheme, ChartAxisEdit, PresentationDiff, PptxCoreProperties, PptxAppProperties, PptxCustomProperty, PptxPresentationProperties } from 'pptx-viewer-core';
 export { PptxData, PptxElement, PptxHandler, PptxSlide } from 'pptx-viewer-core';
 import { Doc } from 'yjs';
 
@@ -483,4 +483,380 @@ interface ConvertToMarkdownResult {
 }
 declare function convertToMarkdown(ctx: ToolContext, params: ConvertToMarkdownParams): Promise<ToolResult<ConvertToMarkdownResult>>;
 
-export { type AccessibilityCheckResult, type AccessibilityIssue, type AddElementParams, type AddElementResult, type AddSlideParams, type AddSlideResult, type ArrangeElementsParams, type BatchUpdateElementsParams, type CloneElementParams, type CloneElementResult, type CollaborationProvider, type CommentInfo, type ConvertToMarkdownParams, type ConvertToMarkdownResult, type DeleteElementsParams, type DeleteSlidesParams, type DeleteSlidesResult, type DuplicateSlideParams, type ExecutionContext, type FileSystemProvider, type FindTextParams, type FindTextResult, type GetSlideResult, type GroupElementsParams, type GroupElementsResult, type ManageCommentsParams, type ManageCommentsResult, type ManageTableStructureParams, type ReorderSlidesParams, type ReplaceTextParams, type ReplaceTextResult, type SetCanvasSizeParams, type SetElementAnimationParams, type SetSlideTransitionParams, type TextMatch, type ToolContext, type ToolResult, type UngroupElementsParams, type UngroupElementsResult, type UpdateElementParams, type UpdateElementStyleParams, type UpdateSlidePropertiesParams, type UpdateTableCellsParams, type ViewerProvider, addElement, addSlide, arrangeElements, batchUpdateElements, cloneElement, convertToMarkdown, deleteElements, deleteSlides, describeElement, duplicateSlide, executeToolWithContext, extractSlideText, findText, generateElementId, generateSlideId, getSlide, groupElements, loadPresentation, manageComments, manageTableStructure, reorderSlides, replaceText, runAccessibilityCheck, savePresentation, setCanvasSize, setElementAnimation, setSlideTransition, ungroupElements, updateElement, updateElementStyle, updateSlideProperties, updateTableCells, validateSlideIndex };
+interface ThemeInfo {
+    themeName?: string;
+    colorScheme?: PptxThemeColorScheme;
+    fontScheme?: PptxThemeFontScheme;
+    availablePresets: string[];
+}
+declare function getThemeInfo(ctx: ToolContext): ToolResult<ThemeInfo>;
+interface ApplyThemePresetParams {
+    presetName: string;
+}
+interface ApplyThemePresetResult {
+    appliedPreset: string;
+    colorScheme: PptxThemeColorScheme;
+}
+declare function applyThemePreset(ctx: ToolContext, params: ApplyThemePresetParams): ToolResult<ApplyThemePresetResult>;
+interface UpdateThemeColorsParams {
+    dk1?: string;
+    lt1?: string;
+    dk2?: string;
+    lt2?: string;
+    accent1?: string;
+    accent2?: string;
+    accent3?: string;
+    accent4?: string;
+    accent5?: string;
+    accent6?: string;
+    hlink?: string;
+    folHlink?: string;
+}
+declare function updateThemeColors(ctx: ToolContext, params: UpdateThemeColorsParams): ToolResult<{
+    colorScheme: PptxThemeColorScheme;
+}>;
+interface UpdateThemeFontsParams {
+    majorFont?: string;
+    minorFont?: string;
+}
+declare function updateThemeFonts(ctx: ToolContext, params: UpdateThemeFontsParams): ToolResult<{
+    fontScheme: PptxThemeFontScheme;
+}>;
+
+interface UpdateChartParams {
+    slideIndex: number;
+    elementId: string;
+    chartType?: string;
+    title?: string;
+    grouping?: 'clustered' | 'stacked' | 'percentStacked';
+    legend?: {
+        show?: boolean;
+        position?: string;
+    };
+    dataLabels?: {
+        show?: boolean;
+        showValue?: boolean;
+        showCategory?: boolean;
+        showSeriesName?: boolean;
+        showPercent?: boolean;
+    };
+    axis?: {
+        type: string;
+        edit: ChartAxisEdit;
+    };
+    categories?: string[];
+}
+declare function updateChart(ctx: ToolContext, params: UpdateChartParams): ToolResult<{
+    elementId: string;
+}>;
+interface AddChartSeriesParams {
+    slideIndex: number;
+    elementId: string;
+    name: string;
+    values: number[];
+    color?: string;
+}
+declare function addChartSeriesT(ctx: ToolContext, params: AddChartSeriesParams): ToolResult<{
+    elementId: string;
+    seriesCount: number;
+}>;
+interface RemoveChartSeriesParams {
+    slideIndex: number;
+    elementId: string;
+    seriesIndex: number;
+}
+declare function removeChartSeriesT(ctx: ToolContext, params: RemoveChartSeriesParams): ToolResult<{
+    elementId: string;
+    seriesCount: number;
+}>;
+interface UpdateChartSeriesDataParams {
+    slideIndex: number;
+    elementId: string;
+    seriesIndex: number;
+    values: number[];
+}
+declare function updateChartSeriesData(ctx: ToolContext, params: UpdateChartSeriesDataParams): ToolResult<{
+    elementId: string;
+}>;
+interface CreateChartParams {
+    slideIndex: number;
+    chartType: string;
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+    title?: string;
+    categories?: string[];
+    series?: Array<{
+        name: string;
+        values: number[];
+        color?: string;
+    }>;
+    legend?: {
+        show: boolean;
+        position?: string;
+    };
+}
+interface CreateChartResult {
+    elementId: string;
+    slideIndex: number;
+}
+declare function createChart(ctx: ToolContext, params: CreateChartParams): ToolResult<CreateChartResult>;
+
+interface ManageSmartArtParams {
+    slideIndex: number;
+    elementId: string;
+    action: 'addNode' | 'removeNode' | 'updateNodeText' | 'reorderNode' | 'promoteNode' | 'demoteNode' | 'decompose' | 'getNodes';
+    nodeId?: string;
+    text?: string;
+    afterNodeId?: string;
+    direction?: number;
+}
+interface SmartArtNodeInfo {
+    id: string;
+    text: string;
+    children?: SmartArtNodeInfo[];
+}
+interface ManageSmartArtResult {
+    action: string;
+    elementId: string;
+    nodes?: SmartArtNodeInfo[];
+    decomposedCount?: number;
+}
+declare function manageSmartArt(ctx: ToolContext, params: ManageSmartArtParams): ToolResult<ManageSmartArtResult>;
+
+interface MergePresentationParams {
+    /** The source presentation data to merge FROM. */
+    sourceData: PptxData;
+    /** Specific slide indices from source to merge. If omitted, all slides. */
+    slideIndices?: number[];
+    /** Where to insert in the target (0-based). Defaults to end. */
+    insertAt?: number;
+    /** Whether to keep the source theme. */
+    keepSourceTheme?: boolean;
+}
+interface MergePresentationResult {
+    slidesAdded: number;
+    totalSlides: number;
+}
+declare function mergePresentationT(ctx: ToolContext, params: MergePresentationParams): ToolResult<MergePresentationResult>;
+interface DiffPresentationsParams {
+    /** The other presentation data to diff against. */
+    otherData: PptxData;
+}
+declare function diffPresentationsT(ctx: ToolContext, params: DiffPresentationsParams): ToolResult<PresentationDiff>;
+
+interface FindPlaceholdersResult {
+    placeholders: string[];
+    count: number;
+}
+declare function findPlaceholdersT(ctx: ToolContext): ToolResult<FindPlaceholdersResult>;
+interface ApplyTemplateParams {
+    data: Record<string, unknown>;
+}
+interface ApplyTemplateResult {
+    applied: boolean;
+    slideCount: number;
+}
+declare function applyTemplateT(ctx: ToolContext, params: ApplyTemplateParams): ToolResult<ApplyTemplateResult>;
+
+interface MetadataResult {
+    coreProperties?: PptxCoreProperties;
+    appProperties?: PptxAppProperties;
+    customProperties?: PptxCustomProperty[];
+    slideCount: number;
+}
+declare function getMetadata(ctx: ToolContext): ToolResult<MetadataResult>;
+interface UpdateMetadataParams {
+    title?: string;
+    subject?: string;
+    creator?: string;
+    keywords?: string;
+    description?: string;
+    lastModifiedBy?: string;
+    category?: string;
+    company?: string;
+    manager?: string;
+    customProperties?: Array<{
+        name: string;
+        value: string | number | boolean;
+    }>;
+}
+declare function updateMetadata(ctx: ToolContext, params: UpdateMetadataParams): ToolResult<{
+    updated: string[];
+}>;
+
+interface ManageSectionsParams {
+    action: 'list' | 'add' | 'remove' | 'reorder' | 'moveSlides' | 'getForSlide';
+    name?: string;
+    slideIndices?: number[];
+    sectionId?: string;
+    sectionIds?: string[];
+    slideIndex?: number;
+}
+interface SectionInfo {
+    id: string;
+    name: string;
+    slideIds: string[];
+    collapsed?: boolean;
+    color?: string;
+}
+interface ManageSectionsResult {
+    action: string;
+    sections?: SectionInfo[];
+    section?: SectionInfo | null;
+    success?: boolean;
+}
+declare function manageSections(ctx: ToolContext, params: ManageSectionsParams): ToolResult<ManageSectionsResult>;
+
+interface ExportToSvgParams {
+    slideIndices?: number[];
+    includeHidden?: boolean;
+    defaultFontFamily?: string;
+    defaultFontSize?: number;
+}
+interface ExportToSvgResult {
+    svgStrings: string[];
+    slideCount: number;
+}
+declare function exportToSvg(ctx: ToolContext, params: ExportToSvgParams): ToolResult<ExportToSvgResult>;
+interface ExportSlideSvgParams {
+    slideIndex: number;
+    defaultFontFamily?: string;
+    defaultFontSize?: number;
+}
+interface ExportSlideSvgResult {
+    svg: string;
+    slideIndex: number;
+}
+declare function exportSlideSvg(ctx: ToolContext, params: ExportSlideSvgParams): ToolResult<ExportSlideSvgResult>;
+
+interface ManageHyperlinksParams {
+    slideIndex: number;
+    action: 'list' | 'set' | 'remove';
+    elementId?: string;
+    trigger?: 'click' | 'hover';
+    url?: string;
+    tooltip?: string;
+    targetSlideIndex?: number;
+    actionType?: 'url' | 'slide' | 'nextSlide' | 'prevSlide' | 'firstSlide' | 'lastSlide' | 'endShow';
+}
+interface HyperlinkInfo {
+    elementId: string;
+    trigger: 'click' | 'hover';
+    url?: string;
+    tooltip?: string;
+    targetSlideIndex?: number;
+    actionType?: string;
+}
+interface ManageHyperlinksResult {
+    action: string;
+    hyperlinks?: HyperlinkInfo[];
+    elementId?: string;
+}
+declare function manageHyperlinks(ctx: ToolContext, params: ManageHyperlinksParams): ToolResult<ManageHyperlinksResult>;
+
+interface ReplaceGeometryParams {
+    slideIndex: number;
+    elementId: string;
+    /** New preset shape type (e.g. "roundRect", "star5", "ellipse"). */
+    shapeType?: string;
+    /** Custom SVG path data (mutually exclusive with shapeType). */
+    svgPath?: string;
+    /** Width of the custom path coordinate space. */
+    pathWidth?: number;
+    /** Height of the custom path coordinate space. */
+    pathHeight?: number;
+    /** Adjustment values for the new geometry. */
+    adjustments?: Record<string, number>;
+}
+declare function replaceGeometry(ctx: ToolContext, params: ReplaceGeometryParams): ToolResult<{
+    elementId: string;
+    geometryType: string;
+}>;
+
+interface SetElementLockParams {
+    slideIndex: number;
+    elementId: string;
+    locked: boolean;
+    noMove?: boolean;
+    noResize?: boolean;
+    noRotation?: boolean;
+    noSelect?: boolean;
+    noTextEdit?: boolean;
+}
+declare function setElementLockT(ctx: ToolContext, params: SetElementLockParams): ToolResult<{
+    elementId: string;
+    locked: boolean;
+}>;
+
+interface ValidatePresentationResult {
+    valid: boolean;
+    issueCount: number;
+    errors: number;
+    warnings: number;
+    issues: Array<{
+        severity: string;
+        code: string;
+        message: string;
+        path?: string;
+    }>;
+}
+/**
+ * Validate requires the raw bytes (ArrayBuffer) so this tool needs special
+ * 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>;
+interface RepairPresentationResult {
+    repairCount: number;
+    repairs: string[];
+}
+declare function repairPresentation(rawBytes: ArrayBuffer): Promise<{
+    result: RepairPresentationResult;
+    repairedBytes: ArrayBuffer;
+}>;
+
+declare function getPresentationProperties(ctx: ToolContext): ToolResult<{
+    properties: PptxPresentationProperties | undefined;
+    slideCount: number;
+    width?: number;
+    height?: number;
+}>;
+interface UpdatePresentationPropertiesParams {
+    showType?: 'presented' | 'browsed' | 'kiosk';
+    loopContinuously?: boolean;
+    showWithNarration?: boolean;
+    showWithAnimation?: boolean;
+    advanceMode?: 'manual' | 'useTimings';
+    showSlidesMode?: 'all' | 'customShow' | 'range';
+    showSlidesFrom?: number;
+    showSlidesTo?: number;
+    penColor?: string;
+}
+declare function updatePresentationProperties(ctx: ToolContext, params: UpdatePresentationPropertiesParams): ToolResult<{
+    properties: PptxPresentationProperties;
+}>;
+
+interface LayoutInfo {
+    name: string;
+    path?: string;
+    type?: string;
+}
+interface GetLayoutsResult {
+    layouts: LayoutInfo[];
+    count: number;
+}
+declare function getLayouts(ctx: ToolContext): ToolResult<GetLayoutsResult>;
+interface ApplyLayoutParams {
+    slideIndex: number;
+    layoutName?: string;
+    layoutType?: string;
+}
+interface ApplyLayoutResult {
+    slideIndex: number;
+    layoutName: string;
+}
+declare function applyLayout(ctx: ToolContext, params: ApplyLayoutParams): ToolResult<ApplyLayoutResult>;
+
+export { type AccessibilityCheckResult, type AccessibilityIssue, type AddChartSeriesParams, type AddElementParams, type AddElementResult, type AddSlideParams, type AddSlideResult, type ApplyLayoutParams, type ApplyLayoutResult, type ApplyTemplateParams, type ApplyTemplateResult, type ApplyThemePresetParams, type ApplyThemePresetResult, type ArrangeElementsParams, type BatchUpdateElementsParams, type CloneElementParams, type CloneElementResult, type CollaborationProvider, type CommentInfo, type ConvertToMarkdownParams, type ConvertToMarkdownResult, type CreateChartParams, type CreateChartResult, type DeleteElementsParams, type DeleteSlidesParams, type DeleteSlidesResult, type DiffPresentationsParams, type DuplicateSlideParams, type ExecutionContext, type ExportSlideSvgParams, type ExportSlideSvgResult, type ExportToSvgParams, type ExportToSvgResult, type FileSystemProvider, type FindPlaceholdersResult, type FindTextParams, type FindTextResult, type GetLayoutsResult, type GetSlideResult, type GroupElementsParams, type GroupElementsResult, type HyperlinkInfo, type LayoutInfo, 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 RemoveChartSeriesParams, type ReorderSlidesParams, type RepairPresentationResult, type ReplaceGeometryParams, type ReplaceTextParams, type ReplaceTextResult, type SectionInfo, type SetCanvasSizeParams, type SetElementAnimationParams, type SetElementLockParams, type SetSlideTransitionParams, type SmartArtNodeInfo, type TextMatch, type ThemeInfo, type ToolContext, type ToolResult, type UngroupElementsParams, type UngroupElementsResult, type UpdateChartParams, type UpdateChartSeriesDataParams, type UpdateElementParams, type UpdateElementStyleParams, type UpdateMetadataParams, type UpdatePresentationPropertiesParams, type UpdateSlidePropertiesParams, type UpdateTableCellsParams, type UpdateThemeColorsParams, type UpdateThemeFontsParams, type ValidatePresentationResult, type ViewerProvider, addChartSeriesT, addElement, addSlide, applyLayout, applyTemplateT, applyThemePreset, arrangeElements, batchUpdateElements, cloneElement, convertToMarkdown, createChart, deleteElements, deleteSlides, describeElement, diffPresentationsT, duplicateSlide, executeToolWithContext, exportSlideSvg, exportToSvg, extractSlideText, findPlaceholdersT, findText, generateElementId, generateSlideId, getLayouts, getMetadata, getPresentationProperties, getSlide, getThemeInfo, groupElements, loadPresentation, manageComments, manageHyperlinks, manageSections, manageSmartArt, manageTableStructure, mergePresentationT, removeChartSeriesT, reorderSlides, repairPresentation, replaceGeometry, replaceText, runAccessibilityCheck, savePresentation, setCanvasSize, setElementAnimation, setElementLockT, setSlideTransition, ungroupElements, updateChart, updateChartSeriesData, updateElement, updateElementStyle, updateMetadata, updatePresentationProperties, updateSlideProperties, updateTableCells, updateThemeColors, updateThemeFonts, validatePresentation, validateSlideIndex };