@arbidocs/blocks 0.4.153 → 0.4.155

package/dist/files/index.d.ts

@@ -31,8 +31,13 @@ export * from './tags';
 export * from './views';
 export { AiReviewDialogView, DEFAULT_AI_REVIEW_DIALOG_LABELS, type AiReviewDialogViewProps, type AiReviewDialogLabels, type AiReviewAskView, type AiReviewResultsView, type AiReviewResultRow, type AiReviewResultCell, type AiReviewFieldOption, type AiReviewTarget, } from './AiReviewDialog';
 export { DocStatusIcon, type DocStatusIconProps } from './DocStatusIcon';
+export { FailedStageIcon, type FailedStage } from './FailedStageIcon';
 export { FieldValue, FieldFolderSelect, FieldFolderValue, FieldLabelsSelect, FieldNativeSelect, FieldAttribution, FieldWithAttribution, type FieldValueProps, type FieldFolderSelectProps, type FieldLabelsSelectProps, type FieldNativeSelectProps, type FieldAttributionProps, } from './FieldParts';
 export { ExplorerFrame, ExplorerStage, ExplorerScroller, ExplorerEmpty, ExplorerMarquee, ExplorerDropOverlay, ExplorerDragPreview, type ExplorerEmptyProps, type ExplorerDragPreviewProps, } from './ExplorerSurface';
 export { FilterButton } from './grid/FilterButton';
 export { RowDensityControl } from './grid/RowDensityControl';
 export { LINE_PX, CHROME, MIN_LINES, MAX_LINES, ROW_MIN, rowHeightForLines, linesForRowHeight, } from './grid/row-density';
+export * from './folders';
+export { canChangeVisibility, canEditDocumentFields, canDeleteDocument, type WorkspaceMemberRole, type OwnedDocument, } from './permissions';
+export { shareStateOf, shareTooltipFor, confirmHideFromMembers, visibilityAudience, visibilityToggleTooltip, type SharedItem, type WorkspaceMember, } from './visibility';
+export { RECENTLY_DELETED_HINT, RECENTLY_DELETED_HINT_PLURAL } from './recently-deleted';

package/dist/files/index.js

@@ -1,6 +1,6 @@
 "use client";
-export { AiReviewDialogView, BulkActionsBar, BulkLabelSelectView, BulkReplaceDialog, BulkTagEditorDialog, CheckboxCell, CitedRunNav, DEFAULT_AI_REVIEW_DIALOG_LABELS, DEFAULT_BULK_ACTIONS_LABELS, DEFAULT_BULK_REPLACE_LABELS, DEFAULT_BULK_TAG_EDITOR_LABELS, DEFAULT_DOC_TAG_LABELS, DEFAULT_EXPLORER_LABELS, DEFAULT_EXPORT_LABELS, DEFAULT_FIELDS_EDITOR_LABELS, DEFAULT_FILES_SEARCH_LABELS, DEFAULT_HTML_VIEWER_LABELS, DEFAULT_IMPORT_LABELS, DEFAULT_MOVE_TO_FOLDER_LABELS, DEFAULT_TAG_MANAGER_LABELS, DEFAULT_TAG_PASSAGE_PANEL_LABELS, DEFAULT_TRANSFER_LABELS, DEFAULT_UPLOAD_FOOTER_LABELS, DEFAULT_UPLOAD_PARTS_LABELS, DEFAULT_UPLOAD_SOURCES_LABELS, DEFAULT_URL_INPUT_DIALOG_LABELS, DEFAULT_VIEWER_LABELS, DEFAULT_VIEW_SELECTOR_LABELS, DocStatusIcon, DocTagBar, DocTagBreadcrumb, DocTagCreateLink, DocTagEmpty, DocTagFieldIcon, DocTagFieldRow, DocTagNavigator, DocTagPopover, DocTagToggle, DocTagUnsavedFooter, DocTagValueInput, DocumentGrid, DocumentLabelBar, DocumentNameCellFrame, DocumentRowMenu, ExplorerDragPreview, ExplorerDropOverlay, ExplorerEmpty, ExplorerFileTile, ExplorerFileTooltip, ExplorerFolderTile, ExplorerFrame, ExplorerLoadingTiles, ExplorerMarquee, ExplorerScroller, ExplorerStage, ExportFooter, ExportMethodChooser, ExportModalTitle, ExportResultsReport, ExportWorkspacePicker, FieldRow, FieldsApplyBar, FieldsEditorList, FieldsEditorRoot, FieldsEditorToolbar, FieldsEmptyState, FieldsManagerBody, FieldsManagerDefinition, FieldsManagerTitle, FilesAddMenu, FilesPage, FilesPageHeader, FilesPageMain, FilesPageTitle, FilesSearchInput, FilesToolbar, FolderSummary, HtmlPage, HtmlPassage, HtmlViewerEmpty, HtmlViewerRoot, HtmlViewerSurface, ImportActionButton, ImportAside, ImportFamilySection, ImportHint, ImportList, ImportPanel, ImportProgress, ImportRow, ImportRunActions, ImportSummary, MediaPreviewView, MoveToFolderDialog, PassageStepper, PdfPageNav, RejectedFilesList, RelatedDocsCell, SELECTION_COL_ID, SelectedFilesList, StatusPill, TagColumnHeader, TagFormField, TagFormFooter, TagFormInstructionField, TagFormMeta, TagFormNameField, TagFormNote, TagFormOptionsEditor, TagFormRoot, TagFormSelectField, TagFormSharedToggle, TagManager, TagPassagePanel, TaskSection, TransferConflictChooser, TransferKindsPicker, TransferPlanSummary, TransferProgressView, TransferReferencesChooser, TransferResumeBanner, TransferScopeChooser, UploadBrowseButtons, UploadContainer, UploadDropArea, UploadErrorMessage, UploadFooterBar, UploadFrame, UploadProgress, UploadShareNote, UploadSourcePicker, UploadSourceSection, UploadUrlButton, UrlDialogTitle, UrlInputDialogView, VendorLogo, ViewSelectorMenu, ViewerControlBar, ViewerFrame, ViewerImageActions, ViewerLoadError, ViewerMessage, ViewerPageCounter, ViewerPreviewUnavailable, ViewerTabBar, ViewerTitle, ViewerZoomControl, applyColumnLayout, applyViewColumns, captureColumnWidths, columnItems, columnsMatch, documentGridLayoutProps, fieldsApplyBarCopy, fieldsEmptyText, filterFieldsByName, isDocumentLabel, pinnedLeftColumns, resolveDocumentGridLayout, sortFields, summariseDocTags, toggleColumn, upsertView, useGridViews, visibleColumns, widthsMatch } from '../chunk-HUJF2XM2.js';
-export { CHROME, DEFAULT_FOLDER_FILTER_LABELS, DEFAULT_FOLDER_PICKER_LABELS, FieldAttribution, FieldFolderSelect, FieldFolderValue, FieldLabelsSelect, FieldNativeSelect, FieldValue, FieldWithAttribution, FilesFilterBar, FilesModalFooter, FilesTagsButton, FilesViewCenter, FilterButton, FolderBreadcrumb, FolderCell, FolderCommandList, FolderFilterButton, FolderPickerRow, FolderTree, LINE_PX, MAX_LINES, MIN_LINES, ROW_MIN, RowDensityControl, linesForRowHeight, rowHeightForLines } from '../chunk-JGOST4IL.js';
+export { AiReviewDialogView, BulkActionsBar, BulkLabelSelectView, BulkReplaceDialog, BulkTagEditorDialog, CheckboxCell, CitedRunNav, DEFAULT_AI_REVIEW_DIALOG_LABELS, DEFAULT_BULK_ACTIONS_LABELS, DEFAULT_BULK_REPLACE_LABELS, DEFAULT_BULK_TAG_EDITOR_LABELS, DEFAULT_DOC_TAG_LABELS, DEFAULT_EXPORT_LABELS, DEFAULT_FIELDS_EDITOR_LABELS, DEFAULT_FILES_SEARCH_LABELS, DEFAULT_HTML_VIEWER_LABELS, DEFAULT_IMPORT_LABELS, DEFAULT_MOVE_TO_FOLDER_LABELS, DEFAULT_TAG_MANAGER_LABELS, DEFAULT_TAG_PASSAGE_PANEL_LABELS, DEFAULT_TRANSFER_LABELS, DEFAULT_UPLOAD_FOOTER_LABELS, DEFAULT_UPLOAD_PARTS_LABELS, DEFAULT_UPLOAD_SOURCES_LABELS, DEFAULT_URL_INPUT_DIALOG_LABELS, DEFAULT_VIEWER_LABELS, DEFAULT_VIEW_SELECTOR_LABELS, DocStatusIcon, DocTagBar, DocTagBreadcrumb, DocTagCreateLink, DocTagEmpty, DocTagFieldIcon, DocTagFieldRow, DocTagNavigator, DocTagPopover, DocTagToggle, DocTagUnsavedFooter, DocTagValueInput, DocumentGrid, DocumentLabelBar, DocumentNameCellFrame, DocumentRowMenu, ExportFooter, ExportMethodChooser, ExportModalTitle, ExportResultsReport, ExportWorkspacePicker, FieldRow, FieldsApplyBar, FieldsEditorList, FieldsEditorRoot, FieldsEditorToolbar, FieldsEmptyState, FieldsManagerBody, FieldsManagerDefinition, FieldsManagerTitle, FilesAddMenu, FilesPage, FilesPageHeader, FilesPageMain, FilesPageTitle, FilesSearchInput, FilesToolbar, FolderSummary, HtmlPage, HtmlPassage, HtmlViewerEmpty, HtmlViewerRoot, HtmlViewerSurface, ImportActionButton, ImportAside, ImportFamilySection, ImportHint, ImportList, ImportPanel, ImportProgress, ImportRow, ImportRunActions, ImportSummary, MediaPreviewView, MoveToFolderDialog, PassageStepper, PdfPageNav, RejectedFilesList, RelatedDocsCell, SELECTION_COL_ID, SelectedFilesList, TagColumnHeader, TagFormField, TagFormFooter, TagFormInstructionField, TagFormMeta, TagFormNameField, TagFormNote, TagFormOptionsEditor, TagFormRoot, TagFormSelectField, TagFormSharedToggle, TagManager, TagPassagePanel, TaskSection, TransferConflictChooser, TransferKindsPicker, TransferPlanSummary, TransferProgressView, TransferReferencesChooser, TransferResumeBanner, TransferScopeChooser, UploadBrowseButtons, UploadContainer, UploadDropArea, UploadErrorMessage, UploadFooterBar, UploadFrame, UploadProgress, UploadShareNote, UploadSourcePicker, UploadSourceSection, UploadUrlButton, UrlDialogTitle, UrlInputDialogView, ViewSelectorMenu, ViewerControlBar, ViewerFrame, ViewerImageActions, ViewerLoadError, ViewerMessage, ViewerPageCounter, ViewerPreviewUnavailable, ViewerTabBar, ViewerTitle, ViewerZoomControl, applyColumnLayout, applyViewColumns, captureColumnWidths, columnItems, columnsMatch, documentGridLayoutProps, fieldsApplyBarCopy, fieldsEmptyText, filterFieldsByName, isDocumentLabel, pinnedLeftColumns, resolveDocumentGridLayout, sortFields, summariseDocTags, toggleColumn, upsertView, useGridViews, visibleColumns, widthsMatch } from '../chunk-W7CWGURO.js';
+export { CHROME, DEFAULT_EXPLORER_LABELS, DEFAULT_FOLDER_FILTER_LABELS, DEFAULT_FOLDER_PICKER_LABELS, ExplorerDragPreview, ExplorerDropOverlay, ExplorerEmpty, ExplorerFileTile, ExplorerFileTooltip, ExplorerFolderTile, ExplorerFrame, ExplorerLoadingTiles, ExplorerMarquee, ExplorerScroller, ExplorerStage, FailedStageIcon, FieldAttribution, FieldFolderSelect, FieldFolderValue, FieldLabelsSelect, FieldNativeSelect, FieldValue, FieldWithAttribution, FilesFilterBar, FilesModalFooter, FilesTagsButton, FilesViewCenter, FilterButton, FolderBreadcrumb, FolderCell, FolderCommandList, FolderFilterButton, FolderPickerRow, FolderProviderIcon, FolderTree, LINE_PX, MAX_LINES, MIN_LINES, RECENTLY_DELETED_HINT, RECENTLY_DELETED_HINT_PLURAL, ROW_MIN, RowDensityControl, StatusPill, VendorLogo, buildExplorerEntries, canChangeVisibility, canDeleteDocument, canEditDocumentFields, collectFolderDocs, confirmHideFromMembers, formatFolderSegment, getExplorerDisplayName, hasFolderProviderIcon, isExplorerDocument, joinFolderPath, linesForRowHeight, parseFolderSegments, rowHeightForLines, searchExplorerDocuments, shareStateOf, shareTooltipFor, sortExplorerFiles, visibilityAudience, visibilityToggleTooltip } from '../chunk-6HMCF4AJ.js';
 import '../chunk-RC6VTY2H.js';
 export { ViewerHeaderEnd, ViewerHeaderStart, ViewerPane, ViewerRenderedPane, ViewerStatusNote } from '../chunk-6HKLTYNN.js';
 export { DEFAULT_DOCUMENT_VIEW_TOGGLE_LABELS, DocumentViewToggle, ViewToggle } from '../chunk-JJA6GQKH.js';
@@ -8,7 +8,7 @@ import '../chunk-K4BGOPGG.js';
 export { DEFAULT_LABEL_MULTI_SELECT_LABELS, LabelMultiSelectView, LabelPickerList, labelChipClampHeight } from '../chunk-SDOEHEJP.js';
 export { CellHoverIcon, HoverIconCell, UploadDropzone } from '../chunk-M4S75AEJ.js';
 import '../chunk-5LXQPP2K.js';
-import '../chunk-YKQ2DPIP.js';
+import '../chunk-VF5EUAIV.js';
 export { DEFAULT_SELECTION_BAR_LABELS, SelectionBar, SelectionBarAction } from '../chunk-NUNKSZKU.js';
 import '../chunk-YU2KUMGE.js';
 export { GridView } from '../chunk-N5YEF3LC.js';
@@ -16,7 +16,7 @@ import '../chunk-AUS3KBHJ.js';
 import '../chunk-SLSBJRWW.js';
 import '../chunk-NPLYHR2E.js';
 import '../chunk-7F6CBP3Z.js';
-import '../chunk-TBEVGWY3.js';
+import '../chunk-F57LNUSZ.js';
 import '../chunk-TX2ZICS7.js';
 import '../chunk-OXF2IFXG.js';
 import '../chunk-VUNV25KB.js';

package/dist/files/permissions.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Who may do what to a document, by the workspace role: edit its fields, delete it, change who can
+ * see it. The table, the explorer, the bulk actions and the detail pane all ask here, so they agree
+ * with each other and with what the server allows.
+ */
+/** A member's role in a workspace. */
+export type WorkspaceMemberRole = 'owner' | 'collaborator' | 'guest';
+/** The fields of a document its permissions depend on. */
+export interface OwnedDocument {
+    created_by_ext_id?: string | null;
+}
+/**
+ * Whether the current user may flip a document's visibility. Only its creator (or an agent) may:
+ * the server rejects anyone else with a 403, so the controls must not offer the toggle.
+ */
+export declare function canChangeVisibility(doc: OwnedDocument | null | undefined, currentUserExtId: string | undefined): boolean;
+/**
+ * Whether the current user may edit a document's regular fields (title, author, labels…).
+ * Agents and workspace owners/collaborators may edit any document; guests and non-members
+ * only their own.
+ */
+export declare function canEditDocumentFields(doc: OwnedDocument | null | undefined, currentUserExtId: string | undefined, workspaceRole: WorkspaceMemberRole | null): boolean;
+/**
+ * Whether the current user may delete a document. Workspace owners may delete any document;
+ * collaborators only their own, since they cannot delete shared content created by others.
+ * Guests and non-members may not delete at all.
+ */
+export declare function canDeleteDocument(doc: OwnedDocument | null | undefined, currentUserExtId: string | undefined, workspaceRole: WorkspaceMemberRole | null): boolean;

package/dist/files/recently-deleted.d.ts

@@ -0,0 +1,7 @@
+/**
+ * What deleting a document or a workspace does: it goes to Recently deleted (Settings > Storage, and the
+ * project's Storage), where it can be restored until it is removed for good 30–60 days later. It keeps using
+ * storage until then.
+ */
+export declare const RECENTLY_DELETED_HINT = "You can restore it from Recently deleted (Settings > Storage) for at least 30 days.";
+export declare const RECENTLY_DELETED_HINT_PLURAL = "You can restore them from Recently deleted (Settings > Storage) for at least 30 days.";

package/dist/files/visibility.d.ts

@@ -0,0 +1,31 @@
+/** Who can see documents, in words: the bulk bar, the explorer tiles and the upload dialog. */
+import type { BlocksEnvironment } from '../provider/BlocksProvider';
+import type { ShareState } from '../collaboration/sharing/ShareControl';
+export interface SharedItem {
+    shared?: boolean | null;
+}
+/** A workspace member as returned by the users endpoint. */
+export interface WorkspaceMember {
+    user: {
+        external_id: string;
+        given_name: string;
+        family_name?: string | null;
+    };
+}
+/** Visibility of a selection: every item shared, none shared, or a mix. */
+export declare function shareStateOf(items: SharedItem[]): ShareState;
+/** Tooltip for the share button: what a click does in the given state. */
+export declare function shareTooltipFor(state: ShareState, isSingle: boolean): string;
+/**
+ * Asks before hiding `count` documents from the workspace. A shared document is visible to every
+ * member, so the confirmation names them: that is who loses access. Agents are not people and are
+ * left out. Resolves true only when the user confirms.
+ */
+export declare function confirmHideFromMembers(confirm: BlocksEnvironment['confirm'], count: number, members: WorkspaceMember[]): Promise<boolean>;
+/**
+ * Who can see a single file, in plain words: the wording of the upload dialog's ShareToggle, so a
+ * file reads the same before and after it is uploaded.
+ */
+export declare function visibilityAudience(shared: boolean, workspaceLabel?: string): string;
+/** Tooltip for a single file's share toggle: who can see it now, then what a click does. */
+export declare function visibilityToggleTooltip(shared: boolean): string;