@pitcher/js-api 1.28.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

@@ -92,7 +92,7 @@ export default function useCanvasTheme(): {
             readonly deactivated_at: string | null;
             readonly activated_at: string | null;
             readonly is_active: boolean;
-            language?: import('../../../../types/openapi').LanguageEnum | undefined;
+            language?: string | undefined;
             readonly connected_services: {
                 connection_id: string;
                 type: string;
@@ -121,7 +121,7 @@ export default function useCanvasTheme(): {
             readonly deactivated_at: string | null;
             readonly activated_at: string | null;
             readonly is_active: boolean;
-            language?: import('../../../../types/openapi').LanguageEnum | undefined;
+            language?: string | undefined;
             readonly connected_services: {
                 connection_id: string;
                 type: string;
@@ -150,7 +150,7 @@ export default function useCanvasTheme(): {
             readonly deactivated_at: string | null;
             readonly activated_at: string | null;
             readonly is_active: boolean;
-            language?: import('../../../../types/openapi').LanguageEnum | undefined;
+            language?: string | undefined;
             readonly connected_services: {
                 connection_id: string;
                 type: string;
@@ -209,7 +209,7 @@ export default function useCanvasTheme(): {
             readonly deactivated_at: string | null;
             readonly activated_at: string | null;
             readonly is_active: boolean;
-            language?: import('../../../../types/openapi').LanguageEnum | undefined;
+            language?: string | undefined;
             readonly connected_services: {
                 connection_id: string;
                 type: string;
@@ -238,7 +238,7 @@ export default function useCanvasTheme(): {
             readonly deactivated_at: string | null;
             readonly activated_at: string | null;
             readonly is_active: boolean;
-            language?: import('../../../../types/openapi').LanguageEnum | undefined;
+            language?: string | undefined;
             readonly connected_services: {
                 connection_id: string;
                 type: string;
@@ -267,7 +267,7 @@ export default function useCanvasTheme(): {
             readonly deactivated_at: string | null;
             readonly activated_at: string | null;
             readonly is_active: boolean;
-            language?: import('../../../../types/openapi').LanguageEnum | undefined;
+            language?: string | undefined;
             readonly connected_services: {
                 connection_id: string;
                 type: string;
@@ -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;
@@ -489,7 +491,7 @@ export default function useCanvasTheme(): {
             readonly deactivated_at: string | null;
             readonly activated_at: string | null;
             readonly is_active: boolean;
-            language?: import('../../../../types/openapi').LanguageEnum | undefined;
+            language?: string | undefined;
             readonly connected_services: {
                 connection_id: string;
                 type: string;
@@ -518,7 +520,7 @@ export default function useCanvasTheme(): {
             readonly deactivated_at: string | null;
             readonly activated_at: string | null;
             readonly is_active: boolean;
-            language?: import('../../../../types/openapi').LanguageEnum | undefined;
+            language?: string | undefined;
             readonly connected_services: {
                 connection_id: string;
                 type: string;
@@ -547,7 +549,7 @@ export default function useCanvasTheme(): {
             readonly deactivated_at: string | null;
             readonly activated_at: string | null;
             readonly is_active: boolean;
-            language?: import('../../../../types/openapi').LanguageEnum | undefined;
+            language?: string | undefined;
             readonly connected_services: {
                 connection_id: string;
                 type: string;
@@ -606,7 +608,7 @@ export default function useCanvasTheme(): {
             readonly deactivated_at: string | null;
             readonly activated_at: string | null;
             readonly is_active: boolean;
-            language?: import('../../../../types/openapi').LanguageEnum | undefined;
+            language?: string | undefined;
             readonly connected_services: {
                 connection_id: string;
                 type: string;
@@ -635,7 +637,7 @@ export default function useCanvasTheme(): {
             readonly deactivated_at: string | null;
             readonly activated_at: string | null;
             readonly is_active: boolean;
-            language?: import('../../../../types/openapi').LanguageEnum | undefined;
+            language?: string | undefined;
             readonly connected_services: {
                 connection_id: string;
                 type: string;
@@ -664,7 +666,7 @@ export default function useCanvasTheme(): {
             readonly deactivated_at: string | null;
             readonly activated_at: string | null;
             readonly is_active: boolean;
-            language?: import('../../../../types/openapi').LanguageEnum | undefined;
+            language?: string | undefined;
             readonly connected_services: {
                 connection_id: string;
                 type: string;
@@ -731,7 +733,7 @@ export default function useCanvasTheme(): {
             readonly deactivated_at: string | null;
             readonly activated_at: string | null;
             readonly is_active: boolean;
-            language?: import('../../../../types/openapi').LanguageEnum | undefined;
+            language?: string | undefined;
             readonly connected_services: {
                 connection_id: string;
                 type: string;
@@ -760,7 +762,7 @@ export default function useCanvasTheme(): {
             readonly deactivated_at: string | null;
             readonly activated_at: string | null;
             readonly is_active: boolean;
-            language?: import('../../../../types/openapi').LanguageEnum | undefined;
+            language?: string | undefined;
             readonly connected_services: {
                 connection_id: string;
                 type: string;
@@ -789,7 +791,7 @@ export default function useCanvasTheme(): {
             readonly deactivated_at: string | null;
             readonly activated_at: string | null;
             readonly is_active: boolean;
-            language?: import('../../../../types/openapi').LanguageEnum | undefined;
+            language?: string | undefined;
             readonly connected_services: {
                 connection_id: string;
                 type: string;
@@ -848,7 +850,7 @@ export default function useCanvasTheme(): {
             readonly deactivated_at: string | null;
             readonly activated_at: string | null;
             readonly is_active: boolean;
-            language?: import('../../../../types/openapi').LanguageEnum | undefined;
+            language?: string | undefined;
             readonly connected_services: {
                 connection_id: string;
                 type: string;
@@ -877,7 +879,7 @@ export default function useCanvasTheme(): {
             readonly deactivated_at: string | null;
             readonly activated_at: string | null;
             readonly is_active: boolean;
-            language?: import('../../../../types/openapi').LanguageEnum | undefined;
+            language?: string | undefined;
             readonly connected_services: {
                 connection_id: string;
                 type: string;
@@ -906,7 +908,7 @@ export default function useCanvasTheme(): {
             readonly deactivated_at: string | null;
             readonly activated_at: string | null;
             readonly is_active: boolean;
-            language?: import('../../../../types/openapi').LanguageEnum | undefined;
+            language?: string | undefined;
             readonly connected_services: {
                 connection_id: string;
                 type: string;

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/canvas.util.d.ts

@@ -65,5 +65,13 @@ export declare function updateFirstCollectionPlayerWithShareboxItems(canvasConte
 export declare function handleThemeAssetComparison(key: string | symbol | number, objValue: any, othValue: any, object: any, other: any, fileProps: string[], isEqual: (obj1: any, obj2: any) => boolean, componentsWithThemeMeta?: Set<string>): boolean | undefined;
 export declare function applyCanvasThemeAssetsToNode(node: ComponentNode): ComponentNode;
 export declare function processCanvasForSectionThemeOverride(canvas: CanvasRetrieve, maintainSectionTheme: boolean): CanvasRetrieve;
+/**
+ * Append `?instance_id=` to a core-API path when the id is known (PIT-7587).
+ * The canvas metadata PATCH is gated on the instance-scoped `canvas.update`
+ * permission, and the proxy doesn't forward `x-instance-id` on these calls, so
+ * instance context must travel as a query param (mirrors next-core's
+ * header-then-query fallback in `with-permission.ts`).
+ */
+export declare function withInstanceId(path: string, instanceId?: string | null): string;
 export declare function isEmbeddableWithZeroHeight(component: ComponentNode): boolean;
 export {};

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 {};