@andreyfedkovich/cozy-ui 1.0.1 → 1.0.4

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 Формат основан на [Keep a Changelog](https://keepachangelog.com/).
 Версии соответствуют [Semantic Versioning](https://semver.org/) и git-тегам `v*`.
 
+## 1.0.3 - 2026-07-09
+
+- **feat:** `DialogSelect` — проп `excludeIds`; компонент передаёт его в `loadOptions` и перезапрашивает список при изменении исключений.
+- **feat:** `TreeDialogSelect` — проп `resolveSelectedPath` для раскрытия дерева до выбранного значения при открытии диалога (с прокруткой к строке).
+- **refactor:** `CommentFeed` и `ApprovalRoute` используют `excludeIds` prop вместо ручных обёрток `loadOptions`.
+
+## 1.0.2 - 2026-07-09
+
+- **feat:** `CommentFeed.recipientsSource` и `ApprovalRoute.loadApprovers` — опциональный параметр `excludeIds` для исключения уже выбранных сотрудников из списка в `DialogSelect`.
+- **feat:** Экспорт типа `DialogSelectLoadOptionsParams`.
+
 ## 0.10.1 - 2026-07-08
 
 - **fix:** `TreeDialogSelect` — при серверном поиске (`searchNodes`) скрывать ранее загруженные ветки, не входящие в результаты и цепочки предков.

package/README.md

@@ -665,19 +665,25 @@ Dialog-based picker for large datasets — search + paginated loading + multi-se
 | `label`                  | `ReactNode` | Field label above the trigger.                  |
 | `tooltipContent`         | `ReactNode` | Help tooltip on the «?» icon next to the label. |
 | `tooltipPopperClassName` | `string`    | Extra class for the tooltip popper.             |
+| `excludeIds`             | `string[]`  | IDs to omit from the picker list (passed to `loadOptions`; filtering is done in your callback or API). |
 
 ```tsx
 import { DialogSelect } from "@andreyfedkovich/cozy-ui";
 
+const [reviewers, setReviewers] = useState<{ id: string; name: string }[]>([]);
+
 <DialogSelect
   title="Add reviewer"
   placeholder="Choose a person"
-  loadOptions={async ({ search, page, pageSize }) => {
-    const res = await fetch(`/api/people?q=${search}&page=${page}&size=${pageSize}`);
+  excludeIds={reviewers.map((r) => r.id)}
+  loadOptions={async ({ search, page, pageSize, excludeIds }) => {
+    const res = await fetch(
+      `/api/people?q=${search}&page=${page}&size=${pageSize}&exclude=${excludeIds?.join(",") ?? ""}`,
+    );
     const { items, total } = await res.json();
     return { options: items.map((p) => ({ value: p.id, label: p.name })), total };
   }}
-  onValueChange={(opt) => console.log(opt)}
+  onValueChange={(opt) => setReviewers((prev) => [...prev, { id: String(opt.value), name: String(opt.label) }])}
 />;
 ```
 
@@ -690,6 +696,7 @@ Hierarchical picker with lazy-loaded branches and search.
 | `label`                  | `ReactNode` | Field label above the trigger.                  |
 | `tooltipContent`         | `ReactNode` | Help tooltip on the «?» icon next to the label. |
 | `tooltipPopperClassName` | `string`    | Extra class for the tooltip popper.             |
+| `resolveSelectedPath`    | `(value) => Promise<TreeSearchResult>` | Resolves the path to the current value when the dialog opens; expands the tree, highlights the row, and scrolls it into view. |
 
 ```tsx
 import { TreeDialogSelect } from "@andreyfedkovich/cozy-ui";
@@ -701,6 +708,7 @@ import { TreeDialogSelect } from "@andreyfedkovich/cozy-ui";
     nodes: await fetchChildren(parentId, search),
   })}
   searchNodes={async (search) => ({ matches: await searchTreeWithPath(search) })}
+  resolveSelectedPath={async (value) => ({ matches: await resolveTreePathById(value) })}
   leafConfirmOnly
   onValueChange={(node) => console.log(node)}
 />;
@@ -708,6 +716,8 @@ import { TreeDialogSelect } from "@andreyfedkovich/cozy-ui";
 
 With **`leafConfirmOnly`**, the confirm button in the dialog stays disabled until a row is selected and that node’s `hasChildren` is not strictly `true` (only leaves can be confirmed). Omit the prop to allow confirming any selected node, including branches.
 
+With **`resolveSelectedPath`**, reopening the dialog with an existing `value` expands the tree to that node, pre-selects it in the dialog, and scrolls the row into view. Works independently of `searchNodes`.
+
 #### `InputCaption`
 
 Small caption row under an input — supports neutral, error, and success tones.

package/dist-lib/index.d.ts

@@ -82,7 +82,7 @@ export declare interface ApprovalRouteProps {
     title?: string;
     eyebrow?: string;
     className?: string;
-    loadApprovers?: (params: LoadOptionsParams_2) => Promise<LoadOptionsResult_2>;
+    loadApprovers?: (params: DialogSelectLoadOptionsParams) => Promise<LoadOptionsResult_2>;
     onAddLevel?: (name: string) => void;
     onRemoveLevel?: (levelId: string) => void;
     onAddStage?: (levelId: string, name: string) => void;
@@ -340,11 +340,7 @@ export declare interface CommentFeedHandle {
 export declare interface CommentFeedProps {
     loadComments: (p: CommentLoadParams) => Promise<CommentLoadResult>;
     currentUser: CommentAuthor;
-    recipientsSource?: (params: {
-        search: string;
-        page: number;
-        pageSize: number;
-    }) => Promise<{
+    recipientsSource?: (params: DialogSelectLoadOptionsParams) => Promise<{
         options: CustomOption<CommentAuthor, string>[];
         total?: number;
     }>;
@@ -514,7 +510,7 @@ export declare interface DetailViewProps {
     id?: string;
 }
 
-export declare const DialogSelect: <T, S extends string | number>({ value, placeholder, loadOptions, onValueChange, onChange, onBlur, onFocus, onClear, columns, label, tooltipContent, tooltipPopperClassName, title, searchPlaceholder, selectButtonText, closeButtonText, manualButtonText, onManualAdd, pageSize, debounceMs, disabled, error, suppressError, fieldMeta, showErrorPolicy, className, inputClassName, selectedOptionRender, }: DialogSelectProps<T, S>) => JSX.Element;
+export declare const DialogSelect: <T, S extends string | number>({ value, placeholder, loadOptions, excludeIds, onValueChange, onChange, onBlur, onFocus, onClear, columns, label, tooltipContent, tooltipPopperClassName, title, searchPlaceholder, selectButtonText, closeButtonText, manualButtonText, onManualAdd, pageSize, debounceMs, disabled, error, suppressError, fieldMeta, showErrorPolicy, className, inputClassName, selectedOptionRender, }: DialogSelectProps<T, S>) => JSX.Element;
 
 export declare type DialogSelectColumn<T, S extends string | number> = {
     key: string;
@@ -523,10 +519,16 @@ export declare type DialogSelectColumn<T, S extends string | number> = {
     render: (option: CustomOption<T, S>) => ReactNode;
 };
 
+export declare type DialogSelectLoadOptionsParams = LoadOptionsParams & {
+    excludeIds?: string[];
+};
+
 export declare interface DialogSelectProps<T, S extends string | number> extends ValueFieldCallbacks<CustomOption<T, S>>, FieldValidationProps {
     value?: CustomOption<T, S> | null;
     placeholder: string;
-    loadOptions: (params: LoadOptionsParams) => Promise<LoadOptionsResult<T, S>>;
+    loadOptions: (params: DialogSelectLoadOptionsParams) => Promise<LoadOptionsResult<T, S>>;
+    /** ID записей, которые не должны попадать в список выбора (передаются в loadOptions). */
+    excludeIds?: string[];
     onClear?: () => void;
     onBlur?: default_2.FocusEventHandler<HTMLDivElement>;
     onFocus?: default_2.FocusEventHandler<HTMLDivElement>;
@@ -756,12 +758,6 @@ declare type LoadOptionsParams = {
     pageSize: number;
 };
 
-declare type LoadOptionsParams_2 = {
-    search: string;
-    page: number;
-    pageSize: number;
-};
-
 declare type LoadOptionsResult<T, S extends string | number> = {
     options: CustomOption<T, S>[];
     total?: number;
@@ -1228,7 +1224,7 @@ export declare type TooltipTrigger = "hover" | "click";
 /** `yyyy-MM-dd` for API / form state */
 export declare const toYmdString: (d: Date) => string;
 
-export declare const TreeDialogSelect: <T, S extends string | number>({ value, placeholder, loadChildren: loadChildrenProp, loadNodes, searchNodes, onValueChange, onChange, onBlur, onFocus, onClear, label, tooltipContent, tooltipPopperClassName, title, searchPlaceholder, selectButtonText, closeButtonText, confirmButtonText, debounceMs, disabled, error, suppressError, fieldMeta, showErrorPolicy, className, inputClassName, selectedOptionRender, nodeRender, leafConfirmOnly, }: TreeDialogSelectProps<T, S>) => JSX.Element;
+export declare const TreeDialogSelect: <T, S extends string | number>({ value, placeholder, loadChildren: loadChildrenProp, loadNodes, searchNodes, resolveSelectedPath, onValueChange, onChange, onBlur, onFocus, onClear, label, tooltipContent, tooltipPopperClassName, title, searchPlaceholder, selectButtonText, closeButtonText, confirmButtonText, debounceMs, disabled, error, suppressError, fieldMeta, showErrorPolicy, className, inputClassName, selectedOptionRender, nodeRender, leafConfirmOnly, }: TreeDialogSelectProps<T, S>) => JSX.Element;
 
 /** Pass either {@link loadNodes} or {@link loadChildren} (deprecated alias). */
 export declare type TreeDialogSelectProps<T, S extends string | number> = TreeDialogSelectShared<T, S> & ({
@@ -1243,6 +1239,8 @@ declare interface TreeDialogSelectShared<T, S extends string | number> extends V
     value?: TreeNode<T, S> | null;
     placeholder: string;
     searchNodes?: (search: string) => Promise<TreeSearchResult<T, S>>;
+    /** Resolves the path to the currently selected value when the dialog opens. */
+    resolveSelectedPath?: (value: S) => Promise<TreeSearchResult<T, S>>;
     onClear?: () => void;
     onBlur?: default_2.FocusEventHandler<HTMLDivElement>;
     onFocus?: default_2.FocusEventHandler<HTMLDivElement>;