@pitcher/js-api 1.29.0 → 1.31.0

package/lib/apps/canvas-builder/composables/useCanvas.saveEcho.spec.d.ts

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

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

@@ -21,6 +21,7 @@ export default function useCanvasBlocks(): {
             readonly is_template?: boolean | undefined;
             readonly is_section?: boolean | undefined;
             readonly is_block?: boolean | undefined;
+            readonly is_master?: boolean | undefined;
             readonly is_editable?: boolean | undefined;
             readonly is_default?: boolean | undefined;
             readonly metadata?: any;
@@ -100,6 +101,7 @@ export default function useCanvasBlocks(): {
             readonly is_template?: boolean | undefined;
             readonly is_section?: boolean | undefined;
             readonly is_block?: boolean | undefined;
+            readonly is_master?: boolean | undefined;
             readonly is_editable?: boolean | undefined;
             readonly is_default?: boolean | undefined;
             readonly metadata?: any;
@@ -284,6 +286,8 @@ export default function useCanvasBlocks(): {
                 readonly from?: "custom" | "pexels" | "unsplash" | "ai" | undefined;
                 readonly poster_url?: string | undefined;
                 readonly poster_background_size?: import('../../../types/background').BackgroundSize | undefined;
+                readonly poster_file_id?: string | undefined;
+                readonly poster_asset_type?: "pitcher_asset" | "ld_asset" | undefined;
             } | {
                 readonly asset_type: "pitcher_asset";
                 readonly file: {
@@ -295,6 +299,21 @@ export default function useCanvasBlocks(): {
                 readonly horizontal_alignment?: import('../types/canvas').MultimediaHorizontalAlignmentOptions | undefined;
                 readonly poster_url?: string | undefined;
                 readonly poster_background_size?: import('../../../types/background').BackgroundSize | undefined;
+                readonly poster_file_id?: string | undefined;
+                readonly poster_asset_type?: "pitcher_asset" | "ld_asset" | undefined;
+            } | {
+                readonly asset_type: "ld_asset";
+                readonly file: {
+                    readonly id: import('../../../../types/openapi').File["id"];
+                    readonly name: import('../../../../types/openapi').File["name"];
+                    readonly content_url?: import('../../../../types/openapi').File["content_url"] | undefined;
+                };
+                readonly type: "image" | "video";
+                readonly horizontal_alignment?: import('../types/canvas').MultimediaHorizontalAlignmentOptions | undefined;
+                readonly poster_url?: string | undefined;
+                readonly poster_background_size?: import('../../../types/background').BackgroundSize | undefined;
+                readonly poster_file_id?: string | undefined;
+                readonly poster_asset_type?: "pitcher_asset" | "ld_asset" | undefined;
             } | {
                 readonly type: "app";
                 readonly app_name: string;
@@ -463,6 +482,7 @@ export default function useCanvasBlocks(): {
                     readonly original_url?: string | null | undefined;
                     readonly thumbnail_url?: string | null | undefined;
                     readonly download_type?: import('../../../../types/openapi').DownloadTypeEnum | undefined;
+                    readonly downloaded_at?: string | null | undefined;
                     readonly zip_size?: number | null | undefined;
                     readonly zip_url?: string | null | undefined;
                     readonly access_type?: import('../../../../types/openapi').AccessTypeEnum | undefined;
@@ -509,7 +529,7 @@ export default function useCanvasBlocks(): {
                         readonly id: number;
                         readonly name: string;
                         readonly email?: string | undefined;
-                    } | undefined;
+                    } | null | undefined;
                     readonly page_index?: number | undefined;
                 } | null | undefined;
                 readonly folder?: {
@@ -792,6 +812,8 @@ export default function useCanvasBlocks(): {
                 readonly from?: "custom" | "pexels" | "unsplash" | "ai" | undefined;
                 readonly poster_url?: string | undefined;
                 readonly poster_background_size?: import('../../../types/background').BackgroundSize | undefined;
+                readonly poster_file_id?: string | undefined;
+                readonly poster_asset_type?: "pitcher_asset" | "ld_asset" | undefined;
             } | {
                 readonly asset_type: "pitcher_asset";
                 readonly file: {
@@ -803,6 +825,21 @@ export default function useCanvasBlocks(): {
                 readonly horizontal_alignment?: import('../types/canvas').MultimediaHorizontalAlignmentOptions | undefined;
                 readonly poster_url?: string | undefined;
                 readonly poster_background_size?: import('../../../types/background').BackgroundSize | undefined;
+                readonly poster_file_id?: string | undefined;
+                readonly poster_asset_type?: "pitcher_asset" | "ld_asset" | undefined;
+            } | {
+                readonly asset_type: "ld_asset";
+                readonly file: {
+                    readonly id: import('../../../../types/openapi').File["id"];
+                    readonly name: import('../../../../types/openapi').File["name"];
+                    readonly content_url?: import('../../../../types/openapi').File["content_url"] | undefined;
+                };
+                readonly type: "image" | "video";
+                readonly horizontal_alignment?: import('../types/canvas').MultimediaHorizontalAlignmentOptions | undefined;
+                readonly poster_url?: string | undefined;
+                readonly poster_background_size?: import('../../../types/background').BackgroundSize | undefined;
+                readonly poster_file_id?: string | undefined;
+                readonly poster_asset_type?: "pitcher_asset" | "ld_asset" | undefined;
             } | {
                 readonly type: "app";
                 readonly app_name: string;
@@ -971,6 +1008,7 @@ export default function useCanvasBlocks(): {
                     readonly original_url?: string | null | undefined;
                     readonly thumbnail_url?: string | null | undefined;
                     readonly download_type?: import('../../../../types/openapi').DownloadTypeEnum | undefined;
+                    readonly downloaded_at?: string | null | undefined;
                     readonly zip_size?: number | null | undefined;
                     readonly zip_url?: string | null | undefined;
                     readonly access_type?: import('../../../../types/openapi').AccessTypeEnum | undefined;
@@ -1017,7 +1055,7 @@ export default function useCanvasBlocks(): {
                         readonly id: number;
                         readonly name: string;
                         readonly email?: string | undefined;
-                    } | undefined;
+                    } | null | undefined;
                     readonly page_index?: number | undefined;
                 } | null | undefined;
                 readonly folder?: {

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

@@ -1,3 +1,4 @@
 export default function useCanvasExit(): {
     onExitClick: () => void;
+    onEscapeExit: () => void;
 };

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;
@@ -327,7 +345,7 @@ export default function useCanvasHistory(): {
                         readonly id: number;
                         readonly name: string;
                         email?: string | undefined;
-                    } | undefined;
+                    } | null | undefined;
                     page_index?: number | undefined;
                 } | null | undefined;
                 folder?: {
@@ -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;
@@ -801,7 +837,7 @@ export default function useCanvasHistory(): {
                         readonly id: number;
                         readonly name: string;
                         email?: string | undefined;
-                    } | undefined;
+                    } | null | undefined;
                     page_index?: number | undefined;
                 } | null | undefined;
                 folder?: {

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;
@@ -367,7 +368,7 @@ export default function useCanvasTheme(): {
             readonly id: number;
             readonly name: string;
             email?: string | undefined;
-        };
+        } | null;
     }[], File[] | {
         readonly id: string;
         readonly global_id: string;
@@ -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;
@@ -425,7 +427,7 @@ export default function useCanvasTheme(): {
             readonly id: number;
             readonly name: string;
             email?: string | undefined;
-        };
+        } | null;
     }[]>;
     font: import('vue').Ref<string, string>;
     globalComponentSpacing: import('vue').Ref<number, number>;

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,33 @@
 declare function toggleNavigatorDrawer(): void;
+declare function defaultOpenNavigatorDrawer(): void;
+/**
+ * Entering Focus/Fullscreen closes the ToC, PowerPoint-like (PIT-8025). Only the
+ * FIRST entry does anything: a Focus↔Fullscreen mode switch re-enters without
+ * exiting, and treating that as a fresh entry would both overwrite the snapshot
+ * and re-close a drawer the rep had deliberately opened mid-presentation.
+ */
+declare function suspendNavigatorDrawerForFullscreen(): void;
+/**
+ * Exiting Focus/Fullscreen restores the pre-fullscreen state — open before →
+ * reopen; closed before → stay closed. A rep who toggled the ToC while IN
+ * fullscreen has already cleared the snapshot (see toggleNavigatorDrawer), so
+ * this leaves their choice alone; the `||` only guards a drawer opened by some
+ * other path mid-fullscreen.
+ */
+declare function restoreNavigatorDrawerAfterFullscreen(): void;
+/**
+ * Drops the suspend state without touching the drawer, for a teardown that leaves
+ * fullscreen without going through exitFullscreen (useCanvas `cleanup`). Without
+ * it the snapshot outlives the canvas and the next exit restores the previous
+ * one's state — all of this is module-level, like `isFullscreen` itself.
+ */
+declare function resetNavigatorDrawerFullscreenState(): void;
 export default function (): {
     toggleNavigatorDrawer: typeof toggleNavigatorDrawer;
+    defaultOpenNavigatorDrawer: typeof defaultOpenNavigatorDrawer;
+    suspendNavigatorDrawerForFullscreen: typeof suspendNavigatorDrawerForFullscreen;
+    restoreNavigatorDrawerAfterFullscreen: typeof restoreNavigatorDrawerAfterFullscreen;
+    resetNavigatorDrawerFullscreenState: typeof resetNavigatorDrawerFullscreenState;
     isNavigatorDrawerOpen: import('vue').Ref<boolean, boolean>;
 };
 export {};

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

@@ -0,0 +1 @@
+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;
@@ -411,7 +412,7 @@ export declare function usePopupApps(): {
                     width?: number | string | undefined;
                     height?: number | string | undefined;
                 } | undefined;
-                placement?: "top-left" | "top-center" | "top-right" | "left" | "center" | "right" | "bottom-left" | "bottom-center" | "bottom-right" | undefined;
+                placement?: "top-left" | "top-center" | "top-right" | "left" | "center" | "right" | "bottom-left" | "bottom-center" | "bottom-right" | "bottom-sheet" | undefined;
                 mode_config?: {
                     fullscreen?: {
                         show?: boolean | undefined;
@@ -433,6 +434,24 @@ export declare function usePopupApps(): {
             order_override?: number | undefined;
             has_multiple_routes?: boolean | undefined;
             configure_entry?: string | undefined;
+            secrets_schema?: import('../../../types/app').FlatSecretsSchema | {
+                [x: string]: import('../../../types/app').FlatSecretsSchema | {
+                    key: string;
+                    label: string;
+                    default: string;
+                    options: Record<string, {
+                        label: string;
+                    }>;
+                };
+                _strategy: {
+                    key: string;
+                    label: string;
+                    default: string;
+                    options: Record<string, {
+                        label: string;
+                    }>;
+                };
+            } | undefined;
         } | undefined;
         tags?: Array<string> | undefined;
         readonly published_at: string | null;
@@ -464,7 +483,7 @@ export declare function usePopupApps(): {
             readonly id: number;
             readonly name: string;
             email?: string | undefined;
-        };
+        } | null;
     } | null, AppFile | {
         readonly id: string;
         readonly global_id: string;
@@ -480,6 +499,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;
@@ -874,7 +894,7 @@ export declare function usePopupApps(): {
                     width?: number | string | undefined;
                     height?: number | string | undefined;
                 } | undefined;
-                placement?: "top-left" | "top-center" | "top-right" | "left" | "center" | "right" | "bottom-left" | "bottom-center" | "bottom-right" | undefined;
+                placement?: "top-left" | "top-center" | "top-right" | "left" | "center" | "right" | "bottom-left" | "bottom-center" | "bottom-right" | "bottom-sheet" | undefined;
                 mode_config?: {
                     fullscreen?: {
                         show?: boolean | undefined;
@@ -896,6 +916,24 @@ export declare function usePopupApps(): {
             order_override?: number | undefined;
             has_multiple_routes?: boolean | undefined;
             configure_entry?: string | undefined;
+            secrets_schema?: import('../../../types/app').FlatSecretsSchema | {
+                [x: string]: import('../../../types/app').FlatSecretsSchema | {
+                    key: string;
+                    label: string;
+                    default: string;
+                    options: Record<string, {
+                        label: string;
+                    }>;
+                };
+                _strategy: {
+                    key: string;
+                    label: string;
+                    default: string;
+                    options: Record<string, {
+                        label: string;
+                    }>;
+                };
+            } | undefined;
         } | undefined;
         tags?: Array<string> | undefined;
         readonly published_at: string | null;
@@ -927,7 +965,7 @@ export declare function usePopupApps(): {
             readonly id: number;
             readonly name: string;
             email?: string | undefined;
-        };
+        } | null;
     } | null>;
     selectedAppUrl: ComputedRef<string>;
     appIframeRef: import('vue').Ref<HTMLIFrameElement | null, HTMLIFrameElement | null>;
@@ -940,6 +978,7 @@ export declare function usePopupApps(): {
     hasSingleApp: ComputedRef<boolean>;
     singleApp: ComputedRef<AppFile | null>;
     getModalStyle: ComputedRef<Record<string, string>>;
+    isBottomSheetPlacement: ComputedRef<boolean>;
     onAppClick: (app: AppFile) => Promise<void>;
     closeAppModal: () => void;
     getCurrentModeConfig: (app: AppFile) => {

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

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

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

@@ -0,0 +1,112 @@
+import { ComputedRef, Ref } from 'vue';
+import { CanvasRetrieve } from '../../../../types/openapi';
+/**
+ * Presentation tools rail (PIT-8031): the instance's embeddable-only section canvases —
+ * the SAME roster the pitchdeck wizard offers (next-core `resolve-embeddable-only-slides`)
+ * — openable as a modal OVER the running deck, independent of deck content.
+ *
+ * This is the decoupled successor to the "hidden section list" workaround: tool
+ * availability no longer requires the tool to be a slide in the deck
+ * (`useInstalledEmbeddables` filters by deck content; this roster deliberately does not).
+ * "Add tool as agenda point" in the wizard stays the way to put a tool INTO the deck/ToC.
+ *
+ * Opt-in via the `canvas.enable_presentation_tools` org/instance setting (default off),
+ * Impact mode only. Both platform surfaces degrade silently: no `coreRestApiAxios` (host
+ * without core API — incl. iOS `file://` apps, which are CORS-jailed for direct core
+ * fetches) or no `fetchCanvas` → the button never appears.
+ */
+export interface PresentationTool {
+    /** The tool's section canvas id. */
+    id: string;
+    name: string;
+    /**
+     * The installed app's `app.json` icon, RAW as stored (`fas fa-building-columns`,
+     * `far fa-browser`, `fa-kit fa-…`, or a bare name) — normalise with `getAppIconProps()`
+     * before handing it to `CIcon`. `null` when the roster could not resolve the app
+     * (uninstalled, or an older endpoint that predates PIT-8274) → render the generic glyph.
+     * The tool canvas's `thumbnail_url` is deliberately NOT carried: it is a screenshot of
+     * the slide, and the overlay shows app icons like every other app surface (PIT-8274).
+     */
+    icon: string | null;
+}
+type CanvasSection = CanvasRetrieve['sections'][number];
+/**
+ * Section ids THIS composable injected into `activeCanvas.sections`. Ids already present
+ * as real deck slides are never added. The one consumer is `closeTool`, which unregisters
+ * them so nothing outlives the modal. (The shortcuts derivation no longer needs the set:
+ * `useInstalledEmbeddables` now filters the sections lookup through the deck's OWN
+ * SectionList/ContentList refs — PIT-8031 QA Q1 — which excludes injected entries by
+ * construction.) Replaced, not mutated, so computeds re-run.
+ */
+export declare const injectedToolSectionIds: Ref<{
+    forEach: (callbackfn: (value: string, value2: string, set: ReadonlySet<string>) => void, thisArg?: any) => void;
+    has: (value: string) => boolean;
+    readonly size: number;
+    entries: () => SetIterator<[string, string]>;
+    keys: () => SetIterator<string>;
+    values: () => SetIterator<string>;
+    union: <U>(other: ReadonlySetLike<U>) => Set<string | U>;
+    intersection: <U>(other: ReadonlySetLike<U>) => Set<string & U>;
+    difference: <U>(other: ReadonlySetLike<U>) => Set<string>;
+    symmetricDifference: <U>(other: ReadonlySetLike<U>) => Set<string | U>;
+    isSubsetOf: (other: ReadonlySetLike<unknown>) => boolean;
+    isSupersetOf: (other: ReadonlySetLike<unknown>) => boolean;
+    isDisjointFrom: (other: ReadonlySetLike<unknown>) => boolean;
+    [Symbol.iterator]: () => SetIterator<string>;
+}, ReadonlySet<string> | {
+    forEach: (callbackfn: (value: string, value2: string, set: ReadonlySet<string>) => void, thisArg?: any) => void;
+    has: (value: string) => boolean;
+    readonly size: number;
+    entries: () => SetIterator<[string, string]>;
+    keys: () => SetIterator<string>;
+    values: () => SetIterator<string>;
+    union: <U>(other: ReadonlySetLike<U>) => Set<string | U>;
+    intersection: <U>(other: ReadonlySetLike<U>) => Set<string & U>;
+    difference: <U>(other: ReadonlySetLike<U>) => Set<string>;
+    symmetricDifference: <U>(other: ReadonlySetLike<U>) => Set<string | U>;
+    isSubsetOf: (other: ReadonlySetLike<unknown>) => boolean;
+    isSupersetOf: (other: ReadonlySetLike<unknown>) => boolean;
+    isDisjointFrom: (other: ReadonlySetLike<unknown>) => boolean;
+    [Symbol.iterator]: () => SetIterator<string>;
+}>;
+/**
+ * Reset ALL module-level state — for test isolation (spec `beforeEach`). Without this,
+ * `toolSectionCache`/`fetchedForInstance`/`selectedTool` survive between cases, so a test
+ * reusing a tool id would silently hit the cache and skip the fetch path it means to cover.
+ */
+export declare function resetPresentationToolsState(): void;
+/**
+ * A tool canvas is a full `CanvasRetrieve`; the deck's section machinery wants the
+ * `CanvasSection` shape. The content tree sits at `sections[0].content.data` when the tool
+ * canvas nests one, else `content.data` (same normalization as DynamicContent's
+ * `getSectionComponents`).
+ */
+export declare function toolCanvasToSection(canvas: CanvasRetrieve): CanvasSection;
+export declare function usePresentationTools(): {
+    tools: ComputedRef<{
+        id: string;
+        name: string;
+        icon: string | null;
+    }[]>;
+    hasSingleTool: ComputedRef<boolean>;
+    shouldShowTools: ComputedRef<boolean>;
+    isFrameless: ComputedRef<boolean>;
+    isFetchingToolSection: ComputedRef<boolean>;
+    selectedTool: ComputedRef<{
+        id: string;
+        name: string;
+        icon: string | null;
+    } | null>;
+    selectedToolSection: ComputedRef<{
+        readonly id: string;
+        name: string;
+        content: Record<string, any>;
+        theme?: (Record<string, any> | null) | undefined;
+        metadata?: Record<string, any> | undefined;
+        is_draft: boolean;
+    } | null>;
+    ensureTools: () => Promise<void>;
+    openTool: (tool: PresentationTool) => Promise<void>;
+    closeTool: () => void;
+};
+export {};

package/lib/apps/canvas-builder/composables/usePresentationTools.spec.d.ts

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