@pitcher/js-api 1.30.0 → 1.31.0

package/lib/apps/content-selector/appTypes.d.ts

@@ -26,6 +26,22 @@ export type AppProps = {
     minSelections?: Range<0, 999>;
     disableNoSharable?: boolean;
     disableNoPptxData?: boolean;
+    /**
+     * The mounting host's file source cannot decompose a file into pages, so the per-item
+     * "Expand file" action is withheld. Default `false` — sales mounts pass nothing and keep it.
+     *
+     * Expanding renders one tile per entry in the fetched file's `content_thumbnails`
+     * (FoldersFilesList.vue / FoldersFilesGrid.vue); with none, the view falls through to its
+     * "thumbnails are missing — re-upload the PDF" empty state. That state is correct advice for a
+     * sales `pitcher_files` PDF whose thumbnail generation failed, and WRONG for a source that never
+     * generates page thumbnails at all: re-uploading changes nothing. Set this where the second is
+     * true, so the action is absent rather than a button that always dead-ends.
+     *
+     * Set by the L&D course host (PIT-7083 QA-4): ld-app populates `contentThumbnails` only on its two
+     * video paths, as a single cover image — the PDF path ingests straight into PSPDFKit and appends
+     * none (ldIngestService.ts), so an L&D PDF's `content_thumbnails` is permanently `[]`.
+     */
+    disableFileExpansion?: boolean;
     onlyAllowContentPdfPages?: boolean;
     allowFolderSelection?: boolean;
 };

package/lib/apps/content-selector/components/Content/AllContent/List/expandFileGuard.spec.d.ts

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

package/lib/apps/notes/NotesApp.accountNotes.spec.d.ts

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

package/lib/apps/notes/NotesApp.speakerNotes.spec.d.ts

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

package/lib/apps/notes/composables/useAccountNotes.d.ts

@@ -0,0 +1,14 @@
+import { MaybeRefOrGetter, ComputedRef, WritableComputedRef } from 'vue';
+export declare const NOTES_APP_CONTENT_KEY = "notes_app_content";
+/**
+ * PIT-8143: under `enable_account_only_meeting_notes`, meeting notes are scoped
+ * to the meeting bar's selected account. Each account gets its own localStorage
+ * bucket; the legacy key doubles as the "mode off / no account" bucket, so
+ * pre-existing free-floating notes keep working unchanged.
+ */
+export declare function accountNotesBucketKey(baseKey: string, accountId: string | null): string;
+export declare function useAccountNotes(baseKey?: string, enabled?: MaybeRefOrGetter<boolean>): {
+    content: WritableComputedRef<string>;
+    accountId: ComputedRef<string | null>;
+    storageKey: ComputedRef<string>;
+};

package/lib/apps/notes/composables/useAccountNotes.spec.d.ts

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

package/lib/apps/notes/composables/useAccountOnlyNotesGate.d.ts

@@ -0,0 +1,21 @@
+import { ComputedRef, MaybeRefOrGetter } from 'vue';
+import { InstanceSettings } from '../../../types/instanceSettings.types';
+type PitcherSettings = InstanceSettings;
+/**
+ * PIT-8144: under `enable_account_only_meeting_notes`, the notes app is HIDDEN everywhere while no
+ * account is selected — not rendered as a disabled tab. Every entry point (slotty TopBar,
+ * canvas-builder ControlBar/BottomBar, the collection player header, Impact's file viewer) and both
+ * widget mounts share this gate, so they can never drift apart.
+ *
+ * The signal is `call.selectedAccount.Id` and deliberately nothing broader — it is the exact key
+ * `useAccountNotes` buckets keystrokes by, so visibility and bucketing always agree. A pitchdeck
+ * that carries its own account satisfies it through deck-context adoption
+ * (`resolveDeckContextAdoption` in slotty), which writes that account into the call store.
+ *
+ * `settings` is for hosts that PROVIDE `pitcherSettings` themselves (slotty App.vue, Impact
+ * authenticated.vue) — a component cannot inject its own provide. Children omit it and inject.
+ */
+export declare function useAccountOnlyNotesGate(settings?: MaybeRefOrGetter<PitcherSettings | undefined>): {
+    isNotesAppHidden: ComputedRef<boolean>;
+};
+export {};

package/lib/apps/notes/composables/useAccountOnlyNotesGate.spec.d.ts

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

package/lib/apps/notes/composables/useActiveSlideNotes.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Speaker notes for the slide currently on screen in a FILE viewer — the standard
+ * PSPDFKit viewer or the Collection Player — as opposed to the canvas-builder's
+ * `active-section-metadata`, which only ever describes a converted section.
+ *
+ * localStorage rather than a shared ref because NotesApp runs in three contexts that
+ * share an origin but not a JS realm: the Impact widget, the slotty widget, and the
+ * `?fullscreen_notes=true` popup window.
+ */
+export declare const ACTIVE_SLIDE_NOTES_KEY = "active-slide-notes";
+export interface ActiveSlideNotes {
+    file_id: string;
+    /** 0-based position in `metadata.pptx_data.slides` — equal to the PSPDFKit page index. */
+    slide_index: number;
+    title: string;
+    note: string;
+}
+/**
+ * The narrow slice of a file both producers can supply (`PitcherFile`, `CollectionFileEntity`).
+ *
+ * `metadata` stays an open record because it genuinely is one — it maps a Django JSONField, and
+ * `FileMetadata` declares `[key: string]: any` for that reason. Declaring the `pptx_data` shape
+ * here instead would make this a weak type that neither caller's metadata satisfies. The shape is
+ * enforced at runtime by `readSlides` below, which is where an untyped blob has to be checked anyway.
+ */
+interface SlideNotesSource {
+    id: string;
+    metadata?: Record<string, unknown> | null;
+}
+/** Read side — consumed by NotesApp. */
+export declare function useActiveSlideNotes(): import('@vueuse/shared').RemovableRef<ActiveSlideNotes | null>;
+/**
+ * Resolve `file.metadata.pptx_data.slides[pageIndex]` and publish just the two fields the
+ * Speaker Notes tab renders. The slide's `content` is deliberately left out: `pptx_data` runs
+ * to tens of KB and this is rewritten on every page turn.
+ *
+ * Clears the key when the file has no extracted pptx data or the page is out of range, so a
+ * non-PPTX file never inherits the previous file's note.
+ */
+export declare function setActiveSlideNotes(file: SlideNotesSource | null | undefined, pageIndex: number): void;
+export declare function clearActiveSlideNotes(): void;
+export {};

package/lib/apps/notes/composables/useActiveSlideNotes.spec.d.ts

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

package/lib/components/CFileAccessManagement/collaborationApi.d.ts

@@ -0,0 +1,2 @@
+import { createHighLevelApi } from '../../sdk/api/HighLevelApi';
+export declare function useCollaborationApi(): ReturnType<typeof createHighLevelApi>;

package/lib/components/CFilePanel/Details.spec.d.ts

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

package/lib/components/CFilePanel/KeyMessages.spec.d.ts

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

package/lib/components/CFilePanel/Summary.spec.d.ts

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

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

@@ -15,3 +15,55 @@ import { default as PSPDFKitType } from '@nutrient-sdk/viewer';
  * actually disposes the stuck dialog.
  */
 export declare function safePspdfkitUnload(pspdfkit: Pick<typeof PSPDFKitType, 'unload'> | undefined, container: HTMLElement | null): void;
+/** What a keypress in the PDF viewer should do, or `null` for "ignore it". */
+export type FileViewerKeyAction = 'next' | 'previous' | 'first' | 'last' | null;
+/**
+ * Is the user typing into something? PDF AcroForm fields and rich-text
+ * annotations are editable in this viewer (PIT-7330), and there the arrow keys
+ * move the caret. Changing page out from under someone mid-edit would be a worse
+ * bug than the one this guard ships alongside.
+ *
+ * Deliberately duck-typed instead of `instanceof HTMLInputElement` (which is how
+ * NavigatorPresentation.vue does it). That works there because it listens on
+ * `window`, in the same realm. Our listener is attached to
+ * `instance.contentDocument`, so a target can belong to a DIFFERENT document
+ * realm, where `instanceof` against this realm's constructors is always false —
+ * it would silently disable the guard rather than fail loudly.
+ */
+export declare function isTextEntryTarget(target: unknown): boolean;
+/**
+ * Is an overlay open that owns the paging keys itself?
+ *
+ * Naive's dropdown binds `keydown` on `document` via vooks' `useKeyboard` — the exact
+ * target this composable now uses — while `keyboard && show` are true. So an open
+ * annotation menu would navigate the menu AND page the file behind it, with our
+ * `preventDefault()` on top. `.n-dropdown` only exists in the DOM while open.
+ *
+ * Drawers (file info, page metadata) scroll their own content, so `PageUp`/`PageDown`/
+ * `Home`/`End` belong to the panel whenever the press came from inside one.
+ */
+export declare function isPagingOverlayActive(target: unknown): boolean;
+/**
+ * Does `instance.contentDocument` need its own key listener?
+ *
+ * The SDK types it `Document | ShadowRoot`: normally it is the viewer's SHADOW ROOT,
+ * and `keydown` is a composed event, so presses inside it also reach the host
+ * `document` — one listener there is enough, and adding a second on the shadow root
+ * would fire the handler twice for the same press (advancing two pages).
+ *
+ * Under the SDK's iframe fallback it is a separate `Document` instead, whose events
+ * never reach the host at all, so that case does need its own listener.
+ *
+ * Checked by `nodeType` rather than `instanceof Document`: an iframe's document
+ * belongs to another realm, where `instanceof` against our constructors is false —
+ * the exact trap `isTextEntryTarget` documents.
+ */
+export declare function needsOwnKeyListener(contentDocument: unknown): boolean;
+/**
+ * Map a keydown to a page-navigation action, or `null` when it should be left alone.
+ *
+ * Split out so it can be unit-tested — the handler that consumes it lives inside a
+ * composable that needs a live PSPDFKit instance. It reads the event and (via
+ * `isPagingOverlayActive`) the document, but touches no viewer state.
+ */
+export declare function resolveFileViewerKeyAction(event: KeyboardEvent): FileViewerKeyAction;

package/lib/components/CGlobalLoader/CGlobalLoaderMark.spec.d.ts

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

package/lib/components/CGlobalLoader/globalLoader.paths.d.ts

@@ -0,0 +1,2 @@
+export declare const GLOBAL_LOADER_PATH_1: readonly ["M45,0.1080000028014183 C45,22.57200050354004 45,45 45,45 C45,45 22.42799949645996,45 -0.1080000028014183,45", "M45,0.3959999978542328 C45,22.76300048828125 45,45 45,45 C45,45 22.235000610351562,45 -0.3959999978542328,45", "M45,0.8640000224113464 C45,23.07200050354004 45,45 45,45 C45,45 21.920000076293945,45 -0.8640000224113464,45", "M45,1.5839999914169312 C45,23.54400062561035 45,45 45,45 C45,45 21.430999755859375,45 -1.5839999914169312,45", "M45,2.5920000076293945 C45,24.195999145507812 45,45 45,45 C45,45 20.738000869750977,45 -2.5920000076293945,45", "M45,3.888000011444092 C45,25.020000457763672 45,45 45,45 C45,45 19.829999923706055,45 -3.888000011444092,45", "M45,5.6519999504089355 C45,26.118000030517578 45,45 45,45 C45,45 18.56399917602539,45 -5.6519999504089355,45", "M45,7.631999969482422 C45,27.31999969482422 45,45 45,45 C45,45 17.100000381469727,45 -7.631999969482422,45", "M45,10.116000175476074 C45,28.783000946044922 45,45 45,45 C45,45 15.190999984741211,45 -10.116000175476074,45", "M45,13.211999893188477 C45,30.540000915527344 45,45 45,45 C45,45 12.6899995803833,45 -13.211999893188477,45", "M45,17.20800018310547 C45,32.707000732421875 45,45 45,45 C45,45 9.230999946594238,45 -17.20800018310547,45", "M45,21.816999435424805 C45,35.07500076293945 45,45 45,45 C45,45 4.848999977111816,45 -21.816999435424805,45", "M45,27.792999267578125 C45,37.94900131225586 45,45 45,45 C45,45 -1.6679999828338623,45 -27.792999267578125,45", "M45,34.95600128173828 C45,41.11399841308594 45,45 45,45 C45,45 -11.482000350952148,45 -34.95600128173828,45", "M45,43.99399948120117 C45,44.650001525878906 45,45 45,45 C45,45 -34.12799835205078,45 -43.99399948120117,45", "M34.130001068115234,45 C10.1850004196167,45 -45,45 -45,45 C-45,45 -45,40.763999938964844 -45,34.130001068115234", "M18.4689998626709,45 C-8.07800006866455,45 -45,45 -45,45 C-45,45 -45,33.36899948120117 -45,18.4689998626709", "M0.25200000405311584,45 C-22.332000732421875,45 -45,45 -45,45 C-45,45 -45,22.667999267578125 -45,0.25200000405311584", "M-19.799999237060547,45 C-34.055999755859375,45 -45,45 -45,45 C-45,45 -45,6.824999809265137 -45,-19.799999237060547", "M-35.89400100708008,45 C-41.50600051879883,45 -45,45 -45,45 C-45,45 -45,-13.026000022888184 -45,-35.89400100708008", "M-45,41.32899856567383 C-45,24.437000274658203 -45,-45 -45,-45 C-45,-45 -43.667999267578125,-45 -41.32899856567383,-45", "M-45,31.35700035095215 C-45,6.190000057220459 -45,-45 -45,-45 C-45,-45 -39.56100082397461,-45 -31.35700035095215,-45", "M-45,24.37299919128418 C-45,-2.197000026702881 -45,-45 -45,-45 C-45,-45 -36.33000183105469,-45 -24.37299919128418,-45", "M-45,18.361000061035156 C-45,-8.178000450134277 -45,-45 -45,-45 C-45,-45 -33.3120002746582,-45 -18.361000061035156,-45", "M-45,13.680000305175781 C-45,-12.298999786376953 -45,-45 -45,-45 C-45,-45 -30.799999237060547,-45 -13.680000305175781,-45", "M-45,10.116000175476074 C-45,-15.190999984741211 -45,-45 -45,-45 C-45,-45 -28.783000946044922,-45 -10.116000175476074,-45", "M-45,7.343999862670898 C-45,-17.31599998474121 -45,-45 -45,-45 C-45,-45 -27.14699935913086,-45 -7.343999862670898,-45", "M-45,5.1479997634887695 C-45,-18.93000030517578 -45,-45 -45,-45 C-45,-45 -25.80699920654297,-45 -5.1479997634887695,-45", "M-45,3.312000036239624 C-45,-20.236000061035156 -45,-45 -45,-45 C-45,-45 -24.6560001373291,-45 -3.312000036239624,-45", "M-45,2.052000045776367 C-45,-21.111000061035156 -45,-45 -45,-45 C-45,-45 -23.847999572753906,-45 -2.052000045776367,-45", "M-45,1.0800000429153442 C-45,-21.77400016784668 -45,-45 -45,-45 C-45,-45 -23.214000701904297,-45 -1.0800000429153442,-45", "M-45,0.46799999475479126 C-45,-22.187000274658203 -45,-45 -45,-45 C-45,-45 -22.81100082397461,-45 -0.46799999475479126,-45", "M-45,0.1080000028014183 C-45,-22.42799949645996 -45,-45 -45,-45 C-45,-45 -22.57200050354004,-45 -0.1080000028014183,-45", "M-45,0 C-45,-22.5 -45,-45 -45,-45 C-45,-45 -22.5,-45 0,-45", "M-45,0 C-45,-22.5 -45,-45 -45,-45 C-45,-45 -22.5,-45 0,-45", "M45,0 C45,22.5 45,45 45,45 C45,45 22.5,45 0,45"];
+export declare const GLOBAL_LOADER_PATH_2: readonly ["M45,0.07199999690055847 C45,22.54800033569336 45,45 45,45 C45,45 22.45199966430664,45 -0.07199999690055847,45", "M45,0.36000001430511475 C45,22.73900032043457 45,45 45,45 C45,45 22.259000778198242,45 -0.36000001430511475,45", "M45,0.8640000224113464 C45,23.07200050354004 45,45 45,45 C45,45 21.920000076293945,45 -0.8640000224113464,45", "M45,1.5479999780654907 C45,23.520000457763672 45,45 45,45 C45,45 21.45599937438965,45 -1.5479999780654907,45", "M45,2.555999994277954 C45,24.17300033569336 45,45 45,45 C45,45 20.76300048828125,45 -2.555999994277954,45", "M45,3.8519999980926514 C45,24.996999740600586 45,45 45,45 C45,45 19.856000900268555,45 -3.8519999980926514,45", "M45,5.507999897003174 C45,26.030000686645508 45,45 45,45 C45,45 18.66900062561035,45 -5.507999897003174,45", "M45,7.631999969482422 C45,27.31999969482422 45,45 45,45 C45,45 17.100000381469727,45 -7.631999969482422,45", "M45,10.079999923706055 C45,28.761999130249023 45,45 45,45 C45,45 15.218999862670898,45 -10.079999923706055,45", "M45,13.28499984741211 C45,30.579999923706055 45,45 45,45 C45,45 12.630000114440918,45 -13.28499984741211,45", "M45,17.100000381469727 C45,32.650001525878906 45,45 45,45 C45,45 9.32800006866455,45 -17.100000381469727,45", "M45,21.7450008392334 C45,35.03900146484375 45,45 45,45 C45,45 4.921999931335449,45 -21.7450008392334,45", "M45,27.253000259399414 C45,37.698001861572266 45,45 45,45 C45,45 -1.0299999713897705,45 -27.253000259399414,45", "M45,34.777000427246094 C45,41.03799819946289 45,45 45,45 C45,45 -11.196999549865723,45 -34.777000427246094,45", "M45,43.308998107910156 C45,44.40399932861328 45,45 45,45 C45,45 -30.948999404907227,45 -43.308998107910156,45", "M35.02899932861328,45 C11.598999977111816,45 -45,45 -45,45 C-45,45 -45,41.14400100708008 -45,35.02899932861328", "M20.089000701904297,45 C-6.547999858856201,45 -45,45 -45,45 C-45,45 -45,34.202999114990234 -45,20.089000701904297", "M0.46799999475479126,45 C-22.187000274658203,45 -45,45 -45,45 C-45,45 -45,22.81100082397461 -45,0.46799999475479126", "M-19.04400062561035,45 C-33.66699981689453,45 -45,45 -45,45 C-45,45 -45,7.540999889373779 -45,-19.04400062561035", "M-35.388999938964844,45 C-41.29499816894531,45 -45,45 -45,45 C-45,45 -45,-12.1850004196167 -45,-35.388999938964844", "M-45,41.4739990234375 C-45,24.836999893188477 -45,-45 -45,-45 C-45,-45 -43.722999572753906,-45 -41.4739990234375,-45", "M-45,31.716999053955078 C-45,6.679999828338623 -45,-45 -45,-45 C-45,-45 -39.71900177001953,-45 -31.716999053955078,-45", "M-45,24.44499969482422 C-45,-2.119999885559082 -45,-45 -45,-45 C-45,-45 -36.3650016784668,-45 -24.44499969482422,-45", "M-45,18.4689998626709 C-45,-8.07800006866455 -45,-45 -45,-45 C-45,-45 -33.36899948120117,-45 -18.4689998626709,-45", "M-45,13.968000411987305 C-45,-12.055999755859375 -45,-45 -45,-45 C-45,-45 -30.958999633789062,-45 -13.968000411987305,-45", "M-45,10.331999778747559 C-45,-15.020999908447266 -45,-45 -45,-45 C-45,-45 -28.906999588012695,-45 -10.331999778747559,-45", "M-45,7.380000114440918 C-45,-17.288999557495117 -45,-45 -45,-45 C-45,-45 -27.16900062561035,-45 -7.380000114440918,-45", "M-45,5.21999979019165 C-45,-18.878000259399414 -45,-45 -45,-45 C-45,-45 -25.851999282836914,-45 -5.21999979019165,-45", "M-45,3.4200000762939453 C-45,-20.15999984741211 -45,-45 -45,-45 C-45,-45 -24.724000930786133,-45 -3.4200000762939453,-45", "M-45,2.052000045776367 C-45,-21.111000061035156 -45,-45 -45,-45 C-45,-45 -23.847999572753906,-45 -2.052000045776367,-45", "M-45,1.1160000562667847 C-45,-21.75 -45,-45 -45,-45 C-45,-45 -23.238000869750977,-45 -1.1160000562667847,-45", "M-45,0.46799999475479126 C-45,-22.187000274658203 -45,-45 -45,-45 C-45,-45 -22.81100082397461,-45 -0.46799999475479126,-45", "M-45,0.1080000028014183 C-45,-22.42799949645996 -45,-45 -45,-45 C-45,-45 -22.57200050354004,-45 -0.1080000028014183,-45", "M-45,0 C-45,-22.5 -45,-45 -45,-45 C-45,-45 -22.5,-45 0,-45", "M-45,0 C-45,-22.5 -45,-45 -45,-45 C-45,-45 -22.5,-45 0,-45", "M45,0 C45,22.5 45,45 45,45 C45,45 22.5,45 0,45"];

package/lib/components/CGlobalSearch/globalSearchTarget.util.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Decides whether a bare keystroke arriving at the `document` should be treated as a global
+ * shortcut (`/` opens omni-search) or as literal text the user is typing into a field.
+ *
+ * The subtlety this file exists for: the Meeting Bar V3 widget renders inside
+ * `attachShadow({ mode: 'open' })` (see `slotty-ui-ng/.../MeetingBarV3Embed.vue`), and a composed
+ * event crossing a shadow boundary has its `target` **retargeted to the host element**. A
+ * document-level listener therefore sees the host `<div>`, never the `<input>` the rep is typing
+ * in — so a naive `event.target.tagName` check waves the keystroke through and `/` tears the
+ * account-selector flyout down mid-search (PIT-8130).
+ */
+/**
+ * The element actually receiving `event` — piercing any open shadow roots between it and the
+ * `document` listener that observed the event.
+ *
+ * `composedPath()` is the flattened path the event really travelled, so its first entry is the
+ * innermost node regardless of how many shadow boundaries sit above it, where `event.target` has
+ * already been retargeted to the outermost host. Real keyboard events are always `composed`; the
+ * `event.target` fallback covers a synthetic one that isn't (and a closed shadow root, where
+ * neither can see past the host).
+ *
+ * MUST be called synchronously from the event listener: `composedPath()` returns `[]` once
+ * dispatch has finished, which silently degrades this back to the retargeted `event.target` and
+ * reintroduces PIT-8130. Never defer it behind a `setTimeout`/`nextTick`.
+ */
+export declare const resolveKeystrokeTarget: (event: KeyboardEvent) => Element | null;
+/**
+ * `true` when `event` is a bare keystroke that no editable field is claiming, i.e. it is safe to
+ * consume as a global shortcut.
+ */
+export declare const isTargetAllowed: (event: KeyboardEvent) => boolean;

package/lib/components/CGlobalSearch/globalSearchTarget.util.test.d.ts

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

package/lib/components/CRichTextEditor/extensions/paragraphExtended.d.ts

@@ -11,10 +11,16 @@ export declare const styling: {
         fontSize: number;
     };
 };
+/**
+ * `data-size` is read straight off authored HTML, so it can carry any string. Canvas content
+ * built by scripts/templates has been seen with heading values on a `<p>` (`data-size="h1"`),
+ * which is not a paragraph size and has no `styling` entry.
+ */
+export declare const isParagraphSize: (value: unknown) => value is Paragraphs;
 declare module '@tiptap/core' {
     interface Commands<ReturnType> {
         paragraphExtended: {
-            setParagraphExtended: (size: string) => ReturnType;
+            setParagraphExtended: (size: Paragraphs) => ReturnType;
         };
     }
 }

package/lib/components/CRichTextEditor/extensions/paragraphExtended.test.d.ts

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

package/lib/components/canvases/CanvasesManagementBulk.use.d.ts

@@ -9,6 +9,16 @@ interface BaseBulkProps {
     confirmText?: string;
     cancelText?: string;
 }
+/**
+ * What the dialogs NAME the selected rows as — a superset of `CanvasType` (PIT-8360 QA).
+ *
+ * `'master-canvas'` is deliberately not a `CanvasType`: that type is the API's `canvas_type`, sent
+ * as-is to the instance-tags endpoint by `bulkAddTagsDialog`, and there is no such server-side
+ * type. It exists only to pick the noun these dialogs put in front of the user, so it is confined
+ * to the two dialogs the masters tab actually opens (delete and manage attributes) — the tag
+ * dialogs, which are hidden on that tab, keep the narrower `CanvasType`.
+ */
+export type BulkEntityType = CanvasType | 'master-canvas';
 interface BulkUpdateFileAttributeProps extends BaseBulkProps {
     fileNames: string[];
     metadataFetcher?: (params?: GetInstanceMetadataTemplatesPayload) => Promise<PaginatedMetadataTemplateList>;
@@ -22,7 +32,7 @@ interface BulkUpdateMetadataDialogProps extends BaseBulkProps {
     noMetadataErrorText?: string;
     subtitle?: string;
     isBulkUpdating: Ref<boolean>;
-    canvasType: CanvasType;
+    canvasType: BulkEntityType;
     updater?: (params: PatchedCanvasUpdateRequest & {
         id: CanvasRetrieve['id'];
         fields?: string;
@@ -31,7 +41,7 @@ interface BulkUpdateMetadataDialogProps extends BaseBulkProps {
 interface BulkDeleteDialogProps extends BaseBulkProps {
     filteredData: ComputedRef<CanvasRetrieve[]>;
     isBulkDeleting: Ref<boolean>;
-    canvasType: CanvasType;
+    canvasType: BulkEntityType;
     isReadonly?: (canvas: CanvasRetrieve) => boolean;
     content?: string;
 }

package/lib/components/masterCanvases/CMasterCanvasesManagement.use.d.ts

@@ -0,0 +1,86 @@
+import { CanvasRetrieve } from '../../../types/openapi';
+/**
+ * PIT-7488 — row actions on a master pitchdeck, from the signed-off prototype's `…` menu.
+ *
+ * Same vocabulary as the pitchdeck tab, minus `use-as-master` (a master cannot become one) and
+ * plus `share` (sharing a master with colleagues, which ordinary decks do not do).
+ */
+export type MasterCanvasAction = 'view' | 'edit' | 'open-new-tab' | 'freeze' | 'share' | 'duplicate' | 'delete';
+/** Dialogs the master tab owns. `create-from-master` belongs to the create flow (block 4). */
+export type MasterCanvasDialog = {
+    type: 'share';
+    canvasId: CanvasRetrieve['id'];
+} | {
+    type: 'duplicate';
+    canvasId: CanvasRetrieve['id'];
+} | {
+    type: 'confirm-delete';
+    canvasId: CanvasRetrieve['id'];
+};
+/** Actions the host performs directly — no confirmation step. */
+export type MasterCanvasPassthroughAction = Exclude<MasterCanvasAction, 'share' | 'duplicate' | 'delete'>;
+/**
+ * What a row action resolves to. Splitting these two apart is the point of this module: the
+ * prototype's `onRowAction` switch conflates "open a dialog" with "do the thing", and the two
+ * have completely different owners in production — dialogs are local state, whereas view / edit /
+ * download / freeze are host callbacks that already exist on the pitchdeck tab.
+ */
+export type MasterCanvasActionResolution = {
+    kind: 'dialog';
+    dialog: MasterCanvasDialog;
+} | {
+    kind: 'passthrough';
+    action: MasterCanvasPassthroughAction;
+};
+export declare function resolveMasterCanvasAction(action: MasterCanvasAction, canvasId: CanvasRetrieve['id']): MasterCanvasActionResolution;
+/**
+ * Dialog state for the master tab.
+ *
+ * This is the ONLY part of the PoC reducer that survives contact with production: its list
+ * mutations (create / duplicate / delete / share) all rewrote an in-memory array, whereas here
+ * the list comes from the host's `fetcher` and a mutation is a request plus a refetch — machinery
+ * `CSavedCanvasesManagement` already owns. So this deliberately holds no rows.
+ */
+export declare function useMasterCanvasDialogs(): {
+    dialog: import('vue').Ref<{
+        type: "share";
+        canvasId: CanvasRetrieve["id"];
+    } | {
+        type: "duplicate";
+        canvasId: CanvasRetrieve["id"];
+    } | {
+        type: "confirm-delete";
+        canvasId: CanvasRetrieve["id"];
+    } | null, MasterCanvasDialog | {
+        type: "share";
+        canvasId: CanvasRetrieve["id"];
+    } | {
+        type: "duplicate";
+        canvasId: CanvasRetrieve["id"];
+    } | {
+        type: "confirm-delete";
+        canvasId: CanvasRetrieve["id"];
+    } | null>;
+    openDialog: (next: MasterCanvasDialog) => void;
+    closeDialog: () => void;
+    handleAction: (action: MasterCanvasAction, canvasId: CanvasRetrieve["id"]) => MasterCanvasPassthroughAction | null;
+};
+export interface ShouldOfferUseToCreateOptions {
+    /** The permission/settings gate the pitchdeck cell also applies. */
+    canUseToCreate: boolean;
+}
+/**
+ * Whether a master's row may offer "Use to create pitchdeck" (PIT-7488 QA Q12).
+ *
+ * The `!isDraft` term is GONE as of PIT-8360, along with the Ready column that was the only control
+ * able to clear the flag. Keeping it would have stranded two populations for good: every new master
+ * (created as a Draft until this change) and every master already created as one — hidden from the
+ * row action here and filtered out of the creation picker, with nothing left to flip.
+ *
+ * So a master is offerable whenever the caller may create from one. Masters no longer carry a
+ * meaningful draft state; `is_draft` survives on the model because every canvas has it, not because
+ * anything on this tab means anything by it.
+ *
+ * Hidden rather than disabled, matching how this cell already treats an unavailable lead action.
+ */
+export declare function shouldOfferUseToCreate(opts: ShouldOfferUseToCreateOptions): boolean;

package/lib/components/masterCanvases/CMasterCanvasesManagement.use.spec.d.ts

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

package/lib/components/masterCanvases/CMasterCanvasesPendingShareCell.spec.d.ts

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

package/lib/components/masterCanvases/CMasterCanvasesSharedWithCell.use.d.ts

@@ -0,0 +1,39 @@
+import { MiniUser } from '../../../types/openapi';
+/**
+ * PIT-7488 — display logic for the master pitchdeck "Shared with" cell.
+ *
+ * Kept out of the SFC so the capping/label rules are unit-testable: the cell itself is then a
+ * thin renderer over this result.
+ *
+ * The list is `Collaboration['user']` (a `MiniUser`) — block 5 is what will actually populate it.
+ */
+/** Avatars rendered before collapsing the rest into a "+N" bubble. From the prototype. */
+export declare const MAX_SHARED_WITH_AVATARS = 3;
+export interface SharedWithSummary {
+    /** Users to render an avatar for, capped at `max`. */
+    shown: MiniUser[];
+    /** How many users the cap hid. `0` when everyone fits. */
+    overflow: number;
+    /** Compact text beside the avatar stack. */
+    label: string;
+    /** Every name, for the hover tooltip and the aria-label. */
+    allNames: string;
+}
+/**
+ * Names in list order, blank-name users resolved to their email (SSO users frequently have no
+ * populated name — PIT-5973), and users with neither dropped rather than rendered as an
+ * empty comma.
+ */
+export declare function sharedWithNames(users: MiniUser[]): string[];
+/**
+ * The compact label beside the avatar stack: every shown name, then "+N" for the rest.
+ *
+ * Note the prototype (`next-core/src/app/examples/master-pitchdeck-ng/components/
+ * SharedWithCell.tsx`) contradicts itself — its comment promises "first two names + +N" while
+ * its code joins all three *shown* names. We follow the code. The label truncates in a narrow
+ * column, which is accepted: the tooltip always carries the full list.
+ *
+ * `names` is already email-resolved and blank-filtered; `overflow` is how many the cap hid.
+ */
+export declare function buildSharedWithLabel(names: string[], overflow: number): string;
+export declare function summarizeSharedWith(users: MiniUser[], max?: number): SharedWithSummary;

package/lib/components/masterCanvases/CMasterCanvasesSharedWithCell.use.spec.d.ts

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