@pitcher/js-api 1.29.0 → 1.30.0

package/lib/apps/canvas-builder/composables/useCanvasHistory.d.ts

@@ -114,6 +114,8 @@ export default function useCanvasHistory(): {
                 from?: "custom" | "pexels" | "unsplash" | "ai" | undefined;
                 poster_url?: string | undefined;
                 poster_background_size?: import('../../../types/background').BackgroundSize | undefined;
+                poster_file_id?: string | undefined;
+                poster_asset_type?: "pitcher_asset" | "ld_asset" | undefined;
             } | {
                 asset_type: "pitcher_asset";
                 file: {
@@ -125,6 +127,21 @@ export default function useCanvasHistory(): {
                 horizontal_alignment?: import('../types/canvas').MultimediaHorizontalAlignmentOptions | undefined;
                 poster_url?: string | undefined;
                 poster_background_size?: import('../../../types/background').BackgroundSize | undefined;
+                poster_file_id?: string | undefined;
+                poster_asset_type?: "pitcher_asset" | "ld_asset" | undefined;
+            } | {
+                asset_type: "ld_asset";
+                file: {
+                    id: import('../../../main.lib').File["id"];
+                    name: import('../../../main.lib').File["name"];
+                    content_url?: import('../../../main.lib').File["content_url"] | undefined;
+                };
+                type: "image" | "video";
+                horizontal_alignment?: import('../types/canvas').MultimediaHorizontalAlignmentOptions | undefined;
+                poster_url?: string | undefined;
+                poster_background_size?: import('../../../types/background').BackgroundSize | undefined;
+                poster_file_id?: string | undefined;
+                poster_asset_type?: "pitcher_asset" | "ld_asset" | undefined;
             } | {
                 type: "app";
                 app_name: string;
@@ -285,6 +302,7 @@ export default function useCanvasHistory(): {
                     readonly original_url?: string | null | undefined;
                     readonly thumbnail_url?: string | null | undefined;
                     download_type?: import('../../../main.lib').DownloadTypeEnum | undefined;
+                    readonly downloaded_at?: string | null | undefined;
                     readonly zip_size?: number | null | undefined;
                     readonly zip_url?: string | null | undefined;
                     access_type?: import('../../../main.lib').AccessTypeEnum | undefined;
@@ -588,6 +606,8 @@ export default function useCanvasHistory(): {
                 from?: "custom" | "pexels" | "unsplash" | "ai" | undefined;
                 poster_url?: string | undefined;
                 poster_background_size?: import('../../../types/background').BackgroundSize | undefined;
+                poster_file_id?: string | undefined;
+                poster_asset_type?: "pitcher_asset" | "ld_asset" | undefined;
             } | {
                 asset_type: "pitcher_asset";
                 file: {
@@ -599,6 +619,21 @@ export default function useCanvasHistory(): {
                 horizontal_alignment?: import('../types/canvas').MultimediaHorizontalAlignmentOptions | undefined;
                 poster_url?: string | undefined;
                 poster_background_size?: import('../../../types/background').BackgroundSize | undefined;
+                poster_file_id?: string | undefined;
+                poster_asset_type?: "pitcher_asset" | "ld_asset" | undefined;
+            } | {
+                asset_type: "ld_asset";
+                file: {
+                    id: import('../../../main.lib').File["id"];
+                    name: import('../../../main.lib').File["name"];
+                    content_url?: import('../../../main.lib').File["content_url"] | undefined;
+                };
+                type: "image" | "video";
+                horizontal_alignment?: import('../types/canvas').MultimediaHorizontalAlignmentOptions | undefined;
+                poster_url?: string | undefined;
+                poster_background_size?: import('../../../types/background').BackgroundSize | undefined;
+                poster_file_id?: string | undefined;
+                poster_asset_type?: "pitcher_asset" | "ld_asset" | undefined;
             } | {
                 type: "app";
                 app_name: string;
@@ -759,6 +794,7 @@ export default function useCanvasHistory(): {
                     readonly original_url?: string | null | undefined;
                     readonly thumbnail_url?: string | null | undefined;
                     download_type?: import('../../../main.lib').DownloadTypeEnum | undefined;
+                    readonly downloaded_at?: string | null | undefined;
                     readonly zip_size?: number | null | undefined;
                     readonly zip_url?: string | null | undefined;
                     access_type?: import('../../../main.lib').AccessTypeEnum | undefined;

package/lib/apps/canvas-builder/composables/useCanvasTheme.d.ts

@@ -325,6 +325,7 @@ export default function useCanvasTheme(): {
         readonly original_url: string | null;
         readonly thumbnail_url: string | null;
         download_type?: import('../../../../types/openapi').DownloadTypeEnum | undefined;
+        readonly downloaded_at?: string | null | undefined;
         readonly zip_size: number | null;
         readonly zip_url: string | null;
         access_type?: import('../../../../types/openapi').AccessTypeEnum | undefined;
@@ -383,6 +384,7 @@ export default function useCanvasTheme(): {
         readonly original_url: string | null;
         readonly thumbnail_url: string | null;
         download_type?: import('../../../../types/openapi').DownloadTypeEnum | undefined;
+        readonly downloaded_at?: string | null | undefined;
         readonly zip_size: number | null;
         readonly zip_url: string | null;
         access_type?: import('../../../../types/openapi').AccessTypeEnum | undefined;

package/lib/apps/canvas-builder/composables/useContentSelector.d.ts

@@ -34,8 +34,15 @@ declare function prepareLinkFolderNodeData({ selectedItems, node, }: {
     selectedItems: SelectedFolder[];
     node?: ComponentNode<LinkProps>;
 }): LinkProps;
-declare function prepareMultimediaNodeData({ selectedItems, }: {
+declare function prepareMultimediaNodeData({ selectedItems, assetType, }: {
     selectedItems: (SelectedExternalLink | SelectedAsset)[];
+    /**
+     * Which asset backend the picked file lives in — from `CanvasBuilderProps.assetType`. Defaults to
+     * `'pitcher_asset'` so every existing host is byte-identical; only the L&D course host passes
+     * `'ld_asset'` (T1.7b / PIT-7742), which is what makes Multimedia re-resolve the file's short-lived
+     * presigned URL at render instead of trusting the stored one.
+     */
+    assetType?: 'pitcher_asset' | 'ld_asset';
 }): {
     data: MultimediaProps;
     theme_meta?: Partial<ComponentNode['theme_meta']>;

package/lib/apps/canvas-builder/composables/useInstalledEmbeddables.d.ts

@@ -5,7 +5,7 @@ export declare function useInstalledEmbeddables(): {
     installedEmbeddablesById: import('vue').Ref<Record<string, AppFile> | null, Record<string, AppFile> | null>;
     refetchedFor: Record<string, boolean>;
     shouldUseDeviceUrl: ComputedRef<boolean | undefined>;
-    shortcuts: ComputedRef<Record<"edit" | "presentation" | "fullscreen", (EmbeddedAppShortcut & {
+    shortcuts: ComputedRef<Record<"fullscreen" | "edit" | "presentation", (EmbeddedAppShortcut & {
         appName: string;
         displayName: string;
     })[]>>;

package/lib/apps/canvas-builder/composables/useNavigatorDrawer.d.ts

@@ -1,6 +1,8 @@
 declare function toggleNavigatorDrawer(): void;
+declare function defaultOpenNavigatorDrawer(): void;
 export default function (): {
     toggleNavigatorDrawer: typeof toggleNavigatorDrawer;
+    defaultOpenNavigatorDrawer: typeof defaultOpenNavigatorDrawer;
     isNavigatorDrawerOpen: import('vue').Ref<boolean, boolean>;
 };
 export {};

package/lib/apps/canvas-builder/composables/usePopupApps.d.ts

@@ -17,6 +17,7 @@ export declare function usePopupApps(): {
         readonly original_url: string | null;
         readonly thumbnail_url: string | null;
         download_type?: import('../../../main.lib').DownloadTypeEnum | undefined;
+        readonly downloaded_at?: string | null | undefined;
         readonly zip_size: number | null;
         readonly zip_url: string | null;
         access_type?: import('../../../main.lib').AccessTypeEnum | undefined;
@@ -480,6 +481,7 @@ export declare function usePopupApps(): {
         readonly original_url: string | null;
         readonly thumbnail_url: string | null;
         download_type?: import('../../../main.lib').DownloadTypeEnum | undefined;
+        readonly downloaded_at?: string | null | undefined;
         readonly zip_size: number | null;
         readonly zip_url: string | null;
         access_type?: import('../../../main.lib').AccessTypeEnum | undefined;

package/lib/apps/canvas-builder/types/canvas.d.ts

@@ -172,12 +172,33 @@ export interface CanvasFile {
 declare const MULTIMEDIA_IMG_TYPE: {
     readonly external: "external";
     readonly pitcher_asset: "pitcher_asset";
+    readonly ld_asset: "ld_asset";
 };
 export declare enum MultimediaHorizontalAlignmentOptions {
     LEFT = "left",
     CENTER = "center",
     RIGHT = "right"
 }
+/**
+ * Where a Multimedia `poster_url` came from — shared by every asset variant, because a poster's origin is
+ * independent of the media's (an `external` video can carry an L&D-hosted poster).
+ *
+ * `poster_url` alone is unrefreshable: a short-lived source (an L&D presigned URL, 900s) rots and the
+ * canvas has no record of what it was, so nothing can re-resolve it — unlike `file.content_url`, which
+ * `Multimedia.vue` refreshes at render off `file.id`. Recording the id plus its backend is what keeps a
+ * poster recoverable.
+ *
+ * Both are absent for an external-link/Pexels poster (long-lived URL, no Pitcher id to resolve).
+ *
+ * `poster_asset_type` lives on the NODE rather than being read from host state at render, because the
+ * render path must work in COURSE (rep playback) — the mode where a poster is *guaranteed* to be past its
+ * TTL — and COURSE cannot supply `CanvasBuilderProps.assetType` at all (it's `?: never` there).
+ * (T1.7b / PIT-7742, R4-F1.)
+ */
+type MultimediaPosterProvenance = {
+    poster_file_id?: string;
+    poster_asset_type?: 'pitcher_asset' | 'ld_asset';
+};
 export type ExternalMultimediaAssetType = {
     asset_type: typeof MULTIMEDIA_IMG_TYPE.external;
     external_url: string;
@@ -186,7 +207,7 @@ export type ExternalMultimediaAssetType = {
     from?: 'custom' | 'pexels' | 'unsplash' | 'ai';
     poster_url?: string;
     poster_background_size?: BackgroundSize;
-};
+} & MultimediaPosterProvenance;
 export type PitcherMultimediaAssetType = {
     asset_type: typeof MULTIMEDIA_IMG_TYPE.pitcher_asset;
     file: {
@@ -198,8 +219,20 @@ export type PitcherMultimediaAssetType = {
     horizontal_alignment?: MultimediaHorizontalAlignmentOptions;
     poster_url?: string;
     poster_background_size?: BackgroundSize;
-};
-export type MultimediaProps = ExternalMultimediaAssetType | PitcherMultimediaAssetType;
+} & MultimediaPosterProvenance;
+export interface LdMultimediaAssetType extends MultimediaPosterProvenance {
+    asset_type: typeof MULTIMEDIA_IMG_TYPE.ld_asset;
+    file: {
+        id: File['id'];
+        name: File['name'];
+        content_url?: File['content_url'];
+    };
+    type: 'image' | 'video';
+    horizontal_alignment?: MultimediaHorizontalAlignmentOptions;
+    poster_url?: string;
+    poster_background_size?: BackgroundSize;
+}
+export type MultimediaProps = ExternalMultimediaAssetType | PitcherMultimediaAssetType | LdMultimediaAssetType;
 export type ContentGridCommonFileProps = {
     id: FileRetrieve['id'];
     snapshot_id?: FileRetrieve['id'];
@@ -599,6 +632,7 @@ export type SharingBuilderProps = NoCRMBuilderProps & {
     };
     activeCanvas: CanvasRetrieve;
     onExit: () => void;
+    onEndCall?: () => void | Promise<void>;
     onSave?: never;
     onEnter?: () => void;
     onPageEnter?: (data: ComponentNode[], pageIndex: number) => void;
@@ -626,6 +660,7 @@ export type SharingBuilderProps = NoCRMBuilderProps & {
     listRecommendedFiles?: never;
     listCanvases?: never;
     fetchFolder?: never;
+    assetType?: never;
     fetchFile: (fileId: FileRetrieve['id']) => Promise<FileRetrieve>;
     fetchInstanceMetadataTemplate?: never;
     fetchCanvas?: (canvasId: CanvasRetrieve['id'], params?: Record<string, any>) => Promise<CanvasRetrieve>;
@@ -677,6 +712,7 @@ type AdminImpactCommonBuilderProps = {
     };
     activeCanvas: CanvasRetrieve;
     onExit: () => void;
+    onEndCall?: () => void | Promise<void>;
     onEnter?: () => void;
     onComponentEnter?: (data: ComponentNode | CanvasRetrieve, params: ComponentTrackingParams) => void;
     onComponentExit?: (data: ComponentNode | CanvasRetrieve, params: ComponentTrackingParams) => void;
@@ -735,6 +771,18 @@ type AdminImpactCommonBuilderProps = {
     isAnyTypeOfAdmin: boolean;
     canvasMetadata: CanvasMetadataRetrieve | null;
     hideEdit?: boolean;
+    /**
+     * Which asset backend the Assets tab's files come from, stamped onto a Multimedia node on selection
+     * (`prepareMultimediaNodeData`). Defaults to `'pitcher_asset'`, so every existing sales/DSR/admin
+     * mount is unchanged — only the L&D course host (course-canvas-host) opts into `'ld_asset'`.
+     *
+     * Lives on the Admin/Impact/Home common props because those are the only modes that can open the
+     * content selector; SHARING/COURSE type-block it with `?: never`.
+     *
+     * It does NOT affect rendering — Multimedia keys its render-time URL re-resolution off the node's
+     * own `asset_type`, so an `ld_asset` node renders correctly wherever it is mounted. (T1.7b/PIT-7742)
+     */
+    assetType?: 'pitcher_asset' | 'ld_asset';
 };
 type AdminBuilderProps = AdminImpactCommonBuilderProps & (CRMBuilderProps | NoCRMBuilderProps) & {
     isRedirectEvent?: never;
@@ -784,6 +832,7 @@ export type CourseBuilderProps = NoCRMBuilderProps & {
     };
     activeCanvas: CanvasRetrieve;
     onExit: () => void;
+    onEndCall?: () => void | Promise<void>;
     onSave?: (canvasId: CanvasRetrieve['id'], canvas: PatchedCanvasUpdateRequest & {
         fields?: string;
         include_expired_files?: boolean;
@@ -814,6 +863,7 @@ export type CourseBuilderProps = NoCRMBuilderProps & {
     listRecommendedFiles?: never;
     listCanvases?: never;
     fetchFolder?: never;
+    assetType?: never;
     fetchFile: (fileId: FileRetrieve['id']) => Promise<FileRetrieve>;
     fetchInstanceMetadataTemplate?: never;
     fetchCanvas?: (canvasId: CanvasRetrieve['id'], params?: Record<string, any>) => Promise<CanvasRetrieve>;

package/lib/apps/canvas-builder/util/completionWizard.util.d.ts

@@ -0,0 +1,107 @@
+import { CanvasActions } from '../../../types/canvasActions';
+import { AppFile } from '../../../types/app';
+/** Installable-app name of the React pitchdeck wizard (PIT-7510). */
+export declare const REACT_COMPLETION_WIZARD_APP_NAME = "pitchdeck-wizard-ng";
+export interface ResolveCompletionWizardVariantParams {
+    /** `canvas.enable_react_completion_wizard` org/instance setting — opt-in, default off. */
+    isReactWizardSettingEnabled: boolean;
+    /** The React wizard app resolved to a loadable URL (installed or local dev override). */
+    isReactWizardAvailable: boolean;
+    /** The deck's admin config uses features the React wizard cannot honor yet (see below). */
+    hasUnsupportedConfig?: boolean;
+}
+/**
+ * PIT-7510: which completion-wizard implementation to render where the wizard opens today.
+ * The setting is the only switch (no LaunchDarkly flag); an enabled setting without an
+ * installed app — or a deck whose admin config the React wizard cannot honor — falls back
+ * to the Vue wizard so no flow is ever lost.
+ */
+export declare function resolveCompletionWizardVariant(p: ResolveCompletionWizardVariantParams): 'vue' | 'react';
+/**
+ * Admin group_selector config features the React wizard does not implement yet:
+ * repetition rules (slide repeats + salesforce-populator data binding) and visibility
+ * rules. Decks using them keep the vanilla wizard regardless of the setting.
+ */
+export declare function hasUnsupportedGroupSelectorConfig(context: Record<string, unknown> | null | undefined): boolean;
+/**
+ * Resolve the React wizard app's iframe URL: local dev override first (same mechanism as
+ * every installable app), else the installed app's `content_url`.
+ */
+export declare function resolveReactCompletionWizardSrc(apps: AppFile[]): string | null;
+/**
+ * PIT-7030: what cancelling the completion wizard means depends on how it was entered.
+ *
+ * Create flow (never-completed deck): cancel abandons the deck — the host emits
+ * `cancelCanvasCompletionWizard`, which slotty treats as "leave the canvas" (and deletes the
+ * deck when it came from the create-canvas modal).
+ *
+ * Edit flow (`completion_wizard.edited` — set by `retriggerWizard()`, i.e. the "Edit Wizard"
+ * button or the Edit-action auto-open): the wizard was opened over a deck that was already
+ * completed, and entering it persisted `completed: false`. Cancel must restore
+ * `completed: true` and reload into the canvas editor — exactly what the Vue wizard's
+ * `confirmCancel()` → `completeWizard()` does. Emitting the cancel event here instead exits
+ * the canvas entirely and leaves the deck stuck "In-progress" (the QA regression on the
+ * React wizard).
+ */
+interface WizardCancelCanvasContext {
+    pitcher?: {
+        /** `edited` is written only by `retriggerWizard()` — the same signal the Vue wizard's `isEditWizard` reads. */
+        completion_wizard?: {
+            edited?: boolean;
+            completed?: boolean;
+        };
+    };
+}
+export declare function shouldCompleteWizardOnCancel(canvasContext: WizardCancelCanvasContext | null | undefined): boolean;
+export declare function wasCompletionWizardAutoOpened(canvasId: string): boolean;
+export declare function markCompletionWizardAutoOpened(canvasId: string | undefined): void;
+/**
+ * Read AND clear the auto-opened marker (PIT-7510 QA Q12). The marker exists to survive the
+ * `window.location.reload()` that follows completing/cancelling the wizard — one page load.
+ * Left in place it suppressed every LATER Edit action for the rest of the browser session,
+ * so the wizard never auto-opened again. Consuming it on read keeps the reload covered
+ * (the fresh mount still sees it once) while the next explicit Edit navigation starts
+ * clean. Callers cache the consumed value per mount so re-running watcher ticks within the
+ * same mount stay suppressed.
+ */
+export declare function consumeCompletionWizardAutoOpened(canvasId: string): boolean;
+export interface ShouldAutoOpenCompletionWizardParams {
+    /** `canvas.enable_edit_opens_completion_wizard` org/instance setting — opt-in, default off. */
+    isSettingEnabled: boolean;
+    /** Impact only — the wizard is a rep-facing flow and `retriggerWizard()` bails elsewhere anyway. */
+    isImpact: boolean;
+    /** Canvases only, never templates / sections / blocks. */
+    isCanvas: boolean;
+    /** Canvas preview is read-only playback; never auto-open there. */
+    isCanvasPreviewMode: boolean;
+    /** The mode the builder was opened in (`metadata.startInMode`). */
+    startInMode?: CanvasActions;
+    /** Editing is unavailable: RBAC, `disable_canvas_edit_for_reps`, or a frozen canvas. */
+    hideEdit: boolean;
+    /** `canRetriggerWizard()` — the canvas has wizard steps AND the wizard is already completed. */
+    canRetriggerWizard: boolean;
+    /** Active canvas id — required so the caller can persist the per-canvas dedup marker. */
+    canvasId?: string;
+    /**
+     * Whether this canvas was already auto-opened in the CURRENT page load (PIT-7510 Q12). The
+     * caller reads this via `consumeCompletionWizardAutoOpened` — a read-and-clear `sessionStorage`
+     * marker (keyed by canvas id) rather than mount-local state, because the wizard completion path
+     * (`completeWizard()`) runs `window.location.reload()`, which remounts the whole builder. A
+     * mount-local flag would reset on that reload and the `{ immediate: true }` watcher would
+     * auto-reopen the wizard, producing the open→cancel→reload→reopen flash loop (PIT-7030). The
+     * marker is consumed per mount, so a LATER Edit open of the same deck auto-opens again.
+     */
+    alreadyAutoOpened: boolean;
+}
+/**
+ * PIT-7030: decide whether opening a canvas via the Edit action should reopen the completion
+ * wizard instead of landing in the canvas editor.
+ *
+ * Pure so the guard chain is unit-testable — the caller performs the (async, persisting)
+ * `retriggerWizard()` side effect.
+ *
+ * A never-completed deck already shows the wizard through `isCompletionWizardShowing`, so this
+ * only covers the completed case, which is what `canRetriggerWizard` encodes.
+ */
+export declare function shouldAutoOpenCompletionWizard(p: ShouldAutoOpenCompletionWizardParams): boolean;
+export {};

package/lib/apps/canvas-builder/util/completionWizard.util.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/apps/canvas-builder/util/fullscreenMode.util.d.ts

@@ -0,0 +1,7 @@
+import { FullscreenMode } from '../../../types/organizationSettings.types';
+/**
+ * The presentation fullscreen mode to use: the rep's explicit in-presentation
+ * choice wins; otherwise the org/instance default; otherwise 'fullscreen'
+ * (preserving PIT-7029's auto-enter-native behaviour).
+ */
+export declare function resolvePresentationFullscreenMode(repChosen: FullscreenMode | null, defaultSetting: FullscreenMode | undefined): FullscreenMode;

package/lib/apps/canvas-builder/util/fullscreenMode.util.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/apps/canvas-builder/util/lazySections.util.d.ts

@@ -0,0 +1,35 @@
+import { CanvasSection } from '../../../../types/openapi';
+/**
+ * Helpers for opt-in lazy section loading (`?lazy_sections=true`, PIT-7073).
+ *
+ * A lazy shell response carries ordered `section_ids` plus lightweight section
+ * STUBS — `{ id, name, thumbnail_url, metadata, is_draft, content: { data: [] } }`
+ * — so list views (ToC, section rail) render immediately while the real bodies
+ * stream in via the batch endpoint.
+ */
+/**
+ * A stub carries an empty placeholder `content`; a hydrated body has components.
+ * This is how we tell "not fetched yet" from "fetched".
+ */
+export declare const isHydratedSection: (section?: CanvasSection | null) => boolean;
+/**
+ * Merge an incoming shell's sections over what we already hold, keeping any body
+ * we've already hydrated.
+ *
+ * A shell gets RE-APPLIED constantly: every embedded-app canvas update (each
+ * Shopping Cart change in the PRH apps) round-trips the canvas through the host,
+ * which hands back the lazy shell. Applying it verbatim would wipe the hydrated
+ * bodies, so the deck blanks and visibly BLINKS while it re-fetches them.
+ *
+ * Section bodies are separate canvases, so a deck-level update never invalidates
+ * them — carrying them forward is safe. An incoming section that IS hydrated
+ * always wins, so a genuine section refresh still lands.
+ */
+export declare const preserveHydratedSections: (previous: CanvasSection[] | undefined, incoming: CanvasSection[]) => CanvasSection[];
+/**
+ * The subset of `section_ids` that still needs fetching.
+ *
+ * Without this a re-applied shell would re-download every body on each
+ * interaction — on a 1k-section deck that's a full request storm per cart click.
+ */
+export declare const pendingSectionIds: (sectionIds: string[], sections: CanvasSection[] | undefined) => string[];

package/lib/apps/canvas-builder/util/lazySections.util.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/apps/collection-player/composables/collection-navigation.util.d.ts

@@ -0,0 +1,27 @@
+interface SlideLike {
+    id: string;
+}
+interface GroupLike<S extends SlideLike> {
+    id: string;
+    slides: S[];
+}
+export interface FlatSlidePosition {
+    /** 1-based position of the active slide across the whole collection, or 0 when not found. */
+    number: number;
+    /** Total number of slides across every group in the collection. */
+    total: number;
+}
+/**
+ * Position of the active slide within the flattened collection (all groups' slides
+ * in order) — powers the content-viewer-style "N / M" page counter.
+ */
+export declare const getFlatSlidePosition: <S extends SlideLike>(groups: GroupLike<S>[], activeGroupId: string | undefined, activeSlideId: string | undefined) => FlatSlidePosition;
+/**
+ * Resolve a 1-based flat page number back to its group and slide, crossing group
+ * boundaries — the inverse of {@link getFlatSlidePosition}.
+ */
+export declare const getSlideAtFlatPage: <G extends GroupLike<SlideLike>>(groups: G[], page: number) => {
+    group: G;
+    slide: G["slides"][number];
+} | null;
+export {};

package/lib/apps/collection-player/composables/collection-navigation.util.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/apps/collection-player/stores/app.store.d.ts

@@ -10,6 +10,7 @@ import { ActionCallback, default as useKeyboardBindings } from '../composables/k
 import { default as useSlideDirection } from '../composables/slide-direction.use';
 import { useCacheNavigation } from '../composables/navigation-cache.use';
 import { useAnnotationLayer } from '../composables/annotation-layer.use';
+import { FlatSlidePosition } from '../composables/collection-navigation.util';
 export type RenderPageAsImage = (payload: {
     fileId: File['id'];
     documentId?: File['id'];
@@ -61,7 +62,9 @@ type StoreData = {
     hasManyGroups: ComputedRef<boolean>;
     activeSlide: Ref<CollectionSlide | null>;
     activeGroup: Ref<CollectionGroup | null>;
+    slidePosition: ComputedRef<FlatSlidePosition>;
     setActiveSlide: (group?: CollectionGroup, slide?: CollectionSlide) => void;
+    setActiveFlatPage: (page: number) => void;
     onSlideChange: (customEvent: CustomEvent<[swiper: Swiper]>) => void;
     activatePreviousGroup: () => void;
     activateNextGroup: () => void;

package/lib/apps/content-selector/components/Assets.uploaderRefresh.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/apps/content-selector/stores/app.d.ts

@@ -2,7 +2,7 @@ import { Ref, ComputedRef, UnwrapNestedRefs } from 'vue';
 import { FolderRetrieve, FolderFile, FileRetrieve, File, FolderFolder, FileContentTypeEnum } from '../../../../types/openapi';
 import { ApiStore } from './api';
 export type AppName = 'admin' | 'impact';
-export type SelectorType = 'content' | 'assets' | 'external_links' | 'ai_images' | 'pexels_images' | 'theme' | `multimedia-selector-${string}`;
+export type SelectorType = 'content' | 'assets' | 'external_links' | 'pexels_images' | 'theme' | `multimedia-selector-${string}`;
 export type SortOption = 'nameAsc' | 'nameDesc' | 'modifiedAsc' | 'modifiedDesc';
 export type SelectedPage = {
     id: string;

package/lib/components/CFileViewer/pdf/CFileViewer.pdf.annotations.use.d.ts

@@ -1,7 +1,11 @@
 import { Ref, ComputedRef } from 'vue';
-import { Instance, AnnotationsUnion } from 'pspdfkit';
+import { Instance, AnnotationsUnion } from '@nutrient-sdk/viewer';
 import { CLIENT_TYPE } from '../../../constants/cdp.const';
 import { File } from '../../../../types/openapi';
+export declare function stripSdkWrapper(text: string): string;
+export declare function stripCorruption(text: string): string;
+export declare function normalizeText(text: string): string;
+export declare function needsCorruptionRepair(text: string): boolean;
 interface UseAnnotationsReturnType {
     annotations: Ref<AnnotationsUnion[]>;
     areAnnotationsModified: Ref<boolean>;

package/lib/components/CFileViewer/pdf/CFileViewer.pdf.formFields.use.d.ts

@@ -0,0 +1,8 @@
+import { Ref, ComputedRef } from 'vue';
+import { Instance } from '@nutrient-sdk/viewer';
+interface UseFormFieldsReturnType {
+    areFormFieldValuesModified: ComputedRef<boolean>;
+    resetFormFieldChanges: () => void;
+}
+export declare function useFormFields(instance: Ref<Instance | undefined>): UseFormFieldsReturnType;
+export {};

package/lib/components/CFileViewer/pdf/CFileViewer.pdf.link.use.d.ts

@@ -1,5 +1,5 @@
 import { Ref, ComputedRef } from 'vue';
-import { Instance, AnnotationsUnion, List } from 'pspdfkit';
+import { Instance, AnnotationsUnion, List } from '@nutrient-sdk/viewer';
 import { SaveLinkAnnotationPayload } from './CFileViewer.pdf.link.types';
 interface UseLinkAnnotationPayload {
     instance: Ref<Instance | undefined>;

package/lib/components/CFileViewer/pdf/CFileViewer.pdf.overlayItems.use.d.ts

@@ -1,5 +1,5 @@
 import { Ref } from 'vue';
-import { Instance } from 'pspdfkit';
+import { Instance } from '@nutrient-sdk/viewer';
 import { FileRetrieve } from '../../../../types/openapi';
 interface UseOverlayItemsReturnType {
     setOverlayItemsForEmbeddedVideos: (currentPageIndex: number) => Promise<void>;

package/lib/components/CFileViewer/pdf/CFileViewer.pdf.use.d.ts

@@ -1,6 +1,6 @@
 import { Ref, ComputedRef } from 'vue';
 import { I18n } from 'vue-i18n';
-import { Instance, AnnotationsUnion } from 'pspdfkit';
+import { Instance, AnnotationsUnion } from '@nutrient-sdk/viewer';
 import { AnnotationType } from '../CFileViewer.types';
 import { PitcherFile } from '../../../types/file.types';
 import { MiniPage, File, FileRetrieve } from '../../../../types/openapi';
@@ -27,6 +27,7 @@ interface FileViewerPdfReturnType {
     updateFileViewerSettings: (settings: Partial<typeof fileViewerSettings.value>) => void;
     cleanupPspdfKit: () => void;
     resetAnnotationChanges: () => void;
+    resetFormFieldChanges: () => void;
     isSearchOpen: Ref<boolean>;
     isThumbnailsOpen: Ref<boolean>;
     isTextAnnotationOpen: Ref<boolean>;
@@ -34,6 +35,7 @@ interface FileViewerPdfReturnType {
     currentPageIndex: Ref<number>;
     isAnnotationOpen: Ref<boolean>;
     areAnnotationsModified: Ref<boolean>;
+    areFormFieldValuesModified: ComputedRef<boolean>;
     selectedAnnotationType: Ref<Exclude<AnnotationType, 'text'>>;
     isSwitchingInteractionMode: Ref<boolean>;
     fileViewerSettings: typeof fileViewerSettings;
@@ -45,7 +47,7 @@ interface FileViewerPdfReturnType {
     onSaveLinkAnnotation: (data: SaveLinkAnnotationPayload) => void;
     hasHotspotsOnCurrentPage: Ref<boolean>;
 }
-declare const _default: ({ pdfViewerEl, bottomBarRef, i18n, appLocale, actions, assetsPrefix, clientType, context, pitcherSettings, launchDarkly, emit, fileId, fetchFileById, fetchDocumentInfo, }: {
+declare const _default: ({ pdfViewerEl, bottomBarRef, i18n, appLocale, actions, assetsPrefix, clientType, context, pitcherSettings, launchDarkly, emit, fileId, fetchFileById, }: {
     pdfViewerEl: Ref<HTMLElement | null>;
     bottomBarRef: Ref<InstanceType<typeof CFileViewerBottomPdf> | null>;
     i18n: I18n;
@@ -59,12 +61,5 @@ declare const _default: ({ pdfViewerEl, bottomBarRef, i18n, appLocale, actions,
     fileId: ComputedRef<File["id"] | undefined>;
     emit: (name: string, ...args: any[]) => void;
     fetchFileById?: (id: FileRetrieve["id"]) => Promise<FileRetrieve>;
-    fetchDocumentInfo?: (id: File["id"]) => Promise<{
-        pageCount: number;
-        pages?: Array<{
-            width: number;
-            height: number;
-        }>;
-    }>;
 }) => FileViewerPdfReturnType;
 export default _default;

package/lib/components/CFileViewer/pdf/CFileViewer.pdf.util.d.ts

@@ -1,4 +1,4 @@
-import { default as PSPDFKitType } from 'pspdfkit';
+import { default as PSPDFKitType } from '@nutrient-sdk/viewer';
 /**
  * Tear down a PSPDFKit instance for a container without ever throwing.
  *

package/lib/components/CFileViewer/pdf/CFileViewerFullscreen.pdf.use.d.ts

@@ -1,6 +1,6 @@
 import { Ref } from 'vue';
 import { MaybeRef } from '@vueuse/core';
-import { Instance } from 'pspdfkit';
+import { Instance } from '@nutrient-sdk/viewer';
 import { default as CFileViewerBottomPdf } from './CFileViewerBottom.pdf.vue';
 declare const _default: ({ pdfViewerEl, bottomBarRef, instance, isThumbnailsOpen, isSearchOpen, }: {
     pdfViewerEl: MaybeRef<HTMLElement | null>;

package/lib/components/CFileViewer/pdf/__tests__/CFileViewer.pdf.annotations.text.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/components/savedCanvases/CSavedCanvasesManagement.use.d.ts

@@ -4,6 +4,7 @@ export type FreezeStatus = 'active' | 'expired' | null;
 export declare function getFreezeStatus(canvas: Pick<CanvasRetrieve, 'metadata'>): FreezeStatus;
 export declare const SYSTEM_EXCLUDED_TAGS: readonly ["home", "share", "sharebox"];
 export declare function hasHidingTag(tags?: string[], dynamicTags?: string[]): boolean;
+export declare function isTemplateHiddenFromReps(canvas: Pick<CanvasRetrieve, 'tags' | 'template'>, rendererExcludedTags?: string[]): boolean;
 export declare function useCSavedCanvasesManagement(): {
     statusOptions: {
         label: string;

package/lib/composables/useCourseOnlyApps.d.ts

@@ -7,5 +7,5 @@ import { AppFile } from '../types/app';
  */
 export declare function useCourseOnlyApps(): {
     allowCourseOnlyApps: boolean;
-    isAppAllowed: (app: AppFile) => boolean;
+    isAppAllowedInHost: (app: AppFile) => boolean;
 };

package/lib/composables/usePdfInterpolation.d.ts

@@ -1,7 +1,7 @@
-import { default as PSPDFKitType, ServerConfiguration } from 'pspdfkit';
+import { default as PSPDFKitType, Configuration } from '@nutrient-sdk/viewer';
 declare function annotationsInterpolation({ PSPDFKit, config, data, }: {
     PSPDFKit: typeof PSPDFKitType;
-    config: ServerConfiguration;
+    config: Configuration;
     data: Record<string, string>;
 }): Promise<void>;
 export default function usePdfInterpolation(strategy?: 'annotations' | 'text'): typeof annotationsInterpolation;