@kortix/ui 0.14.8 → 0.14.9

package/dist/files/project/components/change-request-detail-dialog.js

@@ -18,9 +18,10 @@ import { useTranslations } from '../../../i18n/index.js';
  */
 import { UnifiedMarkdown } from '../../../markdown/index.js';
 import { Button } from '../../../primitives/button.js';
+import { ButtonGroup } from '../../../primitives/button-group.js';
 import { InfoBanner } from '../../../primitives/info-banner.js';
 import Loading from '../../../primitives/loading.js';
-import { Modal, ModalContent, ModalHeader, ModalTitle } from '../../../primitives/modal.js';
+import { Modal, ModalClose, ModalContent, ModalHeader, ModalTitle } from '../../../primitives/modal.js';
 import { Skeleton } from '../../../primitives/skeleton.js';
 import { errorToast, successToast } from '../../../primitives/toast.js';
 import { ChangeList, ChangeSummary, DiffLayoutToggle, ExpandAllButton, diffViewportClass, entryFromCommitFile, fileCount, proposedChangeTimeline, splitUnifiedPatch, useChangeExpansion, } from '../../../changes/index.js';
@@ -28,10 +29,12 @@ import { EmptyState } from '../../../primitives/empty-state.js';
 import { manifestFilename, useProjectManifestVersion, } from '../../../internal/lib/manifest-version.js';
 import { useProjectCans } from '../../../internal/lib/use-project-can.js';
 import { REVIEW_CONTROL_ACTIONS, changeRequestControlsFrom } from '@kortix/sdk';
-import { ArrowCounterClockwiseIcon, CheckIcon, FileDashedIcon, SparkleIcon, WarningIcon, } from '@phosphor-icons/react';
+import { ArrowCounterClockwiseIcon, CheckIcon, FileDashedIcon, SparkleIcon, WarningIcon, XIcon, } from '@phosphor-icons/react';
 import { formatDistanceToNowStrict } from 'date-fns';
 import { useMemo, useState } from 'react';
 import { useProjectContext } from '../context.js';
+import { uiRoutes } from '../../../lib/routes.js';
+import { useUiRouter } from '../../../providers/ui-provider.js';
 import { ChangeRequestStatusBadge } from './change-request-status-badge.js';
 import { useChangeRequestRecovery } from '../hooks/use-change-request-recovery.js';
 import { useChangeRequest, useChangeRequestDiff, useChangeRequestMergePreview, useCloseChangeRequest, useMergeChangeRequest, useReopenChangeRequest, } from '../hooks/use-change-requests.js';
@@ -44,6 +47,7 @@ export const diffRendererViewportClass = diffViewportClass;
 const relative = (iso) => formatDistanceToNowStrict(new Date(iso), { addSuffix: true });
 export function ChangeRequestDetailDialog({ crId, onClose, onOpenChangeRequest }) {
     const tI18nComplete = useTranslations('hardcodedUi.i18nComplete');
+    const router = useUiRouter();
     const open = crId !== null;
     const detailQuery = useChangeRequest(crId);
     const diffQuery = useChangeRequestDiff(crId);
@@ -125,6 +129,7 @@ export function ChangeRequestDetailDialog({ crId, onClose, onOpenChangeRequest }
             number: cr.number,
             title: cr.title,
             headRef: cr.head_ref,
+            originSessionId: cr.origin_session_id,
             baseRef: cr.base_ref,
         }, recoveryBlocker, onClose);
     };
@@ -147,7 +152,12 @@ export function ChangeRequestDetailDialog({ crId, onClose, onOpenChangeRequest }
     const blocked = recoveryBlocker !== null;
     // An open change offers Dismiss and the apply; a closed one offers Reopen.
     const hasDecision = cr?.status === 'open' ? controls.canClose || controls.canMerge : controls.canClose;
-    return (_jsx(Modal, { open: open, onOpenChange: (v) => !v && onClose(), children: _jsxs(ModalContent, { className: "flex h-[94dvh] max-h-[94dvh] min-h-0 w-full flex-col gap-0 space-y-0 overflow-hidden p-0 lg:h-[90vh] lg:max-h-[90vh] lg:min-h-[90vh] lg:max-w-5xl", children: [_jsx(ModalHeader, { className: "flex shrink-0 flex-col space-y-0 border-b px-5 py-4 pr-14", children: !cr ? (_jsxs("div", { className: "space-y-2", children: [_jsx(ModalTitle, { className: "sr-only", children: tI18nComplete.raw('text28b00af7cb71') }), _jsx(Skeleton, { className: "h-5 w-2/3" }), _jsx(Skeleton, { className: "h-3 w-1/3" })] })) : (_jsxs(_Fragment, { children: [_jsxs("div", { className: "flex min-w-0 items-start gap-2.5", children: [_jsx(ModalTitle, { className: "text-foreground min-w-0 flex-1 text-base leading-snug font-medium text-balance", children: cr.title || tI18nComplete.raw('text63cb7c2ea609') }), _jsx(ChangeRequestStatusBadge, { cr: cr, onOpenChangeRequest: onOpenChangeRequest })] }), _jsxs("p", { className: "text-muted-foreground mt-1 flex min-w-0 flex-wrap items-center gap-x-1.5 text-xs", children: [_jsxs("span", { className: "tabular-nums", children: ["#", cr.number] }), _jsx("span", { className: "text-muted-foreground", "aria-hidden": true, children: tI18nComplete.raw('text3b9453dad42b') }), _jsx("span", { children: proposedChangeTimeline(cr, relative, tI18nComplete) }), cr.base_ref !== defaultBranch && (_jsxs(_Fragment, { children: [_jsx("span", { className: "text-muted-foreground", "aria-hidden": true, children: tI18nComplete.raw('text3b9453dad42b') }), _jsxs("span", { className: "truncate", children: [tI18nComplete.raw('text6b847a0ed0b2'), " ", cr.base_ref] })] }))] })] })) }), _jsx("div", { className: "min-h-0 flex-1 overflow-y-auto overscroll-contain", children: _jsxs("div", { className: "space-y-4 px-5 py-4", children: [manifestIssues !== null && (_jsx(InfoBanner, { tone: "destructive", icon: WarningIcon, title: tI18nComplete('text8e5d6f03865c', { value0: manifestFile }), children: manifestIssues.length > 0 ? (_jsx("ul", { className: "mt-1 space-y-1", children: dedupeIssues(manifestIssues).map(({ key, issue }) => (_jsxs("li", { children: [_jsx("code", { className: "text-foreground font-mono text-xs break-all", children: issue.path }), ' ', issue.message, issue.line
+    return (_jsx(Modal, { open: open, onOpenChange: (v) => !v && onClose(), children: _jsxs(ModalContent, { className: "flex h-[94dvh] max-h-[94dvh] min-h-0 w-full flex-col gap-0 space-y-0 overflow-hidden p-0 lg:h-[90vh] lg:max-h-[90vh] lg:min-h-[90vh] lg:max-w-5xl", showCloseButton: false, 
+            // The session that proposed this change is where its reasoning lives.
+            closeButtonChildren: _jsxs(ButtonGroup, { children: [cr?.origin_session_id && projectId ? (_jsx(Button, { variant: "secondary", size: "sm", onClick: () => {
+                            router.push(uiRoutes().session(projectId, cr.origin_session_id));
+                            onClose();
+                        }, children: tI18nComplete.raw('textb205bb47f81a') })) : null, _jsx(ModalClose, { asChild: true, children: _jsx(Button, { variant: "secondary", size: "icon-base", "aria-label": tI18nComplete.raw('text7d9eb7acb13e'), children: _jsx(XIcon, { className: "size-4" }) }) })] }), children: [_jsx(ModalHeader, { className: "flex shrink-0 flex-col space-y-0 border-b px-5 py-4 pr-48", children: !cr ? (_jsxs("div", { className: "space-y-2", children: [_jsx(ModalTitle, { className: "sr-only", children: tI18nComplete.raw('text28b00af7cb71') }), _jsx(Skeleton, { className: "h-5 w-2/3" }), _jsx(Skeleton, { className: "h-3 w-1/3" })] })) : (_jsxs(_Fragment, { children: [_jsxs("div", { className: "flex min-w-0 items-start gap-2.5", children: [_jsx(ModalTitle, { className: "text-foreground min-w-0 flex-1 text-base leading-snug font-medium text-balance", children: cr.title || tI18nComplete.raw('text63cb7c2ea609') }), _jsx(ChangeRequestStatusBadge, { cr: cr, onOpenChangeRequest: onOpenChangeRequest })] }), _jsxs("p", { className: "text-muted-foreground mt-1 flex min-w-0 flex-wrap items-center gap-x-1.5 text-xs", children: [_jsxs("span", { className: "tabular-nums", children: ["#", cr.number] }), _jsx("span", { className: "text-muted-foreground", "aria-hidden": true, children: tI18nComplete.raw('text3b9453dad42b') }), _jsx("span", { children: proposedChangeTimeline(cr, relative, tI18nComplete) }), cr.base_ref !== defaultBranch && (_jsxs(_Fragment, { children: [_jsx("span", { className: "text-muted-foreground", "aria-hidden": true, children: tI18nComplete.raw('text3b9453dad42b') }), _jsxs("span", { className: "truncate", children: [tI18nComplete.raw('text6b847a0ed0b2'), " ", cr.base_ref] })] }))] })] })) }), _jsx("div", { className: "min-h-0 flex-1 overflow-y-auto overscroll-contain", children: _jsxs("div", { className: "space-y-4 px-5 py-4", children: [manifestIssues !== null && (_jsx(InfoBanner, { tone: "destructive", icon: WarningIcon, title: tI18nComplete('text8e5d6f03865c', { value0: manifestFile }), children: manifestIssues.length > 0 ? (_jsx("ul", { className: "mt-1 space-y-1", children: dedupeIssues(manifestIssues).map(({ key, issue }) => (_jsxs("li", { children: [_jsx("code", { className: "text-foreground font-mono text-xs break-all", children: issue.path }), ' ', issue.message, issue.line
                                                 ? tI18nComplete('texta6b97728ff89', { value0: issue.line })
                                                 : ''] }, key))) })) : (_jsx("span", { children: tI18nComplete.raw('textcc85fb556a48') })) })), manifestIssues === null && conflictPaths !== null && conflictPaths.length > 0 && (_jsx(InfoBanner, { tone: "warning", icon: WarningIcon, title: tI18nComplete('text57bbed2817ff', {
                                     value0: fileCount(conflictPaths.length),

package/dist/files/project/components/drive-explorer.js

@@ -10,7 +10,7 @@ import { errorToast, successToast } from '../../../primitives/toast.js';
 import { DRAG_MIME } from '../../tree/components/file-tree-item.js';
 import { useFilesStore, useFilesStoreApi } from '../../../internal/stores/files-store.js';
 import { EmptyState } from '../../../primitives/empty-state.js';
-import { DriveEmptyArt } from './drive-empty-art.js';
+import { EmptyArt } from '../../../primitives/empty-art.js';
 import { ErrorState } from '../../../primitives/error-state.js';
 import { isSandboxNotReadyError } from '@kortix/sdk';
 import { ClipboardIcon as Clipboard, FolderPlusIcon as FolderPlus, ClipboardTextIcon, MoonIcon, XIcon, UploadSimpleIcon, UploadIcon as Upload, ArrowsLeftRightIcon, CheckSquareIcon, TrashIcon, } from '@phosphor-icons/react';
@@ -25,7 +25,7 @@ import { DriveCreateDialog, } from './drive-create-dialog.js';
 import { DriveGridView } from './drive-grid-view.js';
 import { DriveListView } from './drive-list-view.js';
 import { useDriveUploads } from '../store/upload-store.js';
-import { DRIVE_ACTION_ROW_CLASS, DriveNewMenu, DriveNewMenuItems, DrivePathBar, DriveViewMenu, } from './drive-toolbar.js';
+import { DriveActionRow, DriveNewMenu, DriveNewMenuItems, DrivePathBar, DriveViewMenu, } from './drive-toolbar.js';
 import { createSelectionStore, DRIVE_ITEM_ATTR, DriveSelectionContext, } from './drive-selection.js';
 import { DriveSelectionBar } from './drive-selection-bar.js';
 import { DriveRenameContext, DriveRenameDialog } from './drive-rename-dialog.js';
@@ -987,18 +987,18 @@ export function DriveExplorer({ embedded = false, shareContext, leading, trailin
         elevatedDirs.length === 0 &&
         dirs.length === 0 &&
         fileItems.length === 0;
-    return (_jsx(DriveSelectionContext.Provider, { value: selectionValue, children: _jsx(DriveRenameContext.Provider, { value: canWrite ? requestRename : null, children: _jsxs("div", { className: "bg-background relative flex h-full flex-col", onDragEnter: handlePageDragEnter, onDragLeave: handlePageDragLeave, onDragOver: handlePageDragOver, onDrop: handlePageDrop, children: [_jsxs("div", { className: DRIVE_ACTION_ROW_CLASS, children: [leading, (() => {
-                                const newMenu = (_jsx(DriveNewMenu, { compact: embedded, onUpload: canWrite && filesAllowedHere ? handleUpload : undefined, onUploadFolder: canWrite ? handlePickFolder : undefined, onNewFile: canWrite && filesAllowedHere && capabilities.newFile !== false ? () => setCreateKind('file') : undefined, onNewFolder: canWrite ? () => setCreateKind('folder') : undefined }));
-                                const viewMenu = (_jsx(DriveViewMenu, { variant: "secondary", showSearch: capabilities.search, showHiddenToggle: capabilities.hiddenToggle, onRefresh: () => refetchFiles(), isRefreshing: isFetching, onDownloadDir: () => {
-                                        const dirName = isRootPath
-                                            ? 'workspace'
-                                            : currentPath.split('/').filter(Boolean).pop() || 'directory';
-                                        const dirPath = isRootPath ? '/workspace' : currentPath;
-                                        downloadDir(dirPath, dirName);
-                                    }, isDownloading: isDirDownloading(isRootPath ? '/workspace' : currentPath), sortDisabled: partial }));
-                                // One secondary group whether or not the host adds actions.
-                                return (_jsxs(ButtonGroup, { className: "ml-auto shrink-0", children: [newMenu, viewMenu, trailing] }));
-                            })()] }), _jsx(DrivePathBar, { as: "row", rootLabel: rootLabel, rootIcon: rootIcon, base: pathBase }), capabilities.search && isSearchOpen && _jsx(FileSearch, {}), _jsx("input", { type: "file", ref: fileInputRef, className: "hidden", onChange: handleFileInputChange, multiple: true }), _jsx("input", { type: "file", ref: folderPickerRef, className: "hidden", multiple: true, webkitdirectory: '', onChange: (e) => {
+    return (_jsx(DriveSelectionContext.Provider, { value: selectionValue, children: _jsx(DriveRenameContext.Provider, { value: canWrite ? requestRename : null, children: _jsxs("div", { className: "bg-background relative flex h-full flex-col", onDragEnter: handlePageDragEnter, onDragLeave: handlePageDragLeave, onDragOver: handlePageDragOver, onDrop: handlePageDrop, children: [_jsx(DriveActionRow, { leading: leading, actions: (() => {
+                            const newMenu = (_jsx(DriveNewMenu, { compact: embedded, onUpload: canWrite && filesAllowedHere ? handleUpload : undefined, onUploadFolder: canWrite ? handlePickFolder : undefined, onNewFile: canWrite && filesAllowedHere && capabilities.newFile !== false ? () => setCreateKind('file') : undefined, onNewFolder: canWrite ? () => setCreateKind('folder') : undefined }));
+                            const viewMenu = (_jsx(DriveViewMenu, { variant: "secondary", showSearch: capabilities.search, showHiddenToggle: capabilities.hiddenToggle, onRefresh: () => refetchFiles(), isRefreshing: isFetching, onDownloadDir: () => {
+                                    const dirName = isRootPath
+                                        ? 'workspace'
+                                        : currentPath.split('/').filter(Boolean).pop() || 'directory';
+                                    const dirPath = isRootPath ? '/workspace' : currentPath;
+                                    downloadDir(dirPath, dirName);
+                                }, isDownloading: isDirDownloading(isRootPath ? '/workspace' : currentPath), sortDisabled: partial }));
+                            // One secondary group whether or not the host adds actions.
+                            return (_jsxs(_Fragment, { children: [newMenu, viewMenu, trailing] }));
+                        })() }), _jsx(DrivePathBar, { as: "row", rootLabel: rootLabel, rootIcon: rootIcon, base: pathBase }), capabilities.search && isSearchOpen && _jsx(FileSearch, {}), _jsx("input", { type: "file", ref: fileInputRef, className: "hidden", onChange: handleFileInputChange, multiple: true }), _jsx("input", { type: "file", ref: folderPickerRef, className: "hidden", multiple: true, webkitdirectory: '', onChange: (e) => {
                             const picked = e.target.files;
                             if (picked?.length)
                                 void handleUploadFolder(picked);
@@ -1011,7 +1011,7 @@ export function DriveExplorer({ embedded = false, shareContext, leading, trailin
                                                     !isLoading &&
                                                     (sandboxWaking ? (_jsxs("div", { className: "flex flex-col items-center justify-center gap-3 py-16 text-center", children: [_jsx(Loading, { className: "text-muted-foreground size-4" }), _jsx("p", { className: "text-muted-foreground text-sm font-medium", children: tHardcodedUi.raw('i18nComplete.text5e3de76869f3') }), _jsx("p", { className: "text-muted-foreground max-w-xs text-xs", children: tHardcodedUi.raw('i18nComplete.textc1b1dc22e207') })] })) : (_jsx(ErrorState, { title: tHardcodedUi.raw('featuresProjectFilesComponentsFileExplorerPage.line658JsxTextFailedToLoadFiles'), description: error instanceof Error
                                                             ? error.message
-                                                            : tHardcodedUi.raw('i18nComplete.text27c2ccd962c2'), action: _jsx(Button, { variant: "outline", size: "sm", onClick: () => refetchFiles(), children: tHardcodedUi.raw('i18nComplete.text942087cc2d41') }) }))), isEmpty && parked && (_jsx(EmptyState, { icon: MoonIcon, title: tHardcodedUi.raw('i18nComplete.text3915f5ca49b3') })), isEmpty && !parked && (_jsx(EmptyState, { className: "min-h-full", media: _jsx(DriveEmptyArt, {}), title: tHardcodedUi.raw('featuresProjectFilesComponentsDriveListView.line396JsxTextThisFolderIsEmpty'), description: canWrite
+                                                            : tHardcodedUi.raw('i18nComplete.text27c2ccd962c2'), action: _jsx(Button, { variant: "outline", size: "sm", onClick: () => refetchFiles(), children: tHardcodedUi.raw('i18nComplete.text942087cc2d41') }) }))), isEmpty && parked && (_jsx(EmptyState, { icon: MoonIcon, title: tHardcodedUi.raw('i18nComplete.text3915f5ca49b3') })), isEmpty && !parked && (_jsx(EmptyState, { className: "min-h-full", media: _jsx(EmptyArt, {}), title: tHardcodedUi.raw('featuresProjectFilesComponentsDriveListView.line396JsxTextThisFolderIsEmpty'), description: canWrite
                                                         ? tHardcodedUi.raw('i18nComplete.text9720774edbde')
                                                         : tHardcodedUi.raw('featuresProjectFilesComponentsDriveListView.line398JsxTextNoFilesOrSubfoldersAtThisPathIn'), 
                                                     // An empty folder with no way to add a file is the worst case of

package/dist/files/project/components/drive-toolbar.d.ts

@@ -21,6 +21,15 @@ import { type ComponentType, type ReactNode } from 'react';
  * every other project surface.
  */
 export declare const DRIVE_ACTION_ROW_CLASS = "border-border/60 flex h-11 shrink-0 items-center gap-1 border-b px-4";
+/**
+ * The action row itself: the host's `leading` chrome, then the actions as one
+ * secondary button group at the trailing edge. The live explorer and the
+ * session panel's booting Files card both draw it, so the two cannot drift.
+ */
+export declare function DriveActionRow({ leading, actions }: {
+    leading?: ReactNode;
+    actions?: ReactNode;
+}): import("react").JSX.Element;
 interface DrivePathBarProps {
     /**
      * Word for the root crumb. The standalone page passes its own page title
@@ -75,6 +84,8 @@ export interface DriveViewMenuProps {
     sortDisabled?: boolean;
     /** `secondary` when the trigger sits in a button group with New. */
     variant?: 'ghost' | 'secondary';
+    /** Show the trigger, inert (a session explorer whose computer is booting). */
+    disabled?: boolean;
 }
 /**
  * Every rare Drive control behind one `⋯`: view mode, sort, dotfiles, search,
@@ -82,7 +93,7 @@ export interface DriveViewMenuProps {
  * they were most of the crowding on both surfaces, and none of them is reached
  * more than once a session.
  */
-export declare function DriveViewMenu({ onDownloadDir, onRefresh, isRefreshing, isDownloading, showSearch, showHiddenToggle, sortDisabled, variant, }: DriveViewMenuProps): import("react").JSX.Element;
+export declare function DriveViewMenu({ onDownloadDir, onRefresh, isRefreshing, isDownloading, showSearch, showHiddenToggle, sortDisabled, variant, disabled, }: DriveViewMenuProps): import("react").JSX.Element;
 interface DriveNewMenuProps {
     /**
      * Write affordances. Each renders only when passed; read-only sources
@@ -97,6 +108,9 @@ interface DriveNewMenuProps {
     onNewFolder?: () => void;
     /** Drop the label and render a `+` square. For narrow panels. */
     compact?: boolean;
+    /** Show the trigger, inert, with no write handler yet (a session explorer
+     *  whose computer is booting). */
+    disabled?: boolean;
 }
 /** The "New" menu renders when the explorer supplied any write handler. */
 export declare function hasWriteActions(props: Pick<DriveNewMenuProps, 'onUpload' | 'onNewFile' | 'onNewFolder'>): boolean;
@@ -117,5 +131,5 @@ export declare function DriveNewMenuItems({ Item, Separator: MenuSeparator, onUp
     onNewFile?: () => void;
     onNewFolder?: () => void;
 }): import("react").JSX.Element;
-export declare function DriveNewMenu({ onUpload, onUploadFolder, onNewFile, onNewFolder, compact, }: DriveNewMenuProps): import("react").JSX.Element | null;
+export declare function DriveNewMenu({ onUpload, onUploadFolder, onNewFile, onNewFolder, compact, disabled, }: DriveNewMenuProps): import("react").JSX.Element | null;
 export {};

package/dist/files/project/components/drive-toolbar.js

@@ -1,6 +1,7 @@
 'use client';
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { Button } from '../../../primitives/button.js';
+import { ButtonGroup } from '../../../primitives/button-group.js';
 import { DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuItem, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, } from '../../../primitives/dropdown-menu.js';
 import { FadedScrollArea } from '../../../primitives/faded-scroll-area.js';
 import Hint from '../../../primitives/hint.js';
@@ -33,6 +34,14 @@ import { Download } from '../../../internal/icons/download.js';
  * every other project surface.
  */
 export const DRIVE_ACTION_ROW_CLASS = 'border-border/60 flex h-11 shrink-0 items-center gap-1 border-b px-4';
+/**
+ * The action row itself: the host's `leading` chrome, then the actions as one
+ * secondary button group at the trailing edge. The live explorer and the
+ * session panel's booting Files card both draw it, so the two cannot drift.
+ */
+export function DriveActionRow({ leading, actions }) {
+    return (_jsxs("div", { className: DRIVE_ACTION_ROW_CLASS, children: [leading, actions ? _jsx(ButtonGroup, { className: "ml-auto shrink-0", children: actions }) : null] }));
+}
 /**
  * Breadcrumbs for the current directory, and nothing else.
  *
@@ -144,7 +153,7 @@ const SORT_LABEL = {
  * they were most of the crowding on both surfaces, and none of them is reached
  * more than once a session.
  */
-export function DriveViewMenu({ onDownloadDir, onRefresh, isRefreshing, isDownloading, showSearch = false, showHiddenToggle = false, sortDisabled = false, variant = 'ghost', }) {
+export function DriveViewMenu({ onDownloadDir, onRefresh, isRefreshing, isDownloading, showSearch = false, showHiddenToggle = false, sortDisabled = false, variant = 'ghost', disabled, }) {
     const tI18nComplete = useTranslations('hardcodedUi.i18nComplete');
     const viewMode = useFilesStore((s) => s.viewMode);
     const setViewMode = useFilesStore((s) => s.setViewMode);
@@ -155,7 +164,7 @@ export function DriveViewMenu({ onDownloadDir, onRefresh, isRefreshing, isDownlo
     const showHidden = useFilesStore((s) => s.showHidden);
     const toggleHidden = useFilesStore((s) => s.toggleHidden);
     const toggleSearch = useFilesStore((s) => s.toggleSearch);
-    return (_jsxs(DropdownMenu, { children: [_jsx(Hint, { label: tI18nComplete.raw('text1d55ff7c387c'), side: "bottom", children: _jsx(DropdownMenuTrigger, { asChild: true, children: _jsx(Button, { variant: variant, 
+    return (_jsxs(DropdownMenu, { children: [_jsx(Hint, { label: tI18nComplete.raw('text1d55ff7c387c'), side: "bottom", children: _jsx(DropdownMenuTrigger, { asChild: true, disabled: disabled, children: _jsx(Button, { variant: variant, 
                         // In the button group it matches New and Share: 32px, not 28px.
                         size: variant === 'secondary' ? 'icon-base' : 'icon-sm', "aria-label": tI18nComplete.raw('text1d55ff7c387c'), className: cn('active:scale-[0.96]', variant === 'ghost' && 'text-muted-foreground hover:text-foreground'), children: _jsx(DotsThree, { weight: "bold", className: "size-4" }) }) }) }), _jsxs(DropdownMenuContent, { align: "end", className: "w-56", children: [_jsxs(DropdownMenuSub, { children: [_jsxs(DropdownMenuSubTrigger, { children: [_jsx("span", { className: "min-w-0 flex-1", children: tI18nComplete.raw('textdcc839a4015c') }), _jsx("span", { className: "text-muted-foreground", children: VIEW_LABEL[viewMode] })] }), _jsx(DropdownMenuSubContent, { className: "w-40", children: _jsxs(DropdownMenuRadioGroup, { value: viewMode, onValueChange: (v) => setViewMode(v), children: [_jsxs(DropdownMenuRadioItem, { value: "list", children: [_jsx(ListSolid, {}), tI18nComplete.raw('text6f202f54a7b2')] }), _jsxs(DropdownMenuRadioItem, { value: "grid", children: [_jsx(LayoutGrid, {}), tI18nComplete.raw('text0d7d12ac624c')] })] }) })] }), _jsxs(DropdownMenuSub, { children: [_jsxs(DropdownMenuSubTrigger, { disabled: sortDisabled, children: [_jsx("span", { className: "min-w-0 flex-1", children: tI18nComplete.raw('textc9129025bd3f') }), _jsx("span", { className: "text-muted-foreground", children: SORT_LABEL[sortBy] })] }), _jsxs(DropdownMenuSubContent, { className: "w-44", children: [_jsxs(DropdownMenuRadioGroup, { value: sortBy, onValueChange: (v) => setSortBy(v), children: [_jsx(DropdownMenuRadioItem, { value: "name", children: tI18nComplete.raw('textdcd1d5223f73') }), _jsx(DropdownMenuRadioItem, { value: "type", children: tI18nComplete.raw('textbaaddf70fb5d') })] }), _jsx(DropdownMenuSeparator, {}), _jsxs(DropdownMenuRadioGroup, { value: sortOrder, onValueChange: (v) => setSortOrder(v), children: [_jsx(DropdownMenuRadioItem, { value: "asc", children: tI18nComplete.raw('text77184595bde3') }), _jsx(DropdownMenuRadioItem, { value: "desc", children: tI18nComplete.raw('text79479a6c76d8') })] })] })] }), _jsx(DropdownMenuSeparator, {}), showHiddenToggle && (
                     // `reverse` puts the check on the RIGHT edge, where the radio rows
@@ -177,9 +186,9 @@ export function DriveNewMenuItems({ Item, Separator: MenuSeparator, onUpload, on
     const tDrives = useTranslations('drives');
     return (_jsxs(_Fragment, { children: [onUpload ? (_jsxs(Item, { onClick: onUpload, children: [_jsx(UploadSimpleIcon, { className: "size-3.5 shrink-0" }), tI18nComplete.raw('text4118deee6e13')] })) : null, onUploadFolder ? (_jsxs(Item, { onClick: onUploadFolder, children: [_jsx(FolderOpenIcon, { className: "size-3.5 shrink-0" }), tDrives('uploadFolder')] })) : null, (onUpload || onUploadFolder) && (onNewFile || onNewFolder) ? _jsx(MenuSeparator, {}) : null, onNewFile ? (_jsxs(Item, { onClick: onNewFile, children: [_jsx(FilePlusIcon, { className: "size-3.5 shrink-0" }), tI18nComplete.raw('text44dedd0f97fe')] })) : null, onNewFolder ? (_jsxs(Item, { onClick: onNewFolder, children: [_jsx(FolderPlusIcon, { className: "size-3.5 shrink-0" }), tI18nComplete.raw('textcf28f49ec597')] })) : null] }));
 }
-export function DriveNewMenu({ onUpload, onUploadFolder, onNewFile, onNewFolder, compact, }) {
+export function DriveNewMenu({ onUpload, onUploadFolder, onNewFile, onNewFolder, compact, disabled, }) {
     const tI18nComplete = useTranslations('hardcodedUi.i18nComplete');
-    if (!hasWriteActions({ onUpload, onNewFile, onNewFolder }))
+    if (!disabled && !hasWriteActions({ onUpload, onNewFile, onNewFolder }))
         return null;
-    return (_jsxs(DropdownMenu, { children: [_jsx(DropdownMenuTrigger, { asChild: true, children: compact ? (_jsx(Button, { variant: "secondary", size: "icon-base", "aria-label": tI18nComplete.raw('text18fdd549b2ed'), className: "active:scale-[0.96]", children: _jsx(PlusIcon, { className: "size-4" }) })) : (_jsxs(Button, { variant: "secondary", size: "sm", className: "gap-1.5 active:scale-[0.96]", children: [_jsx(PlusIcon, { className: "size-3.5 shrink-0" }), tI18nComplete.raw('text18fdd549b2ed')] })) }), _jsx(DropdownMenuContent, { align: "end", className: "w-48", children: _jsx(DriveNewMenuItems, { Item: DropdownMenuItem, Separator: DropdownMenuSeparator, onUpload: onUpload, onUploadFolder: onUploadFolder, onNewFile: onNewFile, onNewFolder: onNewFolder }) })] }));
+    return (_jsxs(DropdownMenu, { children: [_jsx(DropdownMenuTrigger, { asChild: true, disabled: disabled, children: compact ? (_jsx(Button, { variant: "secondary", size: "icon-base", "aria-label": tI18nComplete.raw('text18fdd549b2ed'), className: "active:scale-[0.96]", children: _jsx(PlusIcon, { className: "size-4" }) })) : (_jsxs(Button, { variant: "secondary", size: "sm", className: "gap-1.5 active:scale-[0.96]", children: [_jsx(PlusIcon, { className: "size-3.5 shrink-0" }), tI18nComplete.raw('text18fdd549b2ed')] })) }), _jsx(DropdownMenuContent, { align: "end", className: "w-48", children: _jsx(DriveNewMenuItems, { Item: DropdownMenuItem, Separator: DropdownMenuSeparator, onUpload: onUpload, onUploadFolder: onUploadFolder, onNewFile: onNewFile, onNewFolder: onNewFolder }) })] }));
 }

package/dist/files/project/hooks/use-change-request-recovery.js

@@ -2,14 +2,12 @@
 import { uiRoutes } from '../../../lib/routes.js';
 import { errorToast } from '../../../primitives/toast.js';
 import { useProjectContext } from '../context.js';
-import { createProjectSession, markSessionFresh } from '@kortix/sdk';
+import { recoverChangeRequest } from '@kortix/sdk';
 import { prefetchSessionStart, qk } from '@kortix/sdk/react';
 import { useQueryClient } from '@tanstack/react-query';
 import { useTranslations } from '../../../i18n/index.js';
 import { useUiRouter } from '../../../providers/ui-provider.js';
 import { useCallback, useState } from 'react';
-import { buildChangeRequestRecoveryPrompt, recoverySessionName, } from '../change-request-recovery.js';
-import { randomUUID } from '../../../internal/lib/utils/random-uuid.js';
 export function useChangeRequestRecovery() {
     const tI18nComplete = useTranslations('hardcodedUi.i18nComplete');
     const projectId = useProjectContext()?.projectId ?? '';
@@ -20,23 +18,9 @@ export function useChangeRequestRecovery() {
         if (!projectId || startingCrId)
             return;
         setStartingCrId(target.crId);
-        const sessionId = randomUUID();
-        const href = uiRoutes().session(projectId, sessionId);
-        markSessionFresh(sessionId);
-        router.prefetch(href);
         try {
-            await createProjectSession(projectId, {
-                session_id: sessionId,
-                initial_prompt: buildChangeRequestRecoveryPrompt(target, blocker),
-                base_ref: target.headRef,
-                name: recoverySessionName(target, blocker),
-                metadata: {
-                    kind: 'change-request-recovery',
-                    change_request_id: target.crId,
-                    change_request_number: target.number,
-                    blocker: blocker.kind,
-                },
-            });
+            const sessionId = await recoverChangeRequest(projectId, target, blocker);
+            const href = uiRoutes().session(projectId, sessionId);
             prefetchSessionStart(queryClient, projectId, sessionId);
             queryClient.invalidateQueries({ queryKey: qk.project.sessionsScope(projectId) });
             onNavigate?.();

package/dist/files/project/hooks/use-change-requests.d.ts

@@ -98,6 +98,7 @@ export declare function useChangeRequestPages(status?: ChangeRequestStatus | 'al
  */
 export declare function useSessionChangeRequests(sessionId: string | undefined, options?: {
     refetchInterval?: number;
+    enabled?: boolean;
 }): import("@tanstack/react-query").UseQueryResult<{
     change_requests: ChangeRequest[];
 }, Error>;

package/dist/files/project/hooks/use-change-requests.js

@@ -149,8 +149,17 @@ export function useSessionChangeRequests(sessionId, options) {
     const projectId = ctx?.projectId ?? '';
     return useQuery({
         queryKey: changeRequestKeys.sessionList(projectId, sessionId ?? ''),
-        queryFn: () => fetchChangeRequests(projectId, 'all', { originSessionId: sessionId }),
-        enabled: Boolean(projectId) && Boolean(sessionId),
+        queryFn: async () => {
+            const change_requests = [];
+            let cursor;
+            do {
+                const page = await fetchChangeRequests(projectId, 'all', { originSessionId: sessionId, cursor });
+                change_requests.push(...page.change_requests);
+                cursor = page.next_cursor ?? undefined;
+            } while (cursor);
+            return { change_requests };
+        },
+        enabled: Boolean(projectId) && Boolean(sessionId) && options?.enabled !== false,
         staleTime: 5_000,
         refetchInterval: options?.refetchInterval,
     });

package/dist/files/renderers/image-frame.d.ts

@@ -0,0 +1,46 @@
+import { type ReactNode } from 'react';
+export interface ImageFrameProps {
+    /** CSS `aspect-ratio` before the image loads (`"3 / 2"`); the image's natural size replaces it on load. */
+    aspectRatio: string;
+    src: string | null;
+    alt: string;
+    /** The image does not exist yet, or its bytes are on the way. */
+    pending: boolean;
+    /** Centered over the frame: the busy line, or a note. */
+    label?: ReactNode;
+    /** Makes the image a button (open it in the file viewer). */
+    onOpen?: () => void;
+    className?: string;
+    /**
+     * Fill the parent's box (a tile of a layout) and crop the image to it
+     * (`object-cover`), in place of holding `aspectRatio` and fitting the image.
+     */
+    fill?: boolean;
+    /**
+     * The tallest the frame may be (`'60vh'`): it narrows to keep its ratio,
+     * so it never crops more and never letterboxes. Unset: the full width.
+     */
+    maxHeight?: string;
+    /** The image button's accessible name; `alt` when unset. */
+    openLabel?: string;
+    /** The image's natural ratio when another surface already measured it (`"<w> / <h>"`), so a remount starts at it. */
+    naturalRatio?: string | null;
+    /** Reports the image's natural size once it decoded. */
+    onNaturalSize?: (width: number, height: number) => void;
+}
+/**
+ * The box an image takes before, while and after it exists: a flat `bg-muted`
+ * surface that holds the requested aspect ratio before any pixel arrives, so
+ * the layout does not jump when the image lands, then fades the image in.
+ * The frame itself never moves: the busy signal is the label (one waiting
+ * channel, kortix-brand `layout.md` States).
+ */
+export declare function ImageFrame({ aspectRatio, src, alt, pending, label, onOpen, className, fill, maxHeight, openLabel, naturalRatio, onNaturalSize, }: ImageFrameProps): import("react").JSX.Element;
+/**
+ * An image whose file could not be read: "Image unavailable" and Try again,
+ * centered in the frame. Never the read's own error text (R38): that is
+ * internal (a status line, a path, a stack), not something a reader can act on.
+ */
+export declare function ImageUnavailable({ onRetry }: {
+    onRetry: () => void;
+}): import("react").JSX.Element;

package/dist/files/renderers/image-frame.js

@@ -0,0 +1,59 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useTranslations } from '../../i18n/index.js';
+import { Button } from '../../primitives/button.js';
+import { cn } from '../../lib/utils.js';
+import { useEffect, useRef, useState } from 'react';
+/** `'3 / 2'` → `1.5`; anything unreadable → `1`. */
+function ratioValue(ratio) {
+    const [w, h] = ratio.split('/').map((part) => Number(part.trim()));
+    return w && h ? w / h : 1;
+}
+/**
+ * The box an image takes before, while and after it exists: a flat `bg-muted`
+ * surface that holds the requested aspect ratio before any pixel arrives, so
+ * the layout does not jump when the image lands, then fades the image in.
+ * The frame itself never moves: the busy signal is the label (one waiting
+ * channel, kortix-brand `layout.md` States).
+ */
+export function ImageFrame({ aspectRatio, src, alt, pending, label, onOpen, className, fill = false, maxHeight, openLabel, naturalRatio = null, onNaturalSize, }) {
+    const img = useRef(null);
+    const [loaded, setLoaded] = useState(false);
+    const [natural, setNatural] = useState(naturalRatio);
+    // A new source starts hidden at the requested ratio again; a cached one may
+    // be complete before React sees `load`.
+    useEffect(() => {
+        const el = img.current;
+        const complete = !!el?.complete && el.naturalWidth > 0;
+        setLoaded(complete);
+        setNatural(complete && el ? `${el.naturalWidth} / ${el.naturalHeight}` : naturalRatio);
+        // The ratio is the cached one until this source decodes; a new source is measured on load.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [src]);
+    const onLoad = () => {
+        const el = img.current;
+        if (el?.naturalWidth && el.naturalHeight) {
+            setNatural(`${el.naturalWidth} / ${el.naturalHeight}`);
+            onNaturalSize?.(el.naturalWidth, el.naturalHeight);
+        }
+        setLoaded(true);
+    };
+    const image = src ? (
+    // eslint-disable-next-line @next/next/no-img-element -- a blob: URL of a sandbox file; the Next loader cannot fetch it
+    _jsx("img", { ref: img, src: src, alt: alt, onLoad: onLoad, className: cn('size-full transition-[opacity,filter] duration-moderate ease-out motion-reduce:blur-none', fill ? 'object-cover' : 'object-contain', loaded ? 'opacity-100 blur-none' : 'opacity-0 blur-xs') })) : null;
+    return (_jsxs("div", { "aria-busy": pending, className: cn('bg-muted relative w-full overflow-hidden rounded-md', fill && 'h-full', className), style: fill
+            ? undefined
+            : {
+                aspectRatio: natural ?? aspectRatio,
+                ...(maxHeight && { width: `min(100%, calc(${maxHeight} * ${ratioValue(natural ?? aspectRatio)}))` }),
+            }, children: [image && onOpen ? (_jsx("button", { type: "button", onClick: onOpen, "aria-label": openLabel ?? alt, className: "focus-visible:ring-kortix-base block size-full cursor-zoom-in rounded-md focus-visible:ring-2 focus-visible:outline-none focus-visible:ring-inset", children: image })) : (image), label ? (_jsx("div", { className: "absolute inset-0 flex items-center justify-center p-4 text-center", children: label })) : null] }));
+}
+/**
+ * An image whose file could not be read: "Image unavailable" and Try again,
+ * centered in the frame. Never the read's own error text (R38): that is
+ * internal (a status line, a path, a stack), not something a reader can act on.
+ */
+export function ImageUnavailable({ onRetry }) {
+    const t = useTranslations('imageGen');
+    return (_jsxs("span", { className: "text-muted-foreground flex flex-col items-center gap-2 text-xs", children: [t('unavailable'), _jsx(Button, { type: "button", variant: "secondary", size: "sm", className: "active:scale-[0.96]", onClick: onRetry, children: t('tryAgain') })] }));
+}

package/dist/files/renderers/image-renderer.d.ts

@@ -24,6 +24,16 @@ interface ImageRendererProps {
     /** Add the backdrop swatches to the shelf (see `ImageBackdrop`). Off by
      *  default — an opaque JPEG has exactly one meaningful background. */
     backdrop?: boolean;
+    /**
+     * The image's details toggle (ⓘ), last on the shelf: shown only when the
+     * host has details for this image (a generated image's prompt and model).
+     * It is a `DisclosureTrigger`: the host renders this renderer inside the
+     * `Disclosure` whose content holds the details.
+     */
+    info?: {
+        pressed: boolean;
+        label: string;
+    };
 }
-export declare function ImageRenderer({ url, className, fileName, controls, backdrop: showBackdrop, }: ImageRendererProps): React.JSX.Element;
+export declare function ImageRenderer({ url, className, fileName, controls, backdrop: showBackdrop, info, }: ImageRendererProps): React.JSX.Element;
 export {};

package/dist/files/renderers/image-renderer.js

@@ -6,10 +6,20 @@ import { Button } from '../../primitives/button.js';
 import { ButtonGroup, ButtonGroupSeparator } from '../../primitives/button-group.js';
 import Hint from '../../primitives/hint.js';
 import Loading from '../../primitives/loading.js';
+import { IconInfo } from '../../primitives/kortix-icons.js';
+import { DisclosureTrigger } from '../../primitives/disclosure.js';
 import { usePreviewFit } from '../viewer/preview-fit.js';
 import { cn } from '../../lib/utils.js';
 import { ImageBrokenIcon as ImageOff, ArrowClockwiseIcon as RotateCw, MagnifyingGlassPlusIcon as ZoomIn, MagnifyingGlassMinusIcon as ZoomOut, } from '@phosphor-icons/react';
 import { useCallback, useEffect, useRef, useState } from 'react';
+/**
+ * The details toggle: a `DisclosureTrigger` (toggle, Enter/Space,
+ * `aria-expanded`) around the shelf's button. Props and ref pass through, so
+ * the tooltip trigger around it still works.
+ */
+function InfoTrigger({ pressed, label, ...props }) {
+    return (_jsx(DisclosureTrigger, { children: _jsx(Button, { ...props, variant: "secondary", size: "icon-base", "aria-label": label, "aria-pressed": pressed, "data-image-info": "", children: _jsx(IconInfo, { className: "size-4", weight: pressed ? 'fill' : 'regular' }) }) }));
+}
 const MAX_RETRIES = 3;
 const RETRY_DELAYS = [500, 1500, 3000]; // ms — escalating backoff
 const MIN_ZOOM = 0.25;
@@ -43,7 +53,7 @@ const BACKDROPS = [
     { value: 'white', label: 'White' },
     { value: 'black', label: 'Black' },
 ];
-export function ImageRenderer({ url, className, fileName, controls = 'hover', backdrop: showBackdrop = false, }) {
+export function ImageRenderer({ url, className, fileName, controls = 'hover', backdrop: showBackdrop = false, info, }) {
     const tHardcodedUi = useTranslations('hardcodedUi');
     const backdrops = useLocalizedUiCatalog(BACKDROPS);
     // `null` outside a <PreviewFitProvider> (Advanced-mode viewer, /projects
@@ -230,8 +240,8 @@ export function ImageRenderer({ url, className, fileName, controls = 'hover', ba
                     : [
                         'top-1 opacity-0 transition-opacity duration-200 ease-out',
                         'group-hover:opacity-100 focus-within:opacity-100',
-                        showInfo && 'opacity-100',
-                    ]), children: _jsxs(ButtonGroup, { children: [_jsx(Hint, { label: zoomOutLabel, side: "bottom", children: _jsx(Button, { variant: "secondary", size: "icon-base", onClick: handleZoomOut, disabled: zoom <= MIN_ZOOM, "aria-label": zoomOutLabel, children: _jsx(ZoomOut, { className: "size-4" }) }) }), _jsx(Hint, { label: tHardcodedUi.raw('i18nComplete.textce89ae822e8b'), side: "bottom", children: _jsxs(Button, { variant: "secondary", size: "sm", className: "min-w-14 tabular-nums", onClick: handleResetZoom, "aria-label": tHardcodedUi.raw('i18nComplete.textce89ae822e8b'), children: [Math.round(zoom * 100), "%"] }) }), _jsx(Hint, { label: zoomInLabel, side: "bottom", children: _jsx(Button, { variant: "secondary", size: "icon-base", onClick: handleZoomIn, disabled: zoom >= MAX_ZOOM, "aria-label": zoomInLabel, children: _jsx(ZoomIn, { className: "size-4" }) }) }), _jsx(Hint, { label: tHardcodedUi.raw('i18nComplete.textc3613b1704f5'), side: "bottom", children: _jsx(Button, { variant: "secondary", size: "icon-base", onClick: handleRotate, "aria-label": tHardcodedUi.raw('i18nComplete.text9dc6b57eecba'), children: _jsx(RotateCw, { className: "size-4" }) }) }), showBackdrop && (_jsxs(_Fragment, { children: [_jsx(ButtonGroupSeparator, {}), backdrops.map(({ value, label }) => (_jsx(Hint, { label: `${label} background`, side: "bottom", children: _jsx(Button, { variant: "secondary", size: "icon-base", onClick: () => setBackdrop(value), "aria-label": `${label} background`, "aria-pressed": backdrop === value, children: _jsx("span", { className: cn(
+                        (showInfo || info?.pressed) && 'opacity-100',
+                    ]), children: _jsxs(ButtonGroup, { children: [_jsx(Hint, { label: zoomOutLabel, side: "bottom", children: _jsx(Button, { variant: "secondary", size: "icon-base", onClick: handleZoomOut, disabled: zoom <= MIN_ZOOM, "aria-label": zoomOutLabel, children: _jsx(ZoomOut, { className: "size-4" }) }) }), _jsx(Hint, { label: tHardcodedUi.raw('i18nComplete.textce89ae822e8b'), side: "bottom", children: _jsxs(Button, { variant: "secondary", size: "sm", className: "min-w-14 tabular-nums", onClick: handleResetZoom, "aria-label": tHardcodedUi.raw('i18nComplete.textce89ae822e8b'), children: [Math.round(zoom * 100), "%"] }) }), _jsx(Hint, { label: zoomInLabel, side: "bottom", children: _jsx(Button, { variant: "secondary", size: "icon-base", onClick: handleZoomIn, disabled: zoom >= MAX_ZOOM, "aria-label": zoomInLabel, children: _jsx(ZoomIn, { className: "size-4" }) }) }), _jsx(Hint, { label: tHardcodedUi.raw('i18nComplete.textc3613b1704f5'), side: "bottom", children: _jsx(Button, { variant: "secondary", size: "icon-base", onClick: handleRotate, "aria-label": tHardcodedUi.raw('i18nComplete.text9dc6b57eecba'), children: _jsx(RotateCw, { className: "size-4" }) }) }), info ? (_jsx(Hint, { label: info.label, side: "bottom", children: _jsx(InfoTrigger, { pressed: info.pressed, label: info.label }) })) : null, showBackdrop && (_jsxs(_Fragment, { children: [_jsx(ButtonGroupSeparator, {}), backdrops.map(({ value, label }) => (_jsx(Hint, { label: `${label} background`, side: "bottom", children: _jsx(Button, { variant: "secondary", size: "icon-base", onClick: () => setBackdrop(value), "aria-label": `${label} background`, "aria-pressed": backdrop === value, children: _jsx("span", { className: cn(
                                             // A hairline on every swatch, not just the white one:
                                             // without it the white chip vanishes on a light
                                             // toolbar and the black one on a dark toolbar.

package/dist/files/renderers/pdf/pdf-clipboard.d.ts

@@ -0,0 +1,2 @@
+/** The upstream React utility leaves denied clipboard writes unhandled. */
+export declare function PdfClipboard(): null;

package/dist/files/renderers/pdf/pdf-clipboard.js

@@ -0,0 +1,21 @@
+import { useSelectionCapability } from '@embedpdf/plugin-selection/react';
+import { useEffect } from 'react';
+import { errorToast } from '../../../primitives/toast.js';
+import { useTranslations } from '../../../i18n/index.js';
+import { copyToClipboard } from '../../../internal/lib/utils/clipboard.js';
+/** The upstream React utility leaves denied clipboard writes unhandled. */
+export function PdfClipboard() {
+    const { provides: selection } = useSelectionCapability();
+    const t = useTranslations('commandPalette');
+    useEffect(() => {
+        if (!selection)
+            return;
+        return selection.onCopyToClipboard(({ text }) => {
+            void copyToClipboard(text).then((copied) => {
+                if (!copied)
+                    errorToast(t('copyFailed'));
+            });
+        });
+    }, [selection, t]);
+    return null;
+}

package/dist/files/renderers/pdf/pdf-viewer.js

@@ -9,7 +9,8 @@ import { RenderLayer, RenderPluginPackage } from '@embedpdf/plugin-render/react'
 import { Rotate, RotatePluginPackage } from '@embedpdf/plugin-rotate/react';
 import { ScrollPluginPackage, ScrollStrategy, useScroll, useScrollPlugin, } from '@embedpdf/plugin-scroll/react';
 import { SearchLayer, SearchPluginPackage, useSearch } from '@embedpdf/plugin-search/react';
-import { CopyToClipboard, SelectionPluginPackage, useSelectionCapability, useSelectionPlugin, } from '@embedpdf/plugin-selection/react';
+import { SelectionPluginPackage } from '@embedpdf/plugin-selection';
+import { useSelectionCapability, useSelectionPlugin, } from '@embedpdf/plugin-selection/react';
 import { ThumbImg, ThumbnailPluginPackage, useThumbnailCapability, useThumbnailPlugin, } from '@embedpdf/plugin-thumbnail/react';
 import { TilingLayer, TilingPluginPackage } from '@embedpdf/plugin-tiling/react';
 import { useIsViewportGated, useViewportCapability, useViewportElement, useViewportRef, ViewportElementContext, ViewportPluginPackage, } from '@embedpdf/plugin-viewport/react';
@@ -36,6 +37,7 @@ import { cn } from '../../../lib/utils.js';
 import { downloadBlob } from '../../../internal/lib/utils/download.js';
 import { loadSharedPdfEngine } from './pdf-engine-loader.js';
 import { SidebarGlyph as PanelLeft } from '../../../icons/sidebar-toggle.js';
+import { PdfClipboard } from './pdf-clipboard.js';
 const DEFAULT_ZOOM = 1;
 const ZOOM_OPTIONS = [0.1, 0.25, 0.5, 0.75, 1, 1.25, 1.5, 2];
 const PAGE_GAP = 24;
@@ -1218,7 +1220,7 @@ function PDFViewerInner({ viewerRef, pdfFile, documentId, document: pdfDocument,
                                                 }, children: _jsx(CircleMinus, { className: "size-4" }) }) }), _jsxs(Select, { value: String(currentZoomLevel), onValueChange: (value) => zoom?.requestZoom(Number(value)), disabled: controlsDisabled, modal: false, children: [_jsx(SelectTrigger, { size: "sm", className: "w-[84px] min-w-[84px] tabular-nums", children: _jsxs(SelectValue, { placeholder: tI18nComplete.raw('text509c517ede79'), children: [Math.round(currentZoomLevel * 100), "%"] }) }), _jsx(SelectContent, { alignItemWithTrigger: false, children: ZOOM_OPTIONS.map((option) => (_jsxs(SelectItem, { value: String(option), children: [Math.round(option * 100), "%"] }, option))) })] }), _jsx(ToolbarTooltip, { label: tI18nComplete.raw('text0e47f09a748f'), children: _jsx(Button, { type: "button", variant: "ghost", size: "icon-sm", className: "transition-transform active:scale-[0.96]", "aria-label": tI18nComplete.raw('text0e47f09a748f'), disabled: controlsDisabled || currentZoomLevel >= ZOOM_OPTIONS[ZOOM_OPTIONS.length - 1], onClick: () => {
                                                     const nextZoom = ZOOM_OPTIONS.find((option) => option > currentZoomLevel);
                                                     zoom?.requestZoom(nextZoom ?? ZOOM_OPTIONS[ZOOM_OPTIONS.length - 1]);
-                                                }, children: _jsx(CirclePlus, { className: "size-4" }) }) })] }), _jsx(Separator, { orientation: "vertical", className: "mx-1 h-4 self-center" }), _jsx(PDFViewerSearchControl, { documentId: documentId, controlsDisabled: controlsDisabled, initialSearch: findText }, documentId), toolbarActions ? (_jsxs(_Fragment, { children: [_jsx(Separator, { orientation: "vertical", className: "mx-1 h-4 self-center" }), toolbarActions] })) : null, showDownload || showUpload ? (_jsxs(_Fragment, { children: [_jsx(Separator, { orientation: "vertical", className: "mx-1 h-4 self-center" }), _jsx(PDFViewerFileActionsMenu, { onUploadFile: handleUpload, showUpload: showUpload }), showDownload ? (_jsx(ViewerDownloadButton, { disabled: controlsDisabled, pending: isPreparingDownload, onDownload: () => void handleDownload() })) : null] })) : null] }) })] })) : null, _jsxs("div", { ref: viewerShellRef, className: "bg-muted/30 relative flex min-h-0 flex-1 overflow-hidden", children: [isLoading ? (_jsx(PDFViewerLoadingSkeleton, { sidebarInline: sidebarInline, sidebarOpen: sidebarOpen })) : null, _jsxs("div", { className: "flex h-full max-h-full min-h-0 w-full flex-1 overflow-hidden", children: [_jsx(DocumentViewerThumbnailSidebar, { closedInlineClassName: THUMBNAIL_SIDEBAR_CLOSED_CLASS, inline: sidebarInline, open: thumbnailSidebarVisible, widthClassName: THUMBNAIL_SIDEBAR_WIDTH_CLASS, children: thumbnailSidebarVisible ? (_jsx(PDFViewerThumbnails, { basePageRotations: basePageRotations, documentId: documentId, activePage: activePage, pageCount: numPages, pageRotationDeltas: pageRotationDeltas, pdfDocument: pdfDocument, selectedPageIndexes: selectedPageIndexes, onSelectPage: selectThumbnailPage })) : null }), _jsxs(PDFViewerScrollAreaViewport, { documentId: documentId, className: "relative h-full max-h-full min-h-0 min-w-0 flex-1", children: [_jsx(PDFViewerViewportBridge, { viewportElementRef: viewportElementRef }), _jsx(PDFViewerSelectionCopyShortcut, { documentId: documentId }), _jsx(PDFViewerSelectionReleaseGuard, { documentId: documentId }), _jsx(GlobalPointerProvider, { documentId: documentId, children: _jsx(PDFViewerScroller, { basePageRotations: basePageRotations, documentId: documentId, pageRotationDeltas: pageRotationDeltas, renderPage: renderPage }) }), _jsx(CopyToClipboard, {})] })] })] })] }));
+                                                }, children: _jsx(CirclePlus, { className: "size-4" }) }) })] }), _jsx(Separator, { orientation: "vertical", className: "mx-1 h-4 self-center" }), _jsx(PDFViewerSearchControl, { documentId: documentId, controlsDisabled: controlsDisabled, initialSearch: findText }, documentId), toolbarActions ? (_jsxs(_Fragment, { children: [_jsx(Separator, { orientation: "vertical", className: "mx-1 h-4 self-center" }), toolbarActions] })) : null, showDownload || showUpload ? (_jsxs(_Fragment, { children: [_jsx(Separator, { orientation: "vertical", className: "mx-1 h-4 self-center" }), _jsx(PDFViewerFileActionsMenu, { onUploadFile: handleUpload, showUpload: showUpload }), showDownload ? (_jsx(ViewerDownloadButton, { disabled: controlsDisabled, pending: isPreparingDownload, onDownload: () => void handleDownload() })) : null] })) : null] }) })] })) : null, _jsxs("div", { ref: viewerShellRef, className: "bg-muted/30 relative flex min-h-0 flex-1 overflow-hidden", children: [isLoading ? (_jsx(PDFViewerLoadingSkeleton, { sidebarInline: sidebarInline, sidebarOpen: sidebarOpen })) : null, _jsxs("div", { className: "flex h-full max-h-full min-h-0 w-full flex-1 overflow-hidden", children: [_jsx(DocumentViewerThumbnailSidebar, { closedInlineClassName: THUMBNAIL_SIDEBAR_CLOSED_CLASS, inline: sidebarInline, open: thumbnailSidebarVisible, widthClassName: THUMBNAIL_SIDEBAR_WIDTH_CLASS, children: thumbnailSidebarVisible ? (_jsx(PDFViewerThumbnails, { basePageRotations: basePageRotations, documentId: documentId, activePage: activePage, pageCount: numPages, pageRotationDeltas: pageRotationDeltas, pdfDocument: pdfDocument, selectedPageIndexes: selectedPageIndexes, onSelectPage: selectThumbnailPage })) : null }), _jsxs(PDFViewerScrollAreaViewport, { documentId: documentId, className: "relative h-full max-h-full min-h-0 min-w-0 flex-1", children: [_jsx(PDFViewerViewportBridge, { viewportElementRef: viewportElementRef }), _jsx(PDFViewerSelectionCopyShortcut, { documentId: documentId }), _jsx(PDFViewerSelectionReleaseGuard, { documentId: documentId }), _jsx(GlobalPointerProvider, { documentId: documentId, children: _jsx(PDFViewerScroller, { basePageRotations: basePageRotations, documentId: documentId, pageRotationDeltas: pageRotationDeltas, renderPage: renderPage }) }), _jsx(PdfClipboard, {})] })] })] })] }));
 }
 function PDFViewerDocumentLoader({ pdfFile, onDocumentLoadSuccess, ...innerProps }) {
     const { provides: documentManager } = useDocumentManagerCapability();

package/dist/files/renderers/show-content-renderer.d.ts

@@ -44,6 +44,12 @@ export interface ShowContentProps {
      * blob would run agent-authored script inside the app.
      */
     attachment?: string;
+    /**
+     * The sha256 of the file's bytes, from the `show` output (R38): an image
+     * already loaded under another path (the generated original of a Drive
+     * copy) draws at once from the shared image store.
+     */
+    sha256?: string;
     /** Optional: render a proxied localhost iframe. Caller provides this component. */
     LocalhostPreview?: React.ComponentType<{
         url: string;
@@ -74,7 +80,7 @@ export interface ShowContentProps {
      */
     toolbarActions?: React.ReactNode;
 }
-export declare function ShowContentRenderer({ type, title, description, path, url, content, language, aspectRatio, attachment, LocalhostPreview, fill, onStatusChange, toolbarActions, }: ShowContentProps): string | number | bigint | boolean | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | React.JSX.Element | null | undefined;
+export declare function ShowContentRenderer({ type, title, description, path, url, content, language, aspectRatio, attachment, sha256, LocalhostPreview, fill, onStatusChange, toolbarActions, }: ShowContentProps): string | number | bigint | boolean | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | React.JSX.Element | null | undefined;
 export interface ShowCarouselItem {
     type: string;
     title?: string;
@@ -86,6 +92,8 @@ export interface ShowCarouselItem {
     aspect_ratio?: string;
     /** Stored copy of `path` from saved history — see `ShowContentProps.attachment`. */
     attachment?: string;
+    /** The bytes' sha256 from the `show` output — see `ShowContentProps.sha256`. */
+    sha256?: string;
     /** `pending`: a grouped `show` call whose payload has not arrived yet. The
      *  slot holds its place so the card does not jump when it lands. */
     status?: 'pending' | 'ready' | 'error';