@lofcz/pptist 2.0.0

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

@@ -0,0 +1,20 @@
+import type { PPTElement } from '../../types/slides';
+export declare function assertString(value: unknown, path: string, allowEmpty?: boolean): string;
+export declare function assertId(value: unknown, path?: string): string;
+export declare function assertOptionalId(value: unknown, path: string): string | undefined;
+export declare function assertIdList(value: string | string[], path?: string): string[];
+export declare function assertFiniteNumber(value: unknown, path: string): number;
+export declare function assertPositiveNumber(value: unknown, path: string): number;
+export declare function assertIndexInRange(index: unknown, length: number, path?: string): number;
+export declare function assertInsertIndex(index: unknown, length: number, path?: string): number;
+export declare function assertColorString(value: unknown, path?: string): string;
+export declare function assertColorFields(value: unknown, path?: string): void;
+export declare function assertElementType(value: unknown, path?: string): PPTElement['type'];
+export declare function assertElementDimensions(element: Partial<PPTElement>, path?: string): void;
+export declare function assertElementSubtypeRequirements(element: Partial<PPTElement> & {
+    type?: unknown;
+}, path?: string): void;
+export declare function assertElementCreateInput(element: Partial<PPTElement> & {
+    type: PPTElement['type'];
+}, path?: string): void;
+export declare function assertElementPatch(patch: Partial<PPTElement>, current: PPTElement, path?: string): void;

package/dist/types/embed/createController.d.ts

@@ -0,0 +1,7 @@
+import type { Pinia } from 'pinia';
+import type { App } from 'vue';
+import type { PptistController, PptistDocument } from './types';
+export declare function createController(pinia: Pinia, app: App, options: {
+    onChange?: (document: PptistDocument) => void;
+    onChangeDebounceMs?: number;
+}): PptistController;

package/dist/types/embed/index.d.ts

@@ -0,0 +1,5 @@
+export { mountPptist, unmountPptist } from './mount';
+export type { PptistController, PptistDocument, PptistMountOptions, PptistMountResult, } from './types';
+export type * from './agentic/types';
+export type { Locales as PptistLocales } from '../i18n/locale';
+export type { ChartData, ChartOptions, ChartType, Note, NoteReply, PPTAnimation, PPTAudioElement, PPTChartElement, PPTElement, PPTElementLink, PPTImageElement, PPTLatexElement, PPTLineElement, PPTShapeElement, PPTTableElement, PPTTextElement, PPTVideoElement, ShapeText, Slide, SlideBackground, SlideTemplate, SlideTheme, TableCell, TableCellStyle, TextAlign, TurningMode, } from '../types/slides';

package/dist/types/embed/localeBridge.d.ts

@@ -0,0 +1,4 @@
+import type { Locales } from '../i18n/locale';
+export declare function registerVueLocaleSync(fn: (locale: Locales) => void): void;
+export declare function unregisterVueLocaleSync(): void;
+export declare function applyLocale(locale: Locales): Promise<void>;

package/dist/types/embed/mount.d.ts

@@ -0,0 +1,12 @@
+import 'prosemirror-view/style/prosemirror.css';
+import 'animate.css';
+import '../assets/styles/prosemirror.scss';
+import '../assets/styles/global.scss';
+import '../assets/styles/font.scss';
+import type { PptistMountOptions, PptistMountResult } from './types';
+/**
+ * Mount PPTist into a DOM node (for sciobot-next / other React hosts).
+ * Vue + Pinia are bundled in the embed build — the host does not need Vue installed.
+ */
+export declare function mountPptist(target: HTMLElement | string, options?: PptistMountOptions): Promise<PptistMountResult>;
+export declare function unmountPptist(result: PptistMountResult): Promise<void>;

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

@@ -0,0 +1,44 @@
+import type { Locales } from '../i18n/locale';
+import type { Slide, SlideTheme } from '../types/slides';
+import type { PptistAgentApi, PptistSlideReference } from './agentic/types';
+/** Serializable deck passed between sciobot-next and PPTist. */
+export interface PptistDocument {
+    title: string;
+    slides: Slide[];
+    theme?: Partial<SlideTheme>;
+}
+export interface PptistMountOptions {
+    /** UI locale — same union as sciobot-next (`cs` | `en` | `sk` | `pl`). */
+    locale?: Locales;
+    /** Initial deck; when omitted, mock slides are loaded if `loadMockOnEmpty` is true. */
+    document?: PptistDocument;
+    /** When no `document`, fetch `mocks/slides.json` from `assetBaseUrl` (default: `/`). */
+    loadMockOnEmpty?: boolean;
+    /**
+     * Base URL for runtime assets (template covers, mocks).
+     * Dev: `http://127.0.0.1:5173` while PPTist dev server runs, or sciobot proxy path.
+     */
+    assetBaseUrl?: string;
+    /** Fired when title, slides, or theme change (debounced). */
+    onChange?: (document: PptistDocument) => void;
+    onChangeDebounceMs?: number;
+}
+/** Public embed controller: legacy host methods plus the generic command and domain APIs. */
+export interface PptistController extends PptistAgentApi {
+    getDocument(): PptistDocument;
+    setDocument(document: PptistDocument): void;
+    setTitle(title: string): void;
+    setLocale(locale: Locales): Promise<void>;
+    goToSlide(slideIdOrIndex: PptistSlideReference): void;
+    nextSlide(): void;
+    previousSlide(): void;
+    setZoom(scale: number): void;
+    enterPresentation(): void;
+    exitPresentation(): void;
+    destroy(): void;
+}
+export interface PptistMountResult {
+    controller: PptistController;
+    app: import('vue').App;
+    pinia: import('pinia').Pinia;
+}

package/dist/types/hooks/useAIPPT.d.ts

@@ -0,0 +1,14 @@
+import type { Slide } from '../types/slides';
+import type { AIPPTSlide } from '../types/AIPPT';
+interface ImgPoolItem {
+    id: string;
+    src: string;
+    width: number;
+    height: number;
+}
+declare const _default: () => {
+    presetImgPool: (imgs: ImgPoolItem[]) => void;
+    AIPPT: (templateSlides: Slide[], _AISlides: AIPPTSlide[], imgs?: ImgPoolItem[]) => void;
+    getMdContent: (content: string) => string;
+};
+export default _default;

package/dist/types/hooks/useAddSlidesOrElements.d.ts

@@ -0,0 +1,6 @@
+import type { PPTElement, Slide } from '../types/slides';
+declare const _default: () => {
+    addElementsFromData: (elements: PPTElement[]) => void;
+    addSlidesFromData: (slides: Slide[]) => void;
+};
+export default _default;

package/dist/types/hooks/useAlignActiveElement.d.ts

@@ -0,0 +1,5 @@
+import { ElementAlignCommands } from '../types/edit';
+declare const _default: () => {
+    alignActiveElement: (command: ElementAlignCommands) => void;
+};
+export default _default;

package/dist/types/hooks/useAlignElementToCanvas.d.ts

@@ -0,0 +1,5 @@
+import { ElementAlignCommands } from '../types/edit';
+declare const _default: () => {
+    alignElementToCanvas: (command: ElementAlignCommands) => void;
+};
+export default _default;

package/dist/types/hooks/useCombineElement.d.ts

@@ -0,0 +1,6 @@
+declare const _default: () => {
+    canCombine: import("vue").ComputedRef<boolean>;
+    combineElements: () => void;
+    uncombineElements: () => void;
+};
+export default _default;

package/dist/types/hooks/useCopyAndPasteElement.d.ts

@@ -0,0 +1,7 @@
+declare const _default: () => {
+    copyElement: () => void;
+    cutElement: () => void;
+    pasteElement: () => void;
+    quickCopyElement: () => void;
+};
+export default _default;

package/dist/types/hooks/useCreateElement.d.ts

@@ -0,0 +1,36 @@
+import type { PPTShapeElement, ChartType } from '../types/slides';
+import { type ShapePoolItem } from '../configs/shapes';
+import type { LinePoolItem } from '../configs/lines';
+interface CommonElementPosition {
+    top: number;
+    left: number;
+    width: number;
+    height: number;
+}
+interface LineElementPosition {
+    top: number;
+    left: number;
+    start: [number, number];
+    end: [number, number];
+}
+interface CreateTextData {
+    content?: string;
+    vertical?: boolean;
+}
+declare const _default: () => {
+    createImageElement: (src: string) => void;
+    createChartElement: (type: ChartType) => void;
+    createTableElement: (row: number, col: number) => void;
+    createTextElement: (position: CommonElementPosition, data?: CreateTextData) => void;
+    createShapeElement: (position: CommonElementPosition, data: ShapePoolItem, supplement?: Partial<PPTShapeElement>) => void;
+    createLineElement: (position: LineElementPosition, data: LinePoolItem) => void;
+    createLatexElement: (data: {
+        path: string;
+        latex: string;
+        w: number;
+        h: number;
+    }) => void;
+    createVideoElement: (src: string, ext?: string) => void;
+    createAudioElement: (src: string, ext?: string) => void;
+};
+export default _default;

package/dist/types/hooks/useDeleteElement.d.ts

@@ -0,0 +1,5 @@
+declare const _default: () => {
+    deleteElement: () => void;
+    deleteAllElements: () => void;
+};
+export default _default;

package/dist/types/hooks/useExport.d.ts

@@ -0,0 +1,10 @@
+import type { Slide } from '../types/slides';
+declare const _default: () => {
+    exporting: import("vue").Ref<boolean, boolean>;
+    exportImage: (domRef: HTMLElement, format: string, quality: number, ignoreWebfont?: boolean) => void;
+    exportImagePPTX: (domRefs: NodeListOf<Element>) => void;
+    exportJSON: () => void;
+    exportSpecificFile: (_slides: Slide[]) => void;
+    exportPPTX: (_slides: Slide[], masterOverwrite: boolean, ignoreMedia: boolean) => void;
+};
+export default _default;

package/dist/types/hooks/useGlobalHotkey.d.ts

@@ -0,0 +1,2 @@
+declare const _default: () => void;
+export default _default;

package/dist/types/hooks/useHideElement.d.ts

@@ -0,0 +1,6 @@
+declare const _default: () => {
+    toggleHideElement: (id: string) => void;
+    showAllElements: () => void;
+    hideAllElements: () => void;
+};
+export default _default;

package/dist/types/hooks/useHistorySnapshot.d.ts

@@ -0,0 +1,6 @@
+declare const _default: () => {
+    addHistorySnapshot: import("lodash").DebouncedFunc<() => void>;
+    redo: import("lodash").DebouncedFuncLeading<() => void>;
+    undo: import("lodash").DebouncedFuncLeading<() => void>;
+};
+export default _default;

package/dist/types/hooks/useImageHandler.d.ts

@@ -0,0 +1,4 @@
+declare const _default: () => {
+    replaceImage: (files: FileList) => void;
+};
+export default _default;

package/dist/types/hooks/useImport.d.ts

@@ -0,0 +1,10 @@
+declare const _default: () => {
+    importSpecificFile: (files: FileList | File[], cover?: boolean) => void;
+    importJSON: (files: FileList | File[], cover?: boolean) => void;
+    importPPTXFile: (files: FileList | File[], options?: {
+        cover?: boolean;
+        fixedViewport?: boolean;
+    }) => void;
+    exporting: import("vue").Ref<boolean, boolean>;
+};
+export default _default;

package/dist/types/hooks/useLink.d.ts

@@ -0,0 +1,6 @@
+import type { PPTElement, PPTElementLink } from '../types/slides';
+declare const _default: () => {
+    setLink: (handleElement: PPTElement, link: PPTElementLink) => boolean;
+    removeLink: (handleElement: PPTElement) => void;
+};
+export default _default;

package/dist/types/hooks/useLoadSlides.d.ts

@@ -0,0 +1,4 @@
+declare const _default: () => {
+    slidesLoadLimit: import("vue").Ref<number, number>;
+};
+export default _default;

package/dist/types/hooks/useLockElement.d.ts

@@ -0,0 +1,6 @@
+import type { PPTElement } from '../types/slides';
+declare const _default: () => {
+    lockElement: () => void;
+    unlockElement: (handleElement: PPTElement) => void;
+};
+export default _default;

package/dist/types/hooks/useMoveElement.d.ts

@@ -0,0 +1,4 @@
+declare const _default: () => {
+    moveElement: (command: string, step?: number) => void;
+};
+export default _default;

package/dist/types/hooks/useOrderElement.d.ts

@@ -0,0 +1,6 @@
+import type { PPTElement } from '../types/slides';
+import { ElementOrderCommands } from '../types/edit';
+declare const _default: () => {
+    orderElement: (element: PPTElement, command: ElementOrderCommands) => void;
+};
+export default _default;

package/dist/types/hooks/usePasteDataTransfer.d.ts

@@ -0,0 +1,7 @@
+declare const _default: () => {
+    pasteDataTransfer: (dataTransfer: DataTransfer) => {
+        isFile: boolean;
+        dataTransferFirstItem: DataTransferItem;
+    };
+};
+export default _default;

package/dist/types/hooks/usePasteEvent.d.ts

@@ -0,0 +1,2 @@
+declare const _default: () => void;
+export default _default;

package/dist/types/hooks/usePasteTextClipboardData.d.ts

@@ -0,0 +1,8 @@
+interface PasteTextClipboardDataOptions {
+    onlySlide?: boolean;
+    onlyElements?: boolean;
+}
+declare const _default: () => {
+    pasteTextClipboardData: (text: string, options?: PasteTextClipboardDataOptions) => void;
+};
+export default _default;

package/dist/types/hooks/useScaleCanvas.d.ts

@@ -0,0 +1,7 @@
+declare const _default: () => {
+    canvasScalePercentage: import("vue").ComputedRef<string>;
+    setCanvasScalePercentage: (value: number) => void;
+    scaleCanvas: (command: "+" | "-") => void;
+    resetCanvas: () => void;
+};
+export default _default;

package/dist/types/hooks/useScreening.d.ts

@@ -0,0 +1,6 @@
+declare const _default: () => {
+    enterScreening: () => void;
+    enterScreeningFromStart: () => void;
+    exitScreening: () => void;
+};
+export default _default;

package/dist/types/hooks/useSearch.d.ts

@@ -0,0 +1,44 @@
+interface SearchTextResult {
+    elType: 'text' | 'shape';
+    slideId: string;
+    elId: string;
+}
+interface SearchTableResult {
+    elType: 'table';
+    slideId: string;
+    elId: string;
+    cellIndex: [number, number];
+}
+type SearchResult = SearchTextResult | SearchTableResult;
+type Modifiers = 'g' | 'gi';
+declare const _default: () => {
+    searchWord: import("vue").Ref<string, string>;
+    replaceWord: import("vue").Ref<string, string>;
+    searchResults: import("vue").Ref<({
+        elType: "text" | "shape";
+        slideId: string;
+        elId: string;
+    } | {
+        elType: "table";
+        slideId: string;
+        elId: string;
+        cellIndex: [number, number];
+    })[], SearchResult[] | ({
+        elType: "text" | "shape";
+        slideId: string;
+        elId: string;
+    } | {
+        elType: "table";
+        slideId: string;
+        elId: string;
+        cellIndex: [number, number];
+    })[]>;
+    searchIndex: import("vue").Ref<number, number>;
+    modifiers: import("vue").Ref<Modifiers, Modifiers>;
+    searchNext: () => import("../utils/message").MessageIntance | undefined;
+    searchPrev: () => import("../utils/message").MessageIntance | undefined;
+    replace: () => void;
+    replaceAll: () => void;
+    toggleModifiers: () => void;
+};
+export default _default;

package/dist/types/hooks/useSectionHandler.d.ts

@@ -0,0 +1,8 @@
+declare const _default: () => {
+    createSection: () => void;
+    removeSection: (sectionId: string) => void;
+    removeAllSection: () => void;
+    removeSectionSlides: (sectionId: string) => void;
+    updateSectionTitle: (sectionId: string, title: string) => void;
+};
+export default _default;

package/dist/types/hooks/useSelectElement.d.ts

@@ -0,0 +1,5 @@
+declare const _default: () => {
+    selectAllElements: () => void;
+    selectElement: (id: string) => void;
+};
+export default _default;

package/dist/types/hooks/useShapeFormatPainter.d.ts

@@ -0,0 +1,4 @@
+declare const _default: () => {
+    toggleShapeFormatPainter: (keep?: boolean) => void;
+};
+export default _default;

package/dist/types/hooks/useSlideBackgroundStyle.d.ts

@@ -0,0 +1,21 @@
+import { type Ref } from 'vue';
+import type { SlideBackground } from '../types/slides';
+declare const _default: (background: Ref<SlideBackground | undefined>) => {
+    backgroundStyle: import("vue").ComputedRef<{
+        backgroundColor: string | undefined;
+        backgroundImage?: undefined;
+        backgroundRepeat?: undefined;
+        backgroundSize?: undefined;
+    } | {
+        backgroundImage: string;
+        backgroundRepeat: string;
+        backgroundSize: string;
+        backgroundColor?: undefined;
+    } | {
+        backgroundImage: string;
+        backgroundColor?: undefined;
+        backgroundRepeat?: undefined;
+        backgroundSize?: undefined;
+    }>;
+};
+export default _default;

package/dist/types/hooks/useSlideHandler.d.ts

@@ -0,0 +1,16 @@
+import type { Slide } from '../types/slides';
+declare const _default: () => {
+    resetSlides: () => void;
+    updateSlideIndex: (command: string) => void;
+    copySlide: () => void;
+    pasteSlide: () => void;
+    createSlide: () => void;
+    createSlideByTemplate: (slide: Slide) => void;
+    copyAndPasteSlide: () => void;
+    deleteSlide: (targetSlidesId?: string[]) => void;
+    cutSlide: () => void;
+    selectAllSlide: () => void;
+    sortSlides: (newIndex: number, oldIndex: number) => void;
+    isEmptySlide: import("vue").ComputedRef<boolean>;
+};
+export default _default;

package/dist/types/hooks/useSlideTheme.d.ts

@@ -0,0 +1,14 @@
+import type { Slide } from '../types/slides';
+import type { PresetTheme } from '../configs/theme';
+declare const _default: () => {
+    getSlidesThemeStyles: (slide: Slide | Slide[]) => {
+        backgroundColors: string[];
+        themeColors: string[];
+        fontColors: string[];
+        fontNames: string[];
+    };
+    applyPresetTheme: (theme: PresetTheme, resetSlides?: boolean) => void;
+    applyThemeToAllSlides: (applyAll?: boolean) => void;
+    applyFontToAllSlides: (fontname: string) => void;
+};
+export default _default;

package/dist/types/hooks/useTextFormatPainter.d.ts

@@ -0,0 +1,4 @@
+declare const _default: () => {
+    toggleTextFormatPainter: (keep?: boolean) => void;
+};
+export default _default;

package/dist/types/hooks/useUniformDisplayElement.d.ts

@@ -0,0 +1,6 @@
+declare const _default: () => {
+    displayItemCount: import("vue").ComputedRef<number>;
+    uniformHorizontalDisplay: () => void;
+    uniformVerticalDisplay: () => void;
+};
+export default _default;

package/dist/types/i18n/cs/canvas/index.d.ts

@@ -0,0 +1,3 @@
+import type { NamespaceCanvasTranslation } from '../../i18n-types';
+declare const cs_canvas: NamespaceCanvasTranslation;
+export default cs_canvas;

package/dist/types/i18n/cs/common/index.d.ts

@@ -0,0 +1,3 @@
+import type { NamespaceCommonTranslation } from '../../i18n-types';
+declare const cs_common: NamespaceCommonTranslation;
+export default cs_common;

package/dist/types/i18n/cs/components/index.d.ts

@@ -0,0 +1,3 @@
+import type { NamespaceComponentsTranslation } from '../../i18n-types';
+declare const cs_components: NamespaceComponentsTranslation;
+export default cs_components;

package/dist/types/i18n/cs/configs/index.d.ts

@@ -0,0 +1,3 @@
+import type { NamespaceConfigsTranslation } from '../../i18n-types';
+declare const cs_configs: NamespaceConfigsTranslation;
+export default cs_configs;

package/dist/types/i18n/cs/editor/index.d.ts

@@ -0,0 +1,3 @@
+import type { NamespaceEditorTranslation } from '../../i18n-types';
+declare const cs_editor: NamespaceEditorTranslation;
+export default cs_editor;

package/dist/types/i18n/cs/export/index.d.ts

@@ -0,0 +1,3 @@
+import type { NamespaceExportTranslation } from '../../i18n-types';
+declare const cs_export: NamespaceExportTranslation;
+export default cs_export;

package/dist/types/i18n/cs/index.d.ts

@@ -0,0 +1,3 @@
+import type { Translation } from '../i18n-types';
+declare const cs: Translation;
+export default cs;

package/dist/types/i18n/cs/mobile/index.d.ts

@@ -0,0 +1,3 @@
+import type { NamespaceMobileTranslation } from '../../i18n-types';
+declare const cs_mobile: NamespaceMobileTranslation;
+export default cs_mobile;

package/dist/types/i18n/cs/screen/index.d.ts

@@ -0,0 +1,3 @@
+import type { NamespaceScreenTranslation } from '../../i18n-types';
+declare const cs_screen: NamespaceScreenTranslation;
+export default cs_screen;

package/dist/types/i18n/en/canvas/index.d.ts

@@ -0,0 +1,3 @@
+import type { BaseTranslation } from '../../i18n-types';
+declare const en_canvas: BaseTranslation;
+export default en_canvas;

package/dist/types/i18n/en/common/index.d.ts

@@ -0,0 +1,3 @@
+import type { BaseTranslation } from '../../i18n-types';
+declare const en_common: BaseTranslation;
+export default en_common;

package/dist/types/i18n/en/components/index.d.ts

@@ -0,0 +1,3 @@
+import type { BaseTranslation } from '../../i18n-types';
+declare const en_components: BaseTranslation;
+export default en_components;

package/dist/types/i18n/en/configs/index.d.ts

@@ -0,0 +1,3 @@
+import type { BaseTranslation } from '../../i18n-types';
+declare const en_configs: BaseTranslation;
+export default en_configs;

package/dist/types/i18n/en/editor/index.d.ts

@@ -0,0 +1,3 @@
+import type { BaseTranslation } from '../../i18n-types';
+declare const en_editor: BaseTranslation;
+export default en_editor;

package/dist/types/i18n/en/export/index.d.ts

@@ -0,0 +1,3 @@
+import type { BaseTranslation } from '../../i18n-types';
+declare const en_export: BaseTranslation;
+export default en_export;

package/dist/types/i18n/en/index.d.ts

@@ -0,0 +1,3 @@
+import type { BaseTranslation } from '../i18n-types';
+declare const en: BaseTranslation;
+export default en;

package/dist/types/i18n/en/mobile/index.d.ts

@@ -0,0 +1,3 @@
+import type { BaseTranslation } from '../../i18n-types';
+declare const en_mobile: BaseTranslation;
+export default en_mobile;

package/dist/types/i18n/en/screen/index.d.ts

@@ -0,0 +1,3 @@
+import type { BaseTranslation } from '../../i18n-types';
+declare const en_screen: BaseTranslation;
+export default en_screen;

package/dist/types/i18n/formatters.d.ts

@@ -0,0 +1,6 @@
+import type { FormattersInitializer } from 'typesafe-i18n';
+import type { Locales, Formatters } from './i18n-types';
+export declare const LOCALE_BCP47: Record<Locales, string>;
+export declare function localeToBcp47(locale: Locales): string;
+export declare function formatLocaleDateTime(timestamp: number, locale: Locales, options?: Intl.DateTimeFormatOptions): string;
+export declare const initFormatters: FormattersInitializer<Locales, Formatters>;

package/dist/types/i18n/getLL.d.ts

@@ -0,0 +1,8 @@
+import type { Locales, TranslationFunctions } from './i18n-types';
+/**
+ * Synchronous translation accessor for plain `.ts` files (hooks, configs, stores).
+ * Loads all locales and namespaces via the sync util on first call.
+ */
+export declare function getLL(locale?: Locales): TranslationFunctions;
+/** Clear cached LL instances after locale switch (optional; call from setPptistLocale if needed). */
+export declare function clearLLCache(): void;