@evergis/react 4.0.136 → 4.0.138

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

@@ -503,6 +503,14 @@ export interface UploadContainerConfig extends Omit<ConfigContainerChild, "optio
 export interface UploadContainerProps extends Omit<ContainerProps, "elementConfig"> {
     elementConfig?: UploadContainerConfig;
 }
+export type VoteContainerOptions = Pick<ConfigOptions, "categoryDataSource" | "questionDataSource" | "variantDataSource" | "answerDataSource" | "expandable" | "expanded"> & ContainerBoxOptions;
+export interface VoteContainerConfig extends Omit<ConfigContainerChild, "options" | "templateName"> {
+    templateName?: ContainerTemplate.Vote;
+    options?: VoteContainerOptions;
+}
+export interface VoteContainerProps extends Omit<ContainerProps, "elementConfig"> {
+    elementConfig?: VoteContainerConfig;
+}
 export type DashboardDefaultHeaderOptions = Pick<ConfigOptions, "url">;
 export interface DashboardDefaultHeaderConfig extends Omit<ConfigContainerHeader, "options" | "templateName"> {
     templateName?: HeaderTemplate.Default;
@@ -532,7 +540,7 @@ export interface FeatureCardSlideshowHeaderConfig extends Omit<ConfigContainerHe
  * Поскольку оба поля помечены как опциональные (`?`), значения **без** дискриминатора по-прежнему
  * приемлемы для любой ветви — это переходная мягкая совместимость с legacy-конфигами.
  */
-export type DashboardChild = ElementButtonConfig | ElementCameraConfig | ElementChartConfig | ElementChipsConfig | ElementControlConfig | ElementIconConfig | ElementImageConfig | ElementLegendConfig | ElementLinkConfig | ElementMarkdownConfig | ElementModalConfig | ElementSlideshowConfig | ElementSvgConfig | ElementTableConfig | ElementTooltipConfig | ElementUploaderConfig | AddFeatureContainerConfig | AttachmentContainerConfig | CameraContainerConfig | ChartContainerConfig | ContainersGroupContainerConfig | DataSourceContainerConfig | DataSourceProgressContainerConfig | DefaultAttributesContainerConfig | DividerContainerElementConfig | EditContainerConfig | EditGroupContainerConfig | EditBooleanContainerConfig | EditStringContainerConfig | EditNumberContainerConfig | EditDropdownContainerConfig | EditChipsContainerConfig | EditCheckboxContainerConfig | EditDateContainerConfig | EditAttachmentContainerConfig | ExportPdfContainerConfig | FiltersContainerConfig | GridRowContainerConfig | IconContainerConfig | ImageContainerConfig | LayersContainerConfig | OneColumnContainerConfig | ProgressContainerConfig | RoundedBackgroundContainerConfig | SlideshowContainerConfig | StructuredDataContainerConfig | TabsContainerConfig | TaskContainerConfig | TitleContainerConfig | TwoColumnContainerConfig | UploadContainerConfig;
+export type DashboardChild = ElementButtonConfig | ElementCameraConfig | ElementChartConfig | ElementChipsConfig | ElementControlConfig | ElementIconConfig | ElementImageConfig | ElementLegendConfig | ElementLinkConfig | ElementMarkdownConfig | ElementModalConfig | ElementSlideshowConfig | ElementSvgConfig | ElementTableConfig | ElementTooltipConfig | ElementUploaderConfig | AddFeatureContainerConfig | AttachmentContainerConfig | CameraContainerConfig | ChartContainerConfig | ContainersGroupContainerConfig | DataSourceContainerConfig | DataSourceProgressContainerConfig | DefaultAttributesContainerConfig | DividerContainerElementConfig | EditContainerConfig | EditGroupContainerConfig | EditBooleanContainerConfig | EditStringContainerConfig | EditNumberContainerConfig | EditDropdownContainerConfig | EditChipsContainerConfig | EditCheckboxContainerConfig | EditDateContainerConfig | EditAttachmentContainerConfig | ExportPdfContainerConfig | FiltersContainerConfig | GridRowContainerConfig | IconContainerConfig | ImageContainerConfig | LayersContainerConfig | OneColumnContainerConfig | ProgressContainerConfig | RoundedBackgroundContainerConfig | SlideshowContainerConfig | StructuredDataContainerConfig | TabsContainerConfig | TaskContainerConfig | TitleContainerConfig | TwoColumnContainerConfig | UploadContainerConfig | VoteContainerConfig;
 /**
  * Строгий authoring-тип узла конфига. В отличие от мягкого {@link ConfigContainerChild}
  * (`id?` — опционален ради legacy-совместимости), здесь `id` **обязателен** и рекурсивно
@@ -615,6 +623,7 @@ export type ContainerTemplateToProps = {
     [ContainerTemplate.Title]: TitleContainerProps;
     [ContainerTemplate.TwoColumn]: TwoColumnContainerProps;
     [ContainerTemplate.Upload]: UploadContainerProps;
+    [ContainerTemplate.Vote]: VoteContainerProps;
 };
 /**
  * Карта `type` → `<Name>ElementProps` для регистра элементов из `elements/registry.ts`.

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

@@ -14,6 +14,7 @@ export declare const SHP_MIME_TYPE = "application/octet-stream";
 export declare const KML_MIME_TYPE = "application/octet-stream";
 export declare const ZIP_MIME_TYPE = "application/zip";
 export declare const PYTHON_MIME_TYPES: string[];
+export declare const DOWNLOAD_ERROR_DURATION = 5000;
 export declare enum AddAttachmentSource {
     Pc = "pc",
     Catalog = "catalog",

package/dist/components/Dashboard/containers/AttachmentContainer/utils/saveBlobAsFile.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Отдаёт браузеру уже загруженный файл под именем `fileName`.
+ *
+ * Адрес отзывается не сразу: часть браузеров дочитывает поток уже после клика, и мгновенный
+ * `revokeObjectURL` обрывает сохранение.
+ */
+export declare const saveBlobAsFile: (blob: Blob, fileName: string) => void;

package/dist/components/Dashboard/containers/VoteContainer/components/VoteCreateForm.d.ts

@@ -0,0 +1,3 @@
+import { FC } from 'react';
+import { VoteCreateFormProps } from '../types';
+export declare const VoteCreateForm: FC<VoteCreateFormProps>;

package/dist/components/Dashboard/containers/VoteContainer/components/VoteResults.d.ts

@@ -0,0 +1,3 @@
+import { FC } from 'react';
+import { VoteResultsProps } from '../types';
+export declare const VoteResults: FC<VoteResultsProps>;

package/dist/components/Dashboard/containers/VoteContainer/components/VoteScreen.d.ts

@@ -0,0 +1,9 @@
+import { FC } from 'react';
+import { VoteScreenProps } from '../types';
+/**
+ * Тело контейнера: выбирает экран по вью-модели голосования.
+ *
+ * Живёт отдельно от `VoteContainer`, потому что тот отвечает за корень контейнера — размеры,
+ * фон и заголовок — и не должен раздуваться ветвлением по состояниям.
+ */
+export declare const VoteScreen: FC<VoteScreenProps>;

package/dist/components/Dashboard/containers/VoteContainer/components/VoteShare.d.ts

@@ -0,0 +1,3 @@
+import { FC } from 'react';
+/** Блок «Поделиться в соцсетях» — пока только вёрстка, без рабочих ссылок. */
+export declare const VoteShare: FC;

package/dist/components/Dashboard/containers/VoteContainer/constants.d.ts

@@ -0,0 +1,46 @@
+/** Имена полей таблиц голосования. */
+export declare const VOTE_FIELDS: {
+    readonly category: {
+        readonly id: "id";
+        readonly name: "name";
+    };
+    readonly question: {
+        readonly id: "id";
+        readonly text: "text";
+        readonly categoryId: "category_id";
+        readonly userName: "user_name";
+        readonly multiSelect: "multi_select";
+    };
+    readonly variant: {
+        readonly id: "id";
+        readonly questionId: "question_id";
+        readonly text: "text";
+    };
+    readonly answer: {
+        readonly id: "id";
+        readonly questionId: "question_id";
+        readonly userName: "user_name";
+        readonly variantId: "variant_id";
+    };
+};
+/** Минимальное число вариантов ответа в голосовании. */
+export declare const MIN_VARIANTS = 2;
+/** Лимит при чтении списков (вариантов/ответов/категорий). */
+export declare const VOTE_FETCH_LIMIT = 10000;
+/** База для перевода доли голосов в проценты. */
+export declare const PERCENT_BASE = 100;
+/** Namespace переводов потребляющего приложения (подписи берутся через `t` с defaultValue). */
+export declare const VOTE_NS = "dashboard";
+/**
+ * Имя публичного (анонимного) аккаунта портала.
+ *
+ * Под ним сервер отдаёт `getUserInfo()` любому неавторизованному посетителю шаренного проекта,
+ * поэтому «кто уже голосовал» по нему не считается: первый же голос закрыл бы голосование всем
+ * сразу. Такой посетитель для контейнера — неавторизованный, ему доступны только результаты.
+ *
+ * Признака анонима в API нет (`UserInfoDc` — это `username` + `roles`), поэтому имя приходится
+ * знать по конвенции портала: оно же стоит ролью в ACL публичных ресурсов.
+ */
+export declare const PUBLIC_USER_NAME = "public_user";
+/** Социальные сети для блока «Поделиться». */
+export declare const VOTE_SOCIALS: string[];

package/dist/components/Dashboard/containers/VoteContainer/hooks/useVoteActions.d.ts

@@ -0,0 +1,26 @@
+import { FeatureDc } from '@evergis/api';
+import { VoteDataSources, VoteFormValues, VoteQuestion, VoteVariant } from '../types';
+interface UseVoteActionsProps {
+    dataSources: VoteDataSources;
+    attributeName: string;
+    featureId?: string;
+    featureLayerName?: string;
+    username: string;
+    question: VoteQuestion | null;
+    variants: VoteVariant[];
+    answers: FeatureDc[];
+    onQuestionIdChange: (questionId: string) => void;
+    reload: () => void;
+}
+/**
+ * Операции записи контейнера: создание голосования, отправка ответа, редактирование и удаление.
+ * Все операции доступны только авторизованному пользователю.
+ */
+export declare const useVoteActions: ({ dataSources, attributeName, featureId, featureLayerName, username, question, variants, answers, onQuestionIdChange, reload, }: UseVoteActionsProps) => {
+    submitting: boolean;
+    createVote: (values: VoteFormValues) => Promise<void>;
+    submitAnswer: (variantIds: string[]) => Promise<void>;
+    editVote: (values: VoteFormValues) => Promise<void>;
+    deleteVote: () => Promise<void>;
+};
+export {};

package/dist/components/Dashboard/containers/VoteContainer/hooks/useVoteContainer.d.ts

@@ -0,0 +1,25 @@
+import { VoteContainerConfig } from '../../../componentTypes';
+import { VoteFormValues, VoteScreen } from '../types';
+/**
+ * Вью-модель контейнера голосования: определяет текущий экран и собирает данные/действия.
+ * Привязка к объекту карты — через `elementConfig.attributeName` (хранит `question_id`).
+ */
+export declare const useVoteContainer: (elementConfig?: VoteContainerConfig) => {
+    submitting: boolean;
+    createVote: (values: VoteFormValues) => Promise<void>;
+    submitAnswer: (variantIds: string[]) => Promise<void>;
+    editVote: (values: VoteFormValues) => Promise<void>;
+    deleteVote: () => Promise<void>;
+    configured: boolean;
+    screen: VoteScreen;
+    categories: import('../types').VoteCategory[];
+    question: import('../types').VoteQuestion;
+    category: import('../types').VoteCategory;
+    results: import('../types').VoteVariantResult[];
+    totalVotes: number;
+    isOwner: boolean;
+    hasAnswers: boolean;
+    isEditing: boolean;
+    setIsEditing: import('react').Dispatch<import('react').SetStateAction<boolean>>;
+    editInitialValues: VoteFormValues;
+};

package/dist/components/Dashboard/containers/VoteContainer/hooks/useVoteData.d.ts

@@ -0,0 +1,22 @@
+import { FeatureDc } from '@evergis/api';
+import { VoteCategory, VoteDataSources, VoteQuestion, VoteVariant } from '../types';
+interface UseVoteDataProps {
+    dataSources: VoteDataSources;
+    questionId: string;
+    reloadToken: number;
+}
+/**
+ * Загружает справочник категорий, а по `questionId` — само голосование, его варианты и ответы.
+ * Перечитывается при смене `questionId` или `reloadToken` (после создания/голосования/правки).
+ */
+export declare const useVoteData: ({ dataSources, questionId, reloadToken }: UseVoteDataProps) => {
+    categories: VoteCategory[];
+    question: VoteQuestion;
+    variants: VoteVariant[];
+    answers: FeatureDc[];
+    results: import('../types').VoteVariantResult[];
+    totalVotes: number;
+    loading: boolean;
+    error: boolean;
+};
+export {};

package/dist/components/Dashboard/containers/VoteContainer/hooks/useVoteForm.d.ts

@@ -0,0 +1,17 @@
+import { VoteFormValues, VoteFormVariant } from '../types';
+/** Локальное состояние формы создания/редактирования голосования (категория, вопрос, чипсы-варианты). */
+export declare const useVoteForm: (initialValues?: VoteFormValues) => {
+    categoryId: string;
+    setCategoryId: import('react').Dispatch<import('react').SetStateAction<string>>;
+    text: string;
+    setText: import('react').Dispatch<import('react').SetStateAction<string>>;
+    multiSelect: boolean;
+    setMultiSelect: import('react').Dispatch<import('react').SetStateAction<boolean>>;
+    variants: VoteFormVariant[];
+    addVariant: () => void;
+    removeVariant: (index: number) => void;
+    draft: string;
+    setDraft: import('react').Dispatch<import('react').SetStateAction<string>>;
+    isValid: boolean;
+    values: VoteFormValues;
+};

package/dist/components/Dashboard/containers/VoteContainer/hooks/useVoteUser.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Текущий пользователь для контейнера голосования. Авторизация обязательна — неавторизованный
+ * пользователь видит только результаты. Источник — `api.account.getUserInfo()`; ошибка/отсутствие
+ * `username` трактуются как «не авторизован».
+ *
+ * Публичный аккаунт портала (`PUBLIC_USER_NAME` в `username` или в ролях) авторизацией не
+ * считается: под ним ходят ВСЕ анонимные посетители шаренного проекта, поэтому и «мой голос»,
+ * и владение голосованием опознались бы у них общими на всех.
+ */
+export declare const useVoteUser: () => {
+    username: string;
+    isAuthenticated: boolean;
+    loading: boolean;
+};

package/dist/components/Dashboard/containers/VoteContainer/index.d.ts

@@ -0,0 +1,11 @@
+import { FC } from 'react';
+import { VoteContainerProps } from '../../componentTypes';
+/**
+ * Контейнер «Голосование»: привязывает опрос к объекту карты через `attributeName`
+ * и показывает один из экранов — создание, голосование, после голосования
+ * или (для неавторизованных) только результаты.
+ *
+ * Корнем владеет сам (`useContainerRoot`), поэтому шаблон записан в `ROOT_OWNING_TEMPLATES`:
+ * размеры, авторский `style`, фон и заголовок живут на одном узле, без внешней обёртки.
+ */
+export declare const VoteContainer: FC<VoteContainerProps>;

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

@@ -0,0 +1,31 @@
+import { RadioGroup } from '@evergis/uilib-gl';
+export declare const VoteWrapper: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps, never>;
+export declare const VoteHeading: import('styled-components').StyledComponent<"div", any, {}, never>;
+export declare const VoteQuestionText: import('styled-components').StyledComponent<"div", any, {}, never>;
+export declare const VoteCategoryLabel: import('styled-components').StyledComponent<"div", any, {}, never>;
+export declare const VoteSectionLabel: import('styled-components').StyledComponent<"div", any, {}, never>;
+export declare const VoteChipList: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps, never>;
+export declare const VoteChip: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps, never>;
+/**
+ * Список вариантов ответа.
+ *
+ * Обёртка — именно `RadioGroup`: `Radio` из uilib читает его legacy-контекст и без него бросает
+ * `Radio must be controlled with RadioGroup context.` — даже когда `checked` и `onChange` заданы
+ * на самом контроле. Группа стоит всегда, а не только в режиме одиночного выбора: лишнего она не
+ * рисует, зато контекст не может пропасть при смене экрана.
+ *
+ * Подпись у `Radio` своя, но текст варианта рисует строка — он делит место со счётчиком и
+ * прогресс-баром. Поэтому пустой узел подписи и отступ кружка до него снимаются.
+ */
+export declare const VoteVariantList: import('styled-components').StyledComponent<typeof RadioGroup, any, {}, never>;
+export declare const VoteVariantRow: import('styled-components').StyledComponent<"div", any, {}, never>;
+export declare const VoteVariantHead: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps, never>;
+export declare const VoteVariantText: import('styled-components').StyledComponent<"span", any, {}, never>;
+export declare const VoteVariantCount: import('styled-components').StyledComponent<"span", any, {}, never>;
+export declare const VoteAcceptedBadge: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps, never>;
+export declare const VoteAuthHint: import('styled-components').StyledComponent<"div", any, {}, never>;
+export declare const VoteEditLink: import('styled-components').StyledComponent<"button", any, {}, never>;
+export declare const VoteShareBlock: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps, never>;
+export declare const VoteShareChips: import('styled-components').StyledComponent<"div", any, import('@evergis/uilib-gl').FlexProps, never>;
+export declare const VoteShareChip: import('styled-components').StyledComponent<"div", any, {}, never>;
+export declare const VoteError: import('styled-components').StyledComponent<"div", any, {}, never>;

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

@@ -0,0 +1,88 @@
+import { VoteContainerOptions } from '../../componentTypes';
+/** Экран, который показывает контейнер голосования. */
+export type VoteScreen = "loading" | "create" | "voting" | "voted" | "unauthenticated";
+export interface VoteCategory {
+    id: string;
+    name: string;
+}
+export interface VoteQuestion {
+    id: string;
+    text: string;
+    categoryId: string;
+    userName: string;
+    multiSelect: boolean;
+}
+export interface VoteVariant {
+    id: string;
+    text: string;
+}
+/** Вариант ответа с подсчитанными результатами. `percent` — доля от всех голосов (0..100). */
+export interface VoteVariantResult extends VoteVariant {
+    count: number;
+    percent: number;
+}
+/** Полезная нагрузка формы создания/редактирования. */
+export interface VoteFormValues {
+    categoryId: string;
+    text: string;
+    multiSelect: boolean;
+    variants: VoteFormVariant[];
+}
+/** Вариант в форме: для существующих — с `id` из БД, для новых — `id` пустой. */
+export interface VoteFormVariant {
+    id?: string;
+    text: string;
+}
+/**
+ * Имена слоёв-таблиц голосования, гарантированно непустые.
+ *
+ * Берутся из `options` контейнера, но отдельно от остальных его опций: размеры и заголовок
+ * к данным отношения не имеют, а `Required<VoteContainerOptions>` потребовал бы и их.
+ */
+export type VoteDataSources = Required<Pick<VoteContainerOptions, "categoryDataSource" | "questionDataSource" | "variantDataSource" | "answerDataSource">>;
+export interface VoteCreateFormProps {
+    categories: VoteCategory[];
+    initialValues?: VoteFormValues;
+    isEditing: boolean;
+    canDelete: boolean;
+    submitting: boolean;
+    onSubmit: (values: VoteFormValues) => void;
+    onDelete?: () => void;
+    onCancel?: () => void;
+}
+export interface VoteResultsProps {
+    question: VoteQuestion;
+    category?: VoteCategory;
+    results: VoteVariantResult[];
+    totalVotes: number;
+    screen: VoteScreen;
+    isOwner: boolean;
+    hasAnswers: boolean;
+    submitting: boolean;
+    onSubmit: (variantIds: string[]) => void;
+    onEdit?: () => void;
+}
+/**
+ * Вью-модель голосования, которую контейнер отдаёт в тело (`VoteScreen`).
+ *
+ * Это ровно результат `useVoteContainer` без `configured`: признак настроенности разбирает сам
+ * контейнер — он решает, рисовать тело или ошибку блока, и до экранов этот флаг не доходит.
+ */
+export interface VoteScreenProps {
+    screen: VoteScreen;
+    categories: VoteCategory[];
+    question: VoteQuestion | null;
+    category?: VoteCategory;
+    results: VoteVariantResult[];
+    totalVotes: number;
+    isOwner: boolean;
+    hasAnswers: boolean;
+    isEditing: boolean;
+    setIsEditing: (isEditing: boolean) => void;
+    editInitialValues?: VoteFormValues;
+    submitting: boolean;
+    createVote: (values: VoteFormValues) => Promise<void>;
+    submitAnswer: (variantIds: string[]) => Promise<void>;
+    editVote: (values: VoteFormValues) => Promise<void>;
+    deleteVote: () => Promise<void>;
+}

package/dist/components/Dashboard/containers/VoteContainer/utils.d.ts

@@ -0,0 +1,38 @@
+import { FeatureDc } from '@evergis/api';
+import { VoteCategory, VoteFormVariant, VoteQuestion, VoteVariant, VoteVariantResult } from './types';
+/** Приводит значение атрибута к строке-идентификатору (id приходят числами/строками). */
+export declare const toId: (value: unknown) => string;
+/**
+ * Условие равенства по числовому полю для `conditions` слоя: `field == value`.
+ *
+ * Двойное равенство — форма, которой написаны условия во всех конфигах проекта; лексер языка
+ * условий принимает и одиночное `=`, но расходиться с авторскими конфигами незачем.
+ */
+export declare const eqCondition: (field: string, value: string | number) => string;
+export declare const mapCategories: (features: FeatureDc[]) => VoteCategory[];
+export declare const mapQuestion: (feature: FeatureDc) => VoteQuestion;
+export declare const mapVariants: (features: FeatureDc[]) => VoteVariant[];
+/** Список `variant_id` из ответов конкретного пользователя. */
+export declare const getUserVariantIds: (answers: FeatureDc[], userName: string) => string[];
+/** Id записей-ответов конкретного пользователя (для замены ответа при переголосовании). */
+export declare const getUserAnswerIds: (answers: FeatureDc[], userName: string) => string[];
+/**
+ * Считает голоса по вариантам. `percent` — доля голосов варианта от общего числа голосов
+ * по голосованию.
+ */
+export declare const computeResults: (variants: VoteVariant[], answers: FeatureDc[]) => {
+    results: VoteVariantResult[];
+    totalVotes: number;
+};
+/**
+ * Сравнивает варианты из формы с существующими в БД и раскладывает на наборы операций:
+ * создать (новые без id), обновить (изменился текст) и удалить (исчезли из формы).
+ */
+export declare const diffVariants: (existing: VoteVariant[], next: VoteFormVariant[]) => {
+    toCreate: string[];
+    toUpdate: Array<{
+        id: string;
+        text: string;
+    }>;
+    toDeleteIds: string[];
+};

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

@@ -23,3 +23,4 @@ export * from './TabsContainer';
 export * from './TitleContainer';
 export * from './TwoColumnContainer';
 export * from './UploadContainer';
+export * from './VoteContainer';

package/dist/components/Dashboard/containers/registry.d.ts

@@ -57,6 +57,7 @@ export declare const getContainerComponents: () => {
     readonly EditAttachment: FC<import('../componentTypes').EditAttachmentContainerProps>;
     readonly Attachment: FC<import('../componentTypes').AttachmentContainerProps>;
     readonly EditGroup: FC<import('../componentTypes').EditGroupContainerProps>;
+    readonly Vote: FC<import('../componentTypes').VoteContainerProps>;
     readonly ContainersGroup: FC<import('../componentTypes').ContainersGroupContainerProps>;
     readonly GridRow: FC<import('../componentTypes').GridRowContainerProps>;
     readonly StructuredData: FC<import('../componentTypes').StructuredDataContainerProps>;

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

@@ -1,3 +1,4 @@
+export * from './useAttachmentDownload';
 export * from './useAttachmentItems';
 export * from './useAttachmentPreviewImages';
 export * from './useAutoCompleteControl';

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

@@ -0,0 +1,9 @@
+import { Attachment } from '../containers/AttachmentContainer/types';
+/**
+ * Скачивание вложения по требованию — файл запрашивается в момент клика, а не заранее.
+ *
+ * Свой файл лежит за авторизацией (`Authorization: Bearer`), поэтому ссылкой его не отдать:
+ * он тянется через api и сохраняется из памяти. Чужой открывается ссылкой — кросс-доменный
+ * `download` браузер всё равно игнорирует.
+ */
+export declare const useAttachmentDownload: (items: Attachment[]) => ((index: number) => void);

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

@@ -440,6 +440,19 @@ export interface ConfigEntityRefOptions {
     parentResourceId?: string;
     downloadById?: string;
 }
+/**
+ * Опции контейнера «Голосование» (`ContainerTemplate.Vote`).
+ *
+ * Каждое поле — имя DataSource-таблицы проекта, к которой обращается runtime контейнера:
+ * категории, голосования, варианты ответов и ответы пользователей. `question_id` созданного
+ * голосования пишется в атрибут объекта карты (см. {@link ConfigContainerChild.attributeName}).
+ */
+export interface ConfigVoteOptions {
+    categoryDataSource?: string;
+    questionDataSource?: string;
+    variantDataSource?: string;
+    answerDataSource?: string;
+}
 /** Прочее — поля без явного домена, обычно широкого назначения. */
 export interface ConfigMiscOptions {
     innerTemplateName?: ContainerTemplate;
@@ -463,7 +476,7 @@ export interface ConfigMiscOptions {
  * `Pick<ConfigOptions, ...>`, продолжают работать. Для нового кода предпочтительно делать
  * `Pick<Config<Domain>Options, ...>` — это лучше документирует, к какому домену относится опция.
  */
-export interface ConfigOptions extends ConfigLayoutOptions, ConfigTypographyOptions, ConfigExpandableOptions, ConfigDataSourceBindingOptions, ConfigChartOptions, ConfigVisualOptions, ConfigTextDisplayOptions, ConfigCollectionOptions, ConfigMapLayerOptions, ConfigEditOptions, ConfigMiscOptions {
+export interface ConfigOptions extends ConfigLayoutOptions, ConfigTypographyOptions, ConfigExpandableOptions, ConfigDataSourceBindingOptions, ConfigChartOptions, ConfigVisualOptions, ConfigTextDisplayOptions, ConfigCollectionOptions, ConfigMapLayerOptions, ConfigEditOptions, ConfigVoteOptions, ConfigMiscOptions {
 }
 /**
  * Настройки атрибута источника данных, заданные в конфиге.
@@ -733,7 +746,8 @@ export declare enum ContainerTemplate {
     EditAttachment = "EditAttachment",
     Attachment = "Attachment",
     Divider = "Divider",
-    StructuredData = "StructuredData"
+    StructuredData = "StructuredData",
+    Vote = "Vote"
 }
 export declare enum HeaderTemplate {
     Default = "Default",