fika-editor 3.0.0 → 3.0.1

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

@@ -0,0 +1,32 @@
+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;
+/** Store index (0-based) → agent-facing slide number (1-based). Empty deck → 0. */
+export declare function toApiSlideIndex(storeIndex: number): number;
+/**
+ * Agent-facing slide number (1-based) → store index (0-based).
+ * First slide is 1; last existing slide is `length`.
+ */
+export declare function fromApiSlideIndex(index: unknown, length: number, path?: string): number;
+/**
+ * Agent-facing insert position (1-based) → store splice index (0-based).
+ * Omit to append. `length + 1` also appends.
+ */
+export declare function fromApiInsertSlideIndex(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 { FikaController, FikaDocument } from './types';
+export declare function createController(options: {
+    onChange?: (document: FikaDocument) => void;
+    onChangeDebounceMs?: number;
+    onPresentationModeChange?: (screening: boolean) => void;
+    unmount?: () => void;
+}): FikaController;

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

@@ -0,0 +1,9 @@
+export { mountFika, unmountFika } from './mount';
+export type { FikaController, FikaDocument, FikaHeaderMenuItem, FikaMountOptions, FikaMountResult, FikaDocumentLoader, FikaStarterPresentationOptions, FikaTemplateLoader, FikaTemplatePayload, FikaImportPptxOptions, FikaImportApplyMode, FikaViewMode, } from './types';
+export type { ExportTabId, FikaExportTabsConfig } from '../configs/exportTabs';
+export type { FikaExportMediaResolver } from '../configs/exportMediaResolver';
+export { createFikaMediaUploader, } from '../configs/mediaUpload';
+export type { FikaMediaConfig, FikaMediaConstraints, FikaMediaKind, FikaMediaSizeLimit, FikaMediaUploadProgress, FikaMediaUploadRequest, FikaMediaUploadResult, FikaMediaUploader, FikaXhrMediaUploaderOptions, } from '../configs/mediaUpload';
+export type * from './agentic/types';
+export type { Locales as FikaLocales } 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/inferViewport.d.ts

@@ -0,0 +1,11 @@
+import type { Slide } from '../types/slides';
+import type { FikaDeckViewport } from './agentic/types';
+/**
+ * Recover the authored coordinate space from element bounds.
+ *
+ * Agent/import pipelines often author at 1280×720. Remounting those slides on
+ * the 1000×16:9 default (or a persisted default written before inference)
+ * overflows the canvas. Prefer an explicit viewport when it actually contains
+ * the content; otherwise upgrade to the smallest standard size that fits.
+ */
+export declare function inferViewportFromSlides(slides: Slide[], existing?: Partial<FikaDeckViewport>): FikaDeckViewport | undefined;

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

@@ -0,0 +1,4 @@
+import { type Locales } from '../i18n/locale';
+export declare function registerLocaleSync(fn: (locale: Locales) => void): void;
+export declare function unregisterLocaleSync(): 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 { FikaMountOptions, FikaMountResult } from './types';
+/**
+ * Mount Fika into a DOM node (for React / other embedding hosts).
+ * React is a peer dependency (`>19.2`). The host must provide React and React DOM.
+ */
+export declare function mountFika(target: HTMLElement | string, options?: FikaMountOptions): Promise<FikaMountResult>;
+export declare function unmountFika(result: FikaMountResult): Promise<void>;

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

@@ -0,0 +1,183 @@
+import type { FikaExportTabsConfig } from '../configs/exportTabs';
+import type { FikaExportMediaResolver } from '../configs/exportMediaResolver';
+import type { FikaMediaConfig } from '../configs/mediaUpload';
+import type { Locales } from '../i18n/locale';
+import type { Slide, SlideTheme, SlideTemplate } from '../types/slides';
+import type { FikaAgentApi, FikaDeckViewport, FikaSlideReference } from './agentic/types';
+export type { FikaExportMediaResolver };
+export type { FikaMediaConfig, FikaMediaConstraints, FikaMediaKind, FikaMediaSizeLimit, FikaMediaUploadProgress, FikaMediaUploadRequest, FikaMediaUploadResult, FikaMediaUploader, FikaXhrMediaUploaderOptions } from '../configs/mediaUpload';
+export interface FikaTemplatePayload {
+    title?: string;
+    width?: number;
+    height?: number;
+    slides: Slide[];
+    theme?: Partial<SlideTheme>;
+}
+export type FikaTemplateLoader = () => Promise<FikaTemplatePayload | Slide[]>;
+export type FikaDocumentLoader = () => Promise<FikaDocument | null | undefined>;
+export interface FikaStarterPresentationOptions {
+    title?: string;
+    titlePlaceholder?: string;
+    subtitlePlaceholder?: string;
+    bodyPlaceholder?: string;
+    titleFontSize?: number;
+    subtitleFontSize?: number;
+    contentTitleFontSize?: number;
+    bodyFontSize?: number;
+    placeholderColor?: string;
+    fontName?: string;
+    fontColor?: string;
+    backgroundColor?: string;
+}
+/** Serializable deck passed between the embedding host and Fika. */
+export interface FikaDocument {
+    title: string;
+    slides: Slide[];
+    theme?: Partial<SlideTheme>;
+    /** Slide coordinate space. Omitted payloads keep the engine default (1000 × 16:9). */
+    viewport?: Partial<FikaDeckViewport>;
+}
+/**
+ * Host-configured extra entry appended to the editor header's screening
+ * dropdown (below "from start" / "from current slide"). Labels are supplied by
+ * the host so no engine i18n keys are needed.
+ */
+export interface FikaHeaderMenuItem {
+    /** Stable id echoed back in `onSelect`. */
+    id: string;
+    /** Menu item label (host-localized). */
+    label: string;
+    /**
+     * Optional Lucide kebab-case name (`link`, `share-2`, `globe`, `cloud`)
+     * rendered before the label. Only a curated set is supported; unknown names
+     * render no icon.
+     */
+    icon?: string;
+    /** Fired when the entry is clicked (the dropdown closes first). */
+    onSelect?: (id: string) => void;
+}
+/** `editor` is the default full editor; `presentation` boots straight into the fullscreen slideshow with no editor chrome. */
+export type FikaViewMode = 'editor' | 'presentation';
+export interface FikaMountOptions {
+    /** UI locale (`cs` | `en` | `sk` | `pl`). */
+    locale?: Locales;
+    /** Initial deck; takes precedence over `loadDocument` and the starter slide. */
+    document?: FikaDocument;
+    /** Optional async document loader for hosts that resolve a deck from the current URL/session. */
+    loadDocument?: FikaDocumentLoader;
+    /** Legacy demo behavior: when explicitly true, load `mocks/slides.json` instead of the starter slide. */
+    loadMockOnEmpty?: boolean;
+    /** Set false when the embed host renders its own empty/loading state. */
+    showLoadingData?: boolean;
+    /** Customize the default one-slide starter deck used when no existing document is loaded. */
+    starterPresentation?: FikaStarterPresentationOptions;
+    /** Base URL for runtime image/font assets and fallback mock decks. */
+    assetBaseUrl?: string;
+    /**
+     * Host-supplied template catalog shown in the design picker.
+     * Payload JSON is resolved with `templateLoaders` keyed by `templates[].id`.
+     */
+    templates?: SlideTemplate[];
+    /** Optional custom template payload loaders keyed by `templates[].id`. */
+    templateLoaders?: Record<string, FikaTemplateLoader>;
+    /** Fired when title, slides, or theme change (debounced). */
+    onChange?: (document: FikaDocument) => void;
+    onChangeDebounceMs?: number;
+    /** Fired when Fika enters or exits slideshow/presentation mode. */
+    onPresentationModeChange?: (screening: boolean) => void;
+    /**
+     * Toggle export dialog formats (`pptx`, `json`). Omitted keys stay enabled.
+     */
+    exportTabs?: FikaExportTabsConfig;
+    /**
+     * Same-origin fallback when a direct browser fetch of an http(s) media URL
+     * fails (typically CORS on third-party hosts). Should return a `data:` URL
+     * or null/undefined to give up on that source.
+     */
+    exportMediaResolver?: FikaExportMediaResolver;
+    /**
+     * Local media picker used by the unified Insert → Media action (images,
+     * video, and audio). Pass `upload` to send files to your backend instead of
+     * embedding data/blob URLs. Constraints (count, size, MIME, extensions) are
+     * enforced in the picker before upload.
+     */
+    media?: FikaMediaConfig;
+    /**
+     * Extra entries appended to the editor header's screening dropdown. Lets an
+     * embedding host surface its own actions (e.g. "create public share link")
+     * inside the engine UI without touching the engine's i18n.
+     */
+    headerMenuItems?: FikaHeaderMenuItem[];
+    /**
+     * Show a locale switcher at the end of the editor header's right cluster.
+     * Off by default — embedding hosts typically drive locale themselves.
+     * The standalone demo page turns this on.
+     */
+    showLocaleSwitcher?: boolean;
+    /**
+     * When true (default), selecting a text range opens the right style panel
+     * after the pointer is released. Persisted in localStorage; an explicit
+     * value here wins for this mount.
+     */
+    openPanelOnTextSelection?: boolean;
+    /**
+     * `presentation` mounts a presentation-only viewer: once the deck resolves,
+     * the fullscreen slideshow starts immediately and the editor never renders.
+     * Exiting the slideshow re-enters it, so the page stays a pure viewer.
+     */
+    viewMode?: FikaViewMode;
+}
+export type FikaImportApplyMode = import('../utils/importApply').ImportApplyMode;
+export interface FikaImportPptxOptions {
+    /**
+     * `replace` (default) overwrites the current deck. `append` inserts after
+     * the current slide. An empty deck (0 slides) is always replaced.
+     */
+    mode?: FikaImportApplyMode;
+    /**
+     * Legacy alias for `mode`: `true` replace, `false` append.
+     * Prefer `mode`.
+     */
+    cover?: boolean;
+    /**
+     * When replacing a deck that already has more than one slide, ask the user
+     * first. The editor UI defaults to `true`; `importPptx` defaults to `false`.
+     */
+    confirm?: boolean;
+    /** Normalize the imported deck to the fixed 1000px viewport width. */
+    fixedViewport?: boolean;
+    /**
+     * Repair unreadable text colors after import (painter's-algorithm
+     * background query + WCAG contrast). Intended for AI-generated decks;
+     * leave off for genuine user files.
+     */
+    fixContrast?: boolean;
+}
+/** Public embed controller: legacy host methods plus the generic command and domain APIs. */
+export interface FikaController extends FikaAgentApi {
+    getDocument(): FikaDocument;
+    setDocument(document: FikaDocument): void;
+    /**
+     * Parse a `.pptx` file and load it into the editor (same converter as the
+     * editor's Import menu — pptxtojson + fidelity extras). Resolves `true` once
+     * the deck is applied to the store (the `onChange` document follows), or
+     * `false` when the file could not be parsed.
+     */
+    importPptx(data: File | Blob | ArrayBuffer, options?: FikaImportPptxOptions): Promise<boolean>;
+    setTitle(title: string): void;
+    setLocale(locale: Locales): Promise<void>;
+    goToSlide(slideIdOrIndex: FikaSlideReference): void;
+    nextSlide(): void;
+    previousSlide(): void;
+    setZoom(scale: number): void;
+    enterPresentation(): void;
+    exitPresentation(): void;
+    destroy(): void;
+}
+export interface FikaMountResult {
+    controller: FikaController;
+    /** Alias for `controller.destroy()`. */
+    app: {
+        unmount: () => void;
+    };
+}

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

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

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

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

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

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

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

@@ -0,0 +1,7 @@
+type MaybeEl = {
+    value: HTMLElement | null | undefined;
+} | {
+    current: HTMLElement | null | undefined;
+} | HTMLElement | null | undefined;
+export declare function useClickOutside(elRef: MaybeEl, handler: (event: MouseEvent) => void): void;
+export {};

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

@@ -0,0 +1,7 @@
+export declare const getCanCombine: () => boolean;
+export default _default;
+declare function _default(): {
+    readonly canCombine: boolean;
+    combineElements: () => void;
+    uncombineElements: () => void;
+};

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

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

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

@@ -0,0 +1,50 @@
+import type { PPTShapeElement, ChartType } from '../types/slides';
+import type { FikaMediaKind, FikaMediaUploadResult } from '../configs/mediaUpload';
+import { type ShapePoolItem } from '../configs/shapes';
+import type { LinePoolItem } from '../configs/lines';
+import { type CodeEditorPayload } from '../configs/code';
+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;
+}
+export declare function takePendingCreatedTextId(): string;
+export default _default;
+declare function _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;
+    createLatexElements: (dataList: {
+        latex: string;
+        w: number;
+        h: number;
+        path?: string;
+    }[]) => void;
+    createMermaidElement: (code: string) => void;
+    createCodeElement: (data: CodeEditorPayload) => void;
+    createVideoElement: (src: string, ext?: string) => void;
+    createAudioElement: (src: string, ext?: string) => void;
+    createMediaElements: (items: Array<FikaMediaUploadResult & {
+        kind: FikaMediaKind;
+    }>) => Promise<void>;
+};

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

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

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

@@ -0,0 +1,6 @@
+import type { PPTElement } from '../types/slides';
+import type { ContextmenuItem } from '../components/Contextmenu/types';
+export default _default;
+declare function _default(openLinkDialog: () => void): {
+    contextmenus: (element: PPTElement, isMultiSelect: boolean) => ContextmenuItem[];
+};

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

@@ -0,0 +1,13 @@
+import type { Slide } from '../types/slides';
+export default _default;
+declare function _default(): {
+    exporting: boolean;
+    exportProgress: number;
+    exportSlide: number;
+    exportSlideTotal: number;
+    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) => Promise<void>;
+};

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

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

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

@@ -0,0 +1,9 @@
+import type { PPTElement } from '../types/slides';
+/**
+ * Keep the last matching slide element while a modal is open.
+ * Store identity churn (new `elements` array, brief miss) must not unmount the editor.
+ */
+export declare function useHeldSlideElement<T extends PPTElement>(editingElementId: string, visible: boolean, isMatch: (el: PPTElement) => el is T): {
+    element: T;
+    present: boolean;
+};

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

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

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

@@ -0,0 +1,6 @@
+export default _default;
+declare function _default(): {
+    addHistorySnapshot: import("../utils/debounce").Debounced<() => void>;
+    redo: import("../utils/debounce").Debounced<() => void>;
+    undo: import("../utils/debounce").Debounced<() => void>;
+};

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

@@ -0,0 +1,2 @@
+/** Stay true after the first time `open` is true, so heavy UI is not remounted on toggle. */
+export declare function useHoldAfterOpen(open: boolean): boolean;

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

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

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

@@ -0,0 +1,21 @@
+import { type ImportApplyOptions } from '../utils/importApply';
+export declare function getImportApi(): {
+    importSpecificFile: (files: FileList | File[], options?: boolean | ImportApplyOptions) => Promise<boolean>;
+    importJSON: (files: FileList | File[], options?: boolean | ImportApplyOptions) => Promise<boolean>;
+    importPPTXFile: (files: FileList | File[], options?: ImportApplyOptions & {
+        fixedViewport?: boolean;
+        fixContrast?: boolean;
+    }) => Promise<boolean>;
+};
+export default function useImport(): {
+    importSpecificFile: (files: FileList | File[], options?: boolean | ImportApplyOptions) => Promise<boolean>;
+    importJSON: (files: FileList | File[], options?: boolean | ImportApplyOptions) => Promise<boolean>;
+    importPPTXFile: (files: FileList | File[], options?: ImportApplyOptions & {
+        fixedViewport?: boolean;
+        fixContrast?: boolean;
+    }) => Promise<boolean>;
+    importing: boolean;
+    importProgress: number;
+    importSlide: number;
+    importSlideTotal: number;
+};

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

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

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

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

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

@@ -0,0 +1,5 @@
+export default _default;
+declare function _default(elementId: () => string, isSelected: boolean): {
+    teleportTo: string | HTMLElement;
+    teleportDisabled: boolean;
+};

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

@@ -0,0 +1,8 @@
+import type { PPTAudioElement, PPTVideoElement } from '../types/slides';
+type MediaPosterElement = PPTVideoElement | PPTAudioElement;
+export default _default;
+declare function _default(element: () => MediaPosterElement, slideId?: () => string | undefined): {
+    synthesizing: boolean;
+    displayPoster: string;
+    persistPoster: (next: string) => void;
+};

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

@@ -0,0 +1,24 @@
+import { type FikaMediaKind, type FikaMediaUploadResult } from '../configs/mediaUpload';
+import { type MediaFileRejection } from '../utils/mediaFile';
+export type MediaQueueStatus = 'queued' | 'uploading' | 'processing' | 'ready' | 'error';
+export interface MediaQueueItem {
+    id: string;
+    file: File;
+    kind: FikaMediaKind;
+    previewUrl: string;
+    status: MediaQueueStatus;
+    progress: number;
+    error?: string;
+    result?: FikaMediaUploadResult;
+}
+export default _default;
+declare function _default(): {
+    items: MediaQueueItem[];
+    readyItems: MediaQueueItem[];
+    inFlight: boolean;
+    overallProgress: number;
+    addFiles: (fileList: FileList | File[]) => MediaFileRejection[];
+    removeItem: (id: string) => void;
+    retryItem: (id: string) => void;
+    reset: (preserveReadySrc?: boolean) => void;
+};

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

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

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

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

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

@@ -0,0 +1,14 @@
+export type OverlayPhase = 'closed' | 'enter' | 'open' | 'leave';
+/**
+ * First painted frame of an open already has the enter class, and the first
+ * painted frame of a close already has the leave class. Setting those in
+ * `useEffect` paints one frame at the wrong opacity / display and looks like
+ * a violent blink.
+ */
+export declare function useOverlayPhase(visible: boolean): {
+    phase: OverlayPhase;
+    onAnimationEnd: (event: React.AnimationEvent) => void;
+    shown: boolean;
+    entering: boolean;
+    leaving: boolean;
+};

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

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

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

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

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

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

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

@@ -0,0 +1,25 @@
+/**
+ * Step the displayed zoom (+/−) along the Chrome PDF preset ladder.
+ */
+export declare const scaleCanvas: (command: '+' | '-') => void;
+export declare const applyCanvasZoomDelta: (deltaPercent: number) => void;
+/**
+ * Set displayed zoom to an exact percent (toolbar presets: 50, 75, 100, … 200).
+ */
+export declare const setCanvasScalePercentage: (value: number) => void;
+/**
+ * Reset canvas zoom to the default fit percentage and re-center the viewport.
+ *
+ * Always toggle `canvasDragged` so the viewport watcher runs `initViewportPosition`.
+ * Setting percentage alone only applies a relative size adjustment, and clearing an
+ * already-false drag flag is a Zustand no-op — both of which left the fit button looking broken.
+ */
+export declare const resetCanvas: () => void;
+export default _default;
+declare function _default(): {
+    canvasScalePercentage: string;
+    setCanvasScalePercentage: typeof setCanvasScalePercentage;
+    scaleCanvas: typeof scaleCanvas;
+    applyCanvasZoomDelta: typeof applyCanvasZoomDelta;
+    resetCanvas: typeof resetCanvas;
+};

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

@@ -0,0 +1,8 @@
+import { prefetchScreen } from '../views/Screen/lazy';
+export default _default;
+declare function _default(): {
+    enterScreening: () => void;
+    enterScreeningFromStart: () => void;
+    exitScreening: () => void;
+    prefetchScreen: typeof prefetchScreen;
+};

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

@@ -0,0 +1,28 @@
+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';
+export default _default;
+declare function _default(): {
+    searchWord: string;
+    setSearchWord: import("react").Dispatch<import("react").SetStateAction<string>>;
+    replaceWord: string;
+    setReplaceWord: import("react").Dispatch<import("react").SetStateAction<string>>;
+    searchResults: SearchResult[];
+    searchIndex: number;
+    modifiers: Modifiers;
+    searchNext: () => import("../utils/message").MessageIntance;
+    searchPrev: () => import("../utils/message").MessageIntance;
+    replace: () => void;
+    replaceAll: () => void;
+    toggleModifiers: () => void;
+};

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

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