@evergis/react 4.0.149 → 4.0.150

package/dist/components/Dashboard/containers/AttachmentContainer/components/ShowMoreButton.d.ts

@@ -1,6 +1,9 @@
 import { FC } from 'react';
+import { IconTypesKeys } from '@evergis/uilib-gl';
 export interface ShowMoreButtonProps {
     hiddenCount: number;
+    /** Значок после подписи. Поп-ап вложений колонки по макету ставит `expand`. */
+    iconKind?: IconTypesKeys;
     onClick: () => void;
 }
 export declare const ShowMoreButton: FC<ShowMoreButtonProps>;

package/dist/components/Dashboard/containers/AttachmentContainer/styled.d.ts

@@ -4,6 +4,12 @@ export declare const AttachmentsContainer: import('styled-components').StyledCom
 export declare const AttachmentsHeaderRow: import('styled-components').StyledComponent<"div", any, {}, never>;
 export declare const AttachmentsLabel: import('styled-components').StyledComponent<"div", any, {}, never>;
 export declare const AttachmentsViewControls: import('styled-components').StyledComponent<"div", any, {}, never>;
+/**
+ * Счётчик файлов у подписи — плоский чип в строку подписи.
+ *
+ * Шрифт ставится на текст чипа, а не на корень: текст задаёт себе шрифт шорткатом `font` из темы,
+ * и размер с корня до цифры не доходит — чип выходил высоким, во весь шрифт описания.
+ */
 export declare const AttachmentsCountChip: import('styled-components').StyledComponent<import('react').FC<import('@evergis/uilib-gl').IChipProps>, any, {}, never>;
 export declare const AttachmentsContent: import('styled-components').StyledComponent<"div", any, {}, never>;
 export declare const GridListWrapper: import('styled-components').StyledComponent<"div", any, {}, never>;

package/dist/components/Dashboard/containers/AttachmentContainer/useAttachmentContainer.d.ts

@@ -1,19 +1,13 @@
+import { AttachmentsView } from '../../hooks/useAttachmentsView';
 import { ConfigContainerChild, WidgetType } from '../../types';
-import { Attachment, AttachmentViewMode } from './types';
+import { Attachment } from './types';
 export interface UseAttachmentContainerProps {
     type?: WidgetType;
     elementConfig?: ConfigContainerChild;
     valueOverride?: unknown;
 }
-export interface UseAttachmentContainerResult {
+export interface UseAttachmentContainerResult extends AttachmentsView {
     items: Attachment[];
-    visibleItems: Attachment[];
-    hiddenCount: number;
-    hasMore: boolean;
-    showMore: boolean;
-    setShowMore: (value: boolean) => void;
-    viewMode: AttachmentViewMode;
-    setViewMode: (mode: AttachmentViewMode) => void;
     attributeName?: string;
 }
 export declare const useAttachmentContainer: ({ type, elementConfig, valueOverride, }: UseAttachmentContainerProps) => UseAttachmentContainerResult;

package/dist/components/Dashboard/containers/StructuredDataContainer/types.d.ts

@@ -39,6 +39,10 @@ export interface StructuredDataAttribute {
     colorPicker?: boolean;
     /** Стиль значений колонки из конфига. */
     style?: CSSProperties;
+    /** Папка каталога, куда уходит файл, загруженный с диска в колонку вложений. */
+    parentResourceId?: string;
+    /** Что разрешено выбирать в диалоге файлов колонки вложений — значение `accept`. */
+    fileExtensions?: string;
 }
 /**
  * Значение {@link StructuredDataContext} — всё, что нужно представлению (`ElementTable`)

package/dist/components/Dashboard/elements/ElementTable/components/AttachmentsCell.d.ts

@@ -1,9 +1,12 @@
 import { FC } from 'react';
 import { TableCellProps } from '../types';
 /**
- * Колонка со вложениями: список файлов прямо в ячейке.
+ * Колонка со вложениями.
  *
  * Тип у атрибута строковый, вложениями его делает `subType: "Attachments"` в схеме контейнера —
  * поэтому ветка стоит раньше разбора типа и обычных редакторов ячейки.
+ *
+ * Сама ячейка показывает один файл, а несколько схлопывает в строку со значком ссылки
+ * и счётчиком: в ширину колонки список файлов не помещается. Весь список живёт в поп-апе.
  */
 export declare const AttachmentsCell: FC<TableCellProps>;

package/dist/components/Dashboard/elements/ElementTable/components/AttachmentsCellPopup/index.d.ts

@@ -0,0 +1,10 @@
+import { FC } from 'react';
+import { AttachmentsCellPopupProps } from '../../types';
+/**
+ * Полный список вложений колонки — тот же набор, что у контейнера вложений в карточке объекта:
+ * шапка с подписью, счётчиком и переключателем вида, сам список, «Показать ещё» и добавление.
+ *
+ * Кнопка добавления и корзины у файлов появляются только на правку: на чтение поп-ап нужен
+ * ровно затем, чтобы развернуть свёрнутый счётчик.
+ */
+export declare const AttachmentsCellPopup: FC<AttachmentsCellPopupProps>;

package/dist/components/Dashboard/elements/ElementTable/components/AttachmentsCellPopup/styled.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Вложения ячейки в поп-апе. Ширина своя, а не по ячейке: колонка таблицы бывает узкой,
+ * а внутри стоит полный список вложений с плиткой и кнопкой добавления.
+ *
+ * Список взят у контейнера вложений карточки, а величины у поп-апа свои, с макета: имя файла
+ * крупнее и ссылочного цвета, значок в строку имени, «Показать ещё» серое. Переопределены они
+ * здесь, а не в самих компонентах, чтобы вложения в карточке объекта остались как были.
+ */
+export declare const AttachmentsPopupBox: import('styled-components').StyledComponent<"div", any, {}, never>;

package/dist/components/Dashboard/elements/ElementTable/components/AttachmentsCellPopup.d.ts

@@ -0,0 +1,10 @@
+import { FC } from 'react';
+import { AttachmentsCellPopupProps } from '../types';
+/**
+ * Полный список вложений колонки — тот же набор, что у контейнера вложений в карточке объекта:
+ * шапка с подписью, счётчиком и переключателем вида, сам список, «Показать ещё» и добавление.
+ *
+ * Кнопка добавления и корзины у файлов появляются только на правку: на чтение поп-ап нужен
+ * ровно затем, чтобы развернуть свёрнутый счётчик.
+ */
+export declare const AttachmentsCellPopup: FC<AttachmentsCellPopupProps>;

package/dist/components/Dashboard/elements/ElementTable/constants.d.ts

@@ -23,3 +23,15 @@ export declare const MIN_COLUMN_WIDTH = 48;
  * без валидной строки не собрать.
  */
 export declare const DEFAULT_CELL_COLOR = "#000000";
+/**
+ * Сколько вложений ячейка показывает сама. Больше — все схлопываются в одну строку со значком
+ * ссылки и счётчиком: колонка в таблице узкая, и списком там помещается ровно один файл.
+ */
+export declare const ATTACHMENTS_INLINE_LIMIT = 1;
+/**
+ * Сколько файлов видно в поп-апе вложений сразу, остальные прячутся за «Показать ещё N».
+ * Величина с макета и опцией не выносится: поп-ап у колонки один на все таблицы.
+ */
+export declare const ATTACHMENTS_SHOWN_ITEMS = 3;
+/** Вид списка, с которого поп-ап вложений открывается. */
+export declare const ATTACHMENTS_VIEW_MODE: "list";

package/dist/components/Dashboard/elements/ElementTable/hooks/useAttachmentsCell.d.ts

@@ -1,26 +1,11 @@
-import { IPreviewImage } from '@evergis/uilib-gl';
-import { Attachment } from '../../../containers/AttachmentContainer/types';
-import { TableCellProps } from '../types';
+import { AttachmentsCellState, TableCellProps } from '../types';
 /**
- * Ячейка с вложениями: разбор значения, просмотр, скачивание и правка списка.
+ * Колонка вложений: разбор значения, свёрнутый вид ячейки и полный список в поп-апе.
  *
  * Значение атрибута — строка: файлы приезжают в ней списком JSON, поэтому и обратно в черновик
  * кладём строку, а не массив — иначе тип ячейки менялся бы от самой правки.
  *
- * Добавление здесь только по ссылке. Загрузка с диска требует ресурса-родителя и файлового
- * api контейнера вложений, а у колонки таблицы ни того, ни другого нет.
+ * Ячейка показывает один файл, а несколько схлопывает в счётчик, и весь список с добавлением
+ * и удалением живёт в поп-апе — тот же набор, что у контейнера вложений в карточке объекта.
  */
-export declare const useAttachmentsCell: ({ attribute, row, canEdit, onChange }: TableCellProps) => {
-    items: Attachment[];
-    editable: boolean;
-    previewIndex: number;
-    previewImages: IPreviewImage[];
-    isLinkDialogOpen: boolean;
-    onPreview: (link: string) => void;
-    onClosePreview: () => void;
-    onDownload: (_image: IPreviewImage, index: number) => void;
-    onDelete: (link: string) => void;
-    onOpenLinkDialog: () => void;
-    onCloseLinkDialog: () => void;
-    onAddByLink: (url: string) => void;
-};
+export declare const useAttachmentsCell: ({ attribute, row, canEdit, onChange, }: TableCellProps) => AttachmentsCellState;

package/dist/components/Dashboard/elements/ElementTable/hooks/useAttachmentsCellEdit.d.ts

@@ -0,0 +1,28 @@
+import { Attachment } from '../../../containers/AttachmentContainer/types';
+import { StructuredDataAttribute } from '../../../containers/StructuredDataContainer/types';
+export interface UseAttachmentsCellEditParams {
+    attribute: StructuredDataAttribute;
+    items: Attachment[];
+    /** Запись нового списка в черновик строки. */
+    persist: (next: Attachment[]) => void;
+}
+/**
+ * Добавление и удаление файлов в колонке вложений.
+ *
+ * Все три источника — диск, каталог ресурсов и ссылка — те же, что у контейнера вложений
+ * в карточке объекта: файловое api берётся из глобального контекста, диалог каталога выдаёт
+ * виджету приложение, а ссылка разбирается по адресу.
+ *
+ * Папку-приёмник загрузки задаёт сам атрибут: у колонки нет узла-элемента с опциями, зато
+ * колонок вложений в таблице может быть несколько, и складывать их файлы в одно место незачем.
+ */
+export declare const useAttachmentsCellEdit: ({ attribute, items, persist }: UseAttachmentsCellEditParams) => {
+    accept: string;
+    isLinkDialogOpen: boolean;
+    onDelete: (link: string) => void;
+    onUpload: (files: File[]) => Promise<void>;
+    onSelectFromCatalog: () => void;
+    onOpenLinkDialog: () => void;
+    onCloseLinkDialog: () => void;
+    onAddByLink: (url: string) => void;
+};

package/dist/components/Dashboard/elements/ElementTable/styled.d.ts

@@ -104,7 +104,23 @@ export declare const CellField: import('styled-components').StyledComponent<"div
  * Отступы те же, что у текстовой ячейки (`CellText`): в одном ряду с обычными колонками значения
  * обязаны стоять на одной линии.
  */
-export declare const AttachmentsCellBox: import('styled-components').StyledComponent<"div", any, {}, never>;
+export declare const AttachmentsCellBox: import('styled-components').StyledComponent<"div", any, {
+    $interactive?: boolean;
+}, never>;
+/**
+ * Значок файла в ячейке. Тот же, что в списке вложений, только с макетную величину строки
+ * таблицы: в контейнере строка свободнее и значок там крупнее.
+ */
+export declare const AttachmentsCellIcon: import('styled-components').StyledComponent<"div", any, {
+    fileType?: import('../../containers/AttachmentContainer/types').FileType;
+}, never>;
+/**
+ * Подпись файла или счётчика свёрнутых. Ссылочная: по ней и кликают — одиночный файл открывает
+ * галерею, счётчик разворачивает список.
+ */
+export declare const AttachmentsCellLabel: import('styled-components').StyledComponent<"div", any, {}, never>;
+/** Значок ссылки у счётчика свёрнутых файлов — в цвет подписи. */
+export declare const AttachmentsCellLinkIcon: import('styled-components').StyledComponent<"span", any, import('@evergis/uilib-gl').IIconProps, never>;
 /**
  * Ячейка цвета: плашка или палитра слева, значение справа.
  *

package/dist/components/Dashboard/elements/ElementTable/types.d.ts

@@ -1,4 +1,6 @@
+import { IPreviewImage } from '@evergis/uilib-gl';
 import { FeatureAttributeValue } from '../../../../types';
+import { Attachment, AttachmentViewMode } from '../../containers/AttachmentContainer/types';
 import { DraftRow, StructuredDataAttribute } from '../../containers/StructuredDataContainer/types';
 export type SortDirection = "asc" | "desc";
 /**
@@ -35,3 +37,45 @@ export interface TableHeadRowProps {
     onSortToggle: (attributeName: string) => void;
     onColumnResize: (widths: number[]) => void;
 }
+/**
+ * Состояние колонки вложений: разобранный список файлов, вид поп-апа и все действия над ними.
+ *
+ * Собирается одним хуком и целиком уходит в поп-ап: ячейка показывает свёрнутый вид, а полный
+ * список с добавлением и удалением живёт в поп-апе, и оба обязаны смотреть на одни данные.
+ */
+export interface AttachmentsCellState {
+    items: Attachment[];
+    /** Файлы, видимые в поп-апе сейчас: до «Показать ещё» — только первые. */
+    visibleItems: Attachment[];
+    /** Правка разрешена и режимом таблицы, и самим атрибутом. */
+    editable: boolean;
+    viewMode: AttachmentViewMode;
+    setViewMode: (mode: AttachmentViewMode) => void;
+    hasMore: boolean;
+    hiddenCount: number;
+    onShowMore: VoidFunction;
+    /** Что разрешено выбирать в диалоге файлов — из настроек атрибута. */
+    accept?: string;
+    isPopupOpen: boolean;
+    onClosePopup: VoidFunction;
+    /** Клик по самой ячейке: правка открывает поп-ап, чтение — галерею либо тот же поп-ап. */
+    onCellClick: VoidFunction;
+    previewIndex: number | null;
+    previewImages: IPreviewImage[];
+    isLinkDialogOpen: boolean;
+    onPreview: (link: string) => void;
+    onClosePreview: VoidFunction;
+    onDownload: (image: IPreviewImage, index: number) => void;
+    onDelete: (link: string) => void;
+    onUpload: (files: File[]) => void;
+    /** Нет — выбор из каталога виджету не выдан, и пункт меню недоступен. */
+    onSelectFromCatalog?: VoidFunction;
+    onOpenLinkDialog: VoidFunction;
+    onCloseLinkDialog: VoidFunction;
+    onAddByLink: (url: string) => void;
+}
+export interface AttachmentsCellPopupProps {
+    /** Подпись колонки: в шапке поп-апа она стоит там же, где подпись контейнера вложений. */
+    alias: string;
+    state: AttachmentsCellState;
+}

package/dist/components/Dashboard/hooks/index.d.ts

@@ -1,6 +1,7 @@
 export * from './useAttachmentDownload';
 export * from './useAttachmentItems';
 export * from './useAttachmentPreviewImages';
+export * from './useAttachmentsView';
 export * from './useAutoCompleteControl';
 export * from './useBgImageHost';
 export * from './useContainerAttributes';

package/dist/components/Dashboard/hooks/useAttachmentsView.d.ts

@@ -0,0 +1,25 @@
+import { Attachment, AttachmentViewMode } from '../containers/AttachmentContainer/types';
+export interface UseAttachmentsViewParams {
+    items: Attachment[];
+    /** Сколько файлов показывать сразу. Не задан — показываются все. */
+    limit?: number;
+    /** Вид списка при открытии. */
+    initialViewMode?: AttachmentViewMode;
+}
+export interface AttachmentsView {
+    visibleItems: Attachment[];
+    hiddenCount: number;
+    hasMore: boolean;
+    showMore: boolean;
+    setShowMore: (value: boolean) => void;
+    viewMode: AttachmentViewMode;
+    setViewMode: (mode: AttachmentViewMode) => void;
+}
+/**
+ * Вид списка вложений: плитка или строки и сколько файлов из списка показано.
+ *
+ * Общий для контейнера вложений и колонки таблицы: список у них один и тот же, и считать
+ * видимое дважды незачем. Предел приходит числом, а не опциями конфига, — у колонки опций
+ * вида нет, он у неё зашит константой.
+ */
+export declare const useAttachmentsView: ({ items, limit, initialViewMode, }: UseAttachmentsViewParams) => AttachmentsView;

package/dist/components/Dashboard/types.d.ts

@@ -528,6 +528,16 @@ export interface ConfigAttributeDescription {
      * у колонки нет, поэтому стиль живёт прямо у описания атрибута.
      */
     style?: CSSProperties;
+    /**
+     * Куда складывать файлы, загруженные с диска в колонку вложений (`subType: "Attachments"`) —
+     * id папки каталога. Не задан — файл уходит в корень.
+     */
+    parentResourceId?: string;
+    /**
+     * Что разрешено выбирать в диалоге файлов у колонки вложений — значение атрибута `accept`
+     * (`".pdf,.jpg"` либо `"image/*"`). Не задан — ограничений нет.
+     */
+    fileExtensions?: string;
 }
 export interface ConfigDataSource {
     name: string;

package/dist/components/Dashboard/utils/interpolateTranslation.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Подставляет в строку перевода переменные вида `{{total}}` — так, как это делает i18next.
+ *
+ * Нужна запасному переводчику, когда хост не передал свой `t` (например, в Storybook): без неё
+ * `defaultValue` с переменными уходит в интерфейс как есть. Переменная без значения остаётся
+ * в тексте, чтобы пропуск был виден.
+ */
+export declare const interpolateTranslation: (text: string, values?: Record<string, unknown>) => string;

package/dist/components/Dashboard/utils/sliceShownOtherItems.d.ts

@@ -1,2 +1,7 @@
 import { ConfigOptions } from '../types';
+/**
+ * Сколько элементов показывать сразу. Заданы обе опции — выигрывает меньшая, не задана ни одна —
+ * предела нет и список показывается целиком.
+ */
+export declare const getShownItemsLimit: ({ shownItems, otherItems }?: ConfigOptions) => number | undefined;
 export declare const sliceShownOtherItems: <T extends unknown[]>(data: T, options?: ConfigOptions, showMore?: boolean) => T;