@cyber-harbour/ui 1.0.81 → 1.1.1

package/dist/index.d.mts

@@ -246,6 +246,7 @@ type Theme = {
         ring: {
             highlightFill: string;
             selectionFill: string;
+            borderFill: string;
         };
         button: {
             stroke: string;
@@ -1700,6 +1701,12 @@ interface Graph2DRef {
      * @param padding Отступ от краев в пикселях
      */
     zoomToFit: (duration?: number, padding?: number) => void;
+    /**
+     * Масштабує граф так, щоб виділені вузли були видимі
+     * @param duration Тривалість анімації масштабування в мілісекундах
+     * @param padding Відступ від країв в пікселях
+     */
+    zoomToSelected: (duration?: number, padding?: number) => void;
     /**
      * Добавляет новые узлы и связи на график
      * @param newNodes Массив новых узлов для добавления
@@ -1718,6 +1725,45 @@ interface Graph2DRef {
      * @param nodeIds Массив идентификаторов узлов для удаления
      */
     removeNodes: (nodeIds: (string | number)[]) => void;
+    /**
+     * Выбирает узлы на графе по их идентификаторам
+     * @param nodeIds Массив идентификаторов узлов для выбора
+     * @returns
+     */
+    setSelectedNodes: (nodeIds: (string | number)[]) => void;
+    /**
+     * Знаходить і підсвічує найкоротший шлях між двома нодами
+     * @param sourceId ID початкової ноди
+     * @param targetId ID кінцевої ноди
+     * @returns Кількість нод в знайденому шляху, або 0 якщо шлях не існує
+     */
+    findShortestPath: (sourceId: string | number, targetId: string | number) => number;
+    /**
+     * Впорядковує вибрані вузли в сітці
+     * @param nodeIds Набір ідентифікаторів вузлів для впорядкування
+     * @param options Опції для налаштування розміщення в сітці
+     *   - spacing: відстань між вузлами (за замовчуванням 100)
+     *   - columns: кількість колонок (автоматично розраховується, якщо не вказано)
+     */
+    arrangeSelectedInGrid: (nodeIds: Set<string | number>, options?: {
+        spacing?: number;
+        columns?: number;
+    }) => void;
+    /**
+     * Впорядковує всі вузли в окремі сітки згруповані за значенням ключа
+     * Якщо значення ключа - масив, бере перший елемент
+     * Кожна група вузлів розміщується в окремій сітці, а самі групи теж розташовані у вигляді сітки
+     * @param typeKey Назва ключа для групування (наприклад, 'labels', 'type')
+     * @param options Опції для налаштування розміщення в сітці
+     *   - spacing: відстань між вузлами всередині групи (за замовчуванням 100)
+     *   - columns: кількість колонок всередині кожної групи (автоматично розраховується, якщо не вказано)
+     *   - groupSpacing: відстань між групами (за замовчуванням 200)
+     */
+    arrangeNodesByTypeInGrid: (typeKey: string, options?: {
+        spacing?: number;
+        columns?: number;
+        groupSpacing?: number;
+    }) => void;
 }
 /**
  * Интерфейс для внутреннего состояния компонента Graph2D
@@ -1738,7 +1784,7 @@ interface GraphState {
     /** Узел, который в данный момент перетаскивается */
     draggedNode: NodeObject | null;
     /** Выбранный узел */
-    selectedNode: NodeObject | null;
+    selectedNodeIds: Set<string | number>;
     /** Индекс кнопки, над которой находится курсор */
     hoveredButtonIndex: number | null;
     /** Набор узлов, которые должны быть подсвечены */
@@ -1775,11 +1821,13 @@ interface Graph2DProps {
     width: number;
     height: number;
     buttons?: NodeButton[];
+    enableGrid?: boolean;
     onNodeClick?: (node: NodeObject) => void;
     onBackgroundClick?: () => void;
     onNodeHover?: (node: NodeObject | null) => void;
     onLinkHover?: (link: LinkObject | null) => void;
     onLinkClick?: (link: LinkObject) => void;
+    onChangeSelectedNodeIds?: (nodeIds: Set<string | number>) => void;
 }
 interface NodeButton {
     img: string;

package/dist/index.d.ts

@@ -246,6 +246,7 @@ type Theme = {
         ring: {
             highlightFill: string;
             selectionFill: string;
+            borderFill: string;
         };
         button: {
             stroke: string;
@@ -1700,6 +1701,12 @@ interface Graph2DRef {
      * @param padding Отступ от краев в пикселях
      */
     zoomToFit: (duration?: number, padding?: number) => void;
+    /**
+     * Масштабує граф так, щоб виділені вузли були видимі
+     * @param duration Тривалість анімації масштабування в мілісекундах
+     * @param padding Відступ від країв в пікселях
+     */
+    zoomToSelected: (duration?: number, padding?: number) => void;
     /**
      * Добавляет новые узлы и связи на график
      * @param newNodes Массив новых узлов для добавления
@@ -1718,6 +1725,45 @@ interface Graph2DRef {
      * @param nodeIds Массив идентификаторов узлов для удаления
      */
     removeNodes: (nodeIds: (string | number)[]) => void;
+    /**
+     * Выбирает узлы на графе по их идентификаторам
+     * @param nodeIds Массив идентификаторов узлов для выбора
+     * @returns
+     */
+    setSelectedNodes: (nodeIds: (string | number)[]) => void;
+    /**
+     * Знаходить і підсвічує найкоротший шлях між двома нодами
+     * @param sourceId ID початкової ноди
+     * @param targetId ID кінцевої ноди
+     * @returns Кількість нод в знайденому шляху, або 0 якщо шлях не існує
+     */
+    findShortestPath: (sourceId: string | number, targetId: string | number) => number;
+    /**
+     * Впорядковує вибрані вузли в сітці
+     * @param nodeIds Набір ідентифікаторів вузлів для впорядкування
+     * @param options Опції для налаштування розміщення в сітці
+     *   - spacing: відстань між вузлами (за замовчуванням 100)
+     *   - columns: кількість колонок (автоматично розраховується, якщо не вказано)
+     */
+    arrangeSelectedInGrid: (nodeIds: Set<string | number>, options?: {
+        spacing?: number;
+        columns?: number;
+    }) => void;
+    /**
+     * Впорядковує всі вузли в окремі сітки згруповані за значенням ключа
+     * Якщо значення ключа - масив, бере перший елемент
+     * Кожна група вузлів розміщується в окремій сітці, а самі групи теж розташовані у вигляді сітки
+     * @param typeKey Назва ключа для групування (наприклад, 'labels', 'type')
+     * @param options Опції для налаштування розміщення в сітці
+     *   - spacing: відстань між вузлами всередині групи (за замовчуванням 100)
+     *   - columns: кількість колонок всередині кожної групи (автоматично розраховується, якщо не вказано)
+     *   - groupSpacing: відстань між групами (за замовчуванням 200)
+     */
+    arrangeNodesByTypeInGrid: (typeKey: string, options?: {
+        spacing?: number;
+        columns?: number;
+        groupSpacing?: number;
+    }) => void;
 }
 /**
  * Интерфейс для внутреннего состояния компонента Graph2D
@@ -1738,7 +1784,7 @@ interface GraphState {
     /** Узел, который в данный момент перетаскивается */
     draggedNode: NodeObject | null;
     /** Выбранный узел */
-    selectedNode: NodeObject | null;
+    selectedNodeIds: Set<string | number>;
     /** Индекс кнопки, над которой находится курсор */
     hoveredButtonIndex: number | null;
     /** Набор узлов, которые должны быть подсвечены */
@@ -1775,11 +1821,13 @@ interface Graph2DProps {
     width: number;
     height: number;
     buttons?: NodeButton[];
+    enableGrid?: boolean;
     onNodeClick?: (node: NodeObject) => void;
     onBackgroundClick?: () => void;
     onNodeHover?: (node: NodeObject | null) => void;
     onLinkHover?: (link: LinkObject | null) => void;
     onLinkClick?: (link: LinkObject) => void;
+    onChangeSelectedNodeIds?: (nodeIds: Set<string | number>) => void;
 }
 interface NodeButton {
     img: string;