@evergis/react 4.0.65 → 4.0.67

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Everpoint
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Everpoint
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,7 +1,7 @@
-# @evergis/react
-
-В данном репозитории находятся специфичные (в отличии от `@evergis/uilib-gl`) для `Evergis Online`,
-но в целом переиспользуемые на других проектах, построенных на Evergis API, React-компоненты.
-
-***ВАЖНО!!!***: Разрабатываемые компоненты не должны иметь зависимостей
-от системы поддержки мультиязычности `Evergis Online`!
+# @evergis/react
+
+В данном репозитории находятся специфичные (в отличии от `@evergis/uilib-gl`) для `Evergis Online`,
+но в целом переиспользуемые на других проектах, построенных на Evergis API, React-компоненты.
+
+***ВАЖНО!!!***: Разрабатываемые компоненты не должны иметь зависимостей
+от системы поддержки мультиязычности `Evergis Online`!

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

@@ -10,8 +10,13 @@ export * from './useChartData';
 export * from './useDashboardHeader';
 export * from './useDataSources';
 export * from './useDiffPage';
+export * from './useAfterSave';
+export * from './useBeforeSave';
 export * from './useExpandableContainers';
 export * from './useExportPdf';
+export * from './useFeatureSaveHooks';
+export * from './useFeatureSaveHooks.utils';
+export * from './useSavePrototypeBuilder';
 export * from './useWidgetFilters';
 export * from './useGetConfigLayer';
 export * from './useGlobalContext';

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

@@ -0,0 +1,3 @@
+import { TaskPrototypeDto } from '@evergis/api';
+import { ConfigRelatedResource, SaveHookInput } from '../types';
+export declare const useAfterSave: (hook: ConfigRelatedResource | undefined, buildPrototype: (hook: ConfigRelatedResource, input: SaveHookInput) => TaskPrototypeDto) => (input: SaveHookInput) => Promise<void>;

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

@@ -0,0 +1,3 @@
+import { TaskPrototypeDto } from '@evergis/api';
+import { ConfigRelatedResource, SaveHookInput } from '../types';
+export declare const useBeforeSave: (hook: ConfigRelatedResource | undefined, buildPrototype: (hook: ConfigRelatedResource, input: SaveHookInput) => TaskPrototypeDto) => (input: SaveHookInput) => Promise<boolean>;

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

@@ -0,0 +1,16 @@
+/**
+ * Орchestrator-хук для серверных `beforeSave` / `afterSave` python-скриптов,
+ * описанных в `layerInfo.configuration.editConfiguration.options` слоя.
+ *
+ * - `runBeforeSave(input)` — `Promise<boolean>`, resolves `false` если
+ *   серверная проверка не прошла; сохранение должно быть отменено.
+ * - `runAfterSave(input)` — fire-and-forget после успешного save.
+ *
+ * Активируется только если у потребителя в GlobalProvider переданы
+ * `api`, `notification` и `t`, а приложение обёрнуто в
+ * `<ServerNotificationsProvider>` (для SignalR-подписки на прогресс).
+ */
+export declare const useFeatureSaveHooks: () => {
+    readonly runBeforeSave: (input: import('../types').SaveHookInput) => Promise<boolean>;
+    readonly runAfterSave: (input: import('../types').SaveHookInput) => Promise<void>;
+};

package/dist/components/Dashboard/hooks/useFeatureSaveHooks.utils.d.ts

@@ -0,0 +1,4 @@
+import { ConfigRelatedResource } from '../types';
+export declare const SAVE_HOOK_RESULT_DURATION = 4000;
+export declare const isHookActive: (hook?: ConfigRelatedResource) => hook is ConfigRelatedResource;
+export declare const createSaveNotificationId: () => string;

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

@@ -0,0 +1,3 @@
+import { TaskPrototypeDto } from '@evergis/api';
+import { ConfigRelatedResource, SaveHookInput } from '../types';
+export declare const useSavePrototypeBuilder: () => (hook: ConfigRelatedResource, input: SaveHookInput) => TaskPrototypeDto;

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

@@ -59,6 +59,28 @@ export interface ConfigRelatedResource {
     fileName?: string;
     methodName?: string;
 }
+/**
+ * Конфигурация `editConfiguration.options` слоя. Описывает серверные
+ * python-скрипты, выполняемые до и после сохранения объекта в FeatureCard.
+ *
+ * - `beforeSave` — синхронная серверная валидация перед сохранением.
+ *   Save ждёт `Completed`; при `Error` сохранение отменяется.
+ * - `afterSave` — fire-and-forget действие после успешного сохранения.
+ *
+ * Используется хуком `useFeatureSaveHooks`.
+ */
+export interface EditConfigurationOptions {
+    beforeSave?: ConfigRelatedResource;
+    afterSave?: ConfigRelatedResource;
+}
+/**
+ * Вход для `runBeforeSave` / `runAfterSave` хуков `useFeatureSaveHooks`.
+ * `featureId` равен `null` при создании нового объекта.
+ */
+export interface SaveHookInput {
+    featureId: number | string | null;
+    changedProperties: Record<string, unknown>;
+}
 export interface ConfigControl extends Pick<ConfigOptions, "relatedDataSource" | "minValue" | "maxValue" | "step" | "label" | "placeholder" | "width" | "variants"> {
     type: "dropdown" | "checkbox" | "chips" | "string";
     attributeName?: string;

package/dist/hooks/task/index.d.ts

@@ -1,4 +1,5 @@
 export * from './constants';
 export * from './usePythonTask';
 export * from './usePythonSandbox';
+export * from './useRemoteTask';
 export * from './types';

package/dist/hooks/task/useRemoteTask.d.ts

@@ -0,0 +1,16 @@
+import { RemoteTaskStatus, TaskPrototypeDto } from '@evergis/api';
+export interface RemoteTaskUpdate {
+    status: RemoteTaskStatus;
+    log?: string;
+}
+export interface RemoteTaskResult {
+    taskId: string;
+    status: RemoteTaskStatus.Completed | RemoteTaskStatus.Error;
+    log?: string;
+}
+export interface UseRemoteTaskOptions {
+    onUpdate?: (update: RemoteTaskUpdate) => void;
+}
+export declare const useRemoteTask: ({ onUpdate }?: UseRemoteTaskOptions) => {
+    runTask: (prototype: TaskPrototypeDto) => Promise<RemoteTaskResult>;
+};