@lofcz/pptist 2.0.0

package/dist/types/embed/agentic/helpers.d.ts

@@ -0,0 +1,99 @@
+import type { Note, NoteReply, PPTAnimation, PPTAudioElement, PPTElement, PPTElementLink, PPTLatexElement, PPTLineElement, PPTShapeElement, PPTTableElement, Slide, SlideTheme, TableCell, TableCellStyle } from '../../types/slides';
+import type { PptistAudioElementPatch, PptistCommandIssue, PptistCommandType, PptistCreateAudioInput, PptistElementTransformPatch, PptistLatexElementInput, PptistMediaAsset, PptistMediaAssetInput, PptistMediaAssetKind, PptistNoteInput, PptistNotePatch, PptistNoteReplyInput, PptistTableElementPatch } from './types';
+export declare function clonePlain<T>(value: T): T;
+export declare function clonePatch<T extends object>(patch: T): T;
+export declare function createId(prefix: string): string;
+export declare function createIssue(code: string, message: string, path?: string, recoverable?: boolean): PptistCommandIssue;
+export declare function normalizeMediaExt(ext?: string): string | undefined;
+export declare function inferMediaExtFromMime(mimeType?: string): string | undefined;
+export declare function inferMediaMimeFromExt(ext?: string): string | undefined;
+export declare function inferMediaExtFromSrc(src: string, mimeType?: string): string | undefined;
+export declare function inferMediaMimeFromSrc(src: string, ext?: string): string | undefined;
+export declare function resolveMediaAsset(asset: PptistMediaAssetInput, kind?: PptistMediaAssetKind): PptistMediaAsset;
+export declare function isCanonicalCommandType(type: string): type is PptistCommandType;
+export type IdMap = Record<string, string>;
+export interface ElementCloneOptions {
+    animationIdMap?: IdMap;
+    elementIdMap?: IdMap;
+    groupIdMap?: IdMap;
+    offset?: number | {
+        left?: number;
+        top?: number;
+    };
+    preserveExternalSlideLinks?: boolean;
+    slideIdMap?: IdMap;
+}
+export interface ClonedElements {
+    elements: PPTElement[];
+    animations: PPTAnimation[];
+    elementIdMap: IdMap;
+    groupIdMap: IdMap;
+    animationIdMap: IdMap;
+}
+export interface ClonedSlides extends ClonedElements {
+    slides: Slide[];
+    slideIdMap: IdMap;
+}
+export declare function toIdList(id: string | string[]): string[];
+export declare function clampIndex(index: number, length: number): number;
+export declare function insertIndex(index: number | undefined, length: number): number;
+export declare function ensureSlide(slides: Slide[], slideId?: string, fallbackIndex?: number): {
+    slide: Slide;
+    index: number;
+};
+export declare function findElement(slides: Slide[], elementId: string, slideId?: string, fallbackIndex?: number): {
+    slide: Slide;
+    slideIndex: number;
+    element: PPTElement;
+    elementIndex: number;
+};
+export declare function ensureElementOnSlide(slide: Slide, elementId: string): void;
+export declare function createSlideIdMap(slides: Slide[]): IdMap;
+export declare function createElementIdMap(elements: PPTElement[]): {
+    elementIdMap: IdMap;
+    groupIdMap: IdMap;
+};
+export declare function normalizeElementLink(link: PPTElementLink | undefined, slides: Slide[]): PPTElementLink | undefined;
+export interface SlideLinkReference {
+    slideId: string;
+    elementId: string;
+    target: string;
+}
+export declare function findSlideLinkReferences(slides: Slide[], targetIds?: Set<string>): SlideLinkReference[];
+export declare function remapElementSlideLinks(elements: PPTElement[], slideIdMap: Map<string, string> | IdMap): number;
+export declare function cloneElementsWithRemappedIds(elements: PPTElement[], animations?: PPTAnimation[], options?: ElementCloneOptions): ClonedElements;
+export declare function cloneSlidesWithRemappedIds(slides: Slide[], options?: {
+    preserveExternalSlideLinks?: boolean;
+    slideIdMap?: IdMap;
+}): ClonedSlides;
+export declare function normalizeSlide(slide?: Partial<Slide>): Slide;
+export declare function normalizeElement(element: Partial<PPTElement> & {
+    type: PPTElement['type'];
+}, theme?: SlideTheme): PPTElement;
+export declare function flattenElementTransform<T extends object>(input: T & {
+    transform?: PptistElementTransformPatch;
+}): Omit<T, 'transform'> & PptistElementTransformPatch;
+export declare function normalizeAudioElement(input: PptistCreateAudioInput, defaultColor: string): PPTAudioElement;
+export declare function normalizeAudioPatch(patch: PptistAudioElementPatch): Partial<PPTAudioElement>;
+export declare function resolveShapeFormula(element: PPTShapeElement): PPTShapeElement;
+export declare function normalizeShapeElement(element?: Partial<PPTShapeElement>): PPTShapeElement;
+export declare function mergeShapeElement(base: PPTShapeElement, patch: Partial<PPTShapeElement>): PPTShapeElement;
+export declare function normalizeLatexElement(element: PptistLatexElementInput): PPTLatexElement;
+export declare function normalizeLineElement(element: Partial<PPTLineElement> & {
+    type?: 'line';
+}): PPTLineElement;
+export declare function updateLineElement(element: PPTLineElement, patch: Partial<PPTLineElement>): PPTLineElement;
+export declare function remapElementGroupIds(elements: PPTElement[]): PPTElement[];
+export declare function normalizeAnimation(animation: Partial<PPTAnimation> & {
+    elId: string;
+    effect: string;
+    type: PPTAnimation['type'];
+}): PPTAnimation;
+export declare function normalizeNote(note: PptistNoteInput): Note;
+export declare function normalizeNotePatch(patch: PptistNotePatch): Partial<Note>;
+export declare function normalizeReply(reply: PptistNoteReplyInput): NoteReply;
+export declare function createTableCell(text?: string, style?: TableCellStyle): TableCell;
+export declare function normalizeTableColWidths(colWidths: number[] | undefined, colCount: number): number[];
+export declare function normalizeTableElement(element?: Partial<PPTTableElement>, theme?: SlideTheme): PPTTableElement;
+export declare function normalizeTableElementPatch(table: PPTTableElement, patch: PptistTableElementPatch): Partial<PPTTableElement>;
+export declare function mergeTheme(theme: SlideTheme, patch: Partial<SlideTheme>): SlideTheme;