@chrome-consulting/krit-ui 0.0.49

package/dist/components/ui/tooltip.d.ts

@@ -0,0 +1,65 @@
+import * as React from 'react';
+import * as TooltipPrimitive from '@radix-ui/react-tooltip';
+/**
+ * Провайдер для системы всплывающих подсказок.
+ * Обеспечивает контекст и управление состоянием для всех Tooltip-компонентов.
+ *
+ * @component
+ * @param {React.ComponentProps<typeof TooltipPrimitive.Provider>} props - Свойства провайдера
+ * @returns {React.ReactElement} Провайдер системы подсказок
+ */
+declare const TooltipProvider: React.FC<TooltipPrimitive.TooltipProviderProps>;
+/**
+ * Основной компонент всплывающей подсказки.
+ *
+ * @component
+ * @param {React.ComponentProps<typeof TooltipPrimitive.Root>} props - Свойства компонента
+ * @returns {React.ReactElement} Компонент подсказки
+ */
+declare const Tooltip: React.FC<TooltipPrimitive.TooltipProps>;
+/**
+ * Триггер для отображения всплывающей подсказки.
+ *
+ * @component
+ * @param {React.ComponentProps<typeof TooltipPrimitive.Trigger>} props - Свойства компонента
+ * @returns {React.ReactElement} Триггер подсказки
+ */
+declare const TooltipTrigger: React.ForwardRefExoticComponent<TooltipPrimitive.TooltipTriggerProps & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * Контент всплывающей подсказки.
+ *
+ * @component
+ * @param {object} props - Свойства компонента
+ * @param {string} [props.className] - Дополнительные CSS-классы
+ * @param {number} [props.sideOffset=4] - Смещение от элемента
+ * @param {React.Ref<React.ElementRef<typeof TooltipPrimitive.Content>>} ref - React ref
+ * @returns {React.ReactElement} Контент подсказки
+ */
+declare const TooltipContent: React.ForwardRefExoticComponent<Omit<TooltipPrimitive.TooltipContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Пропсы компонента InfoTooltip
+ * @interface InfoTooltipProps
+ * @property {React.ReactNode} [children] - Элемент, для которого показывается подсказка
+ * @property {string} [text] - Текст подсказки
+ * @property {number} [delayDuration] - Задержка перед показом подсказки (мс)
+ */
+interface InfoTooltipProps {
+    children?: React.ReactNode;
+    text?: string;
+    delayDuration?: number;
+}
+/**
+ * Упрощенный компонент всплывающей подсказки с предустановленными стилями.
+ * Поддерживает форматирование текста с помощью Markdown-подобного синтаксиса.
+ *
+ * @component
+ * @param {InfoTooltipProps} props - Пропсы компонента
+ * @returns {React.ReactElement} Компонент информационной подсказки
+ *
+ * @example
+ * <InfoTooltip text="Это **важная** подсказка">
+ *   <Button>Наведи меня</Button>
+ * </InfoTooltip>
+ */
+declare const InfoTooltip: ({ children, text, delayDuration }: InfoTooltipProps) => import("react/jsx-runtime").JSX.Element;
+export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider, InfoTooltip };

package/dist/components/ui/tree-view.d.ts

@@ -0,0 +1,96 @@
+import { ForwardRefExoticComponent, ReactNode, RefAttributes, RefObject } from 'react';
+export interface TreeNode<T = unknown> {
+    id: number | string;
+    level?: number;
+    children?: TreeNode<T>[];
+    [key: string]: unknown;
+    onClick?: () => void;
+    onDoubleClick?: () => void;
+}
+/**
+ * Пропсы строки таблицы при использовании `tableRowComponent` или строки по умолчанию в `TreeView`.
+ */
+export interface TreeViewTableRowProps<T extends TreeNode> {
+    node: T;
+    children: ReactNode;
+    onClick: () => void;
+    onDoubleClick: () => void;
+    className: string;
+    'data-index'?: number | string;
+}
+export interface TreeViewConfig<T extends TreeNode> {
+    getNodeId: (node: T) => number | string;
+    getNodeLevel: (node: T) => number;
+    getNodeChildren: (node: T) => T[] | undefined;
+    hasNestedNodes: (node: T) => boolean;
+    isNodeExpanded: (node: T) => boolean;
+    isNodeSelected: (node: T, selected: unknown) => boolean;
+    getNodeHeadingText: (node: T) => string | number | undefined;
+    /** Фактическая высота строки для направляющих дерева. */
+    getNodeRowHeight?: (node: T) => number | string | undefined;
+    /** Контент перед иконкой раскрытия в колонке названия (например чекбокс). */
+    getNodeHeadingPrefix?: (node: T) => ReactNode;
+    getNodeFooterText: (node: T) => string | undefined;
+    getNodeCellValues: (node: T) => ReactNode[];
+    getNodeHeadingClassName?: (node: T) => string | undefined;
+    getNodeHeadingMaxLength?: (node: T) => number | undefined;
+    /** Возвращает готовый ReactNode для footer (например ссылку). Если undefined — рендерится getNodeFooterText в span. */
+    getNodeFooterNode?: (node: T, options: {
+        text: string;
+        className: string;
+    }) => ReactNode | undefined;
+    /** Дополнительные CSS-классы для стандартного футера (когда getNodeFooterNode не используется). */
+    getNodeFooterClassName?: (node: T) => string | undefined;
+    renderTooltip?: (node: T) => ReactNode;
+    renderExpandIcon?: (node: T, isExpanded: boolean, onClick: () => void) => ReactNode;
+    /** Ширина колонки направляющих дерева, px (по умолчанию 24). */
+    treeGuideColumnWidth?: number;
+    /** Смещение якоря линии от начала контентной области, px (по умолчанию половина treeGuideColumnWidth). */
+    treeLineAnchorOffset?: number;
+    /** Вертикальная позиция соединительной линии в строке (по умолчанию середина строки). */
+    treeLineAnchorTop?: number | string;
+    /** Вертикальные отступы ячеек данных. По умолчанию зависят от density. */
+    dataCellVerticalPadding?: 'default' | 'none';
+}
+/**
+ * Строка таблицы с ref (виртуализатор dnd-kit и др.).
+ */
+export type TreeViewTableRowComponent<T extends TreeNode> = ForwardRefExoticComponent<TreeViewTableRowProps<T> & RefAttributes<HTMLTableRowElement>>;
+export interface TreeViewProps<T extends TreeNode> {
+    nodes: T[];
+    selected?: unknown;
+    config: TreeViewConfig<T>;
+    headers?: string[];
+    /** Кастомные ячейки заголовка (например FiltersColumnHeader). Приоритетнее headers. */
+    headerCells?: ReactNode[];
+    className?: string;
+    columnWidths?: (number | string)[];
+    columnAlignments?: ('left' | 'center' | 'right')[];
+    onExpand: (node: T) => void;
+    /**
+     * Кастомная строка таблицы (например, с ref для dnd-kit). По умолчанию — стандартная строка.
+     * Должна рендерить &lt;tr ref&gt; в корне и вложить `children` (ячейки &lt;td&gt;).
+     */
+    tableRowComponent?: TreeViewTableRowComponent<T>;
+    virtualized?: boolean;
+    estimateRowSize?: number;
+    overscan?: number;
+    scrollElementRef?: RefObject<HTMLDivElement>;
+    /** ID для scroll-контейнера (для синхронизации скролла с другими элементами) */
+    scrollContainerId?: string;
+    /** Чередование фона строк, как в DataTable */
+    striped?: boolean;
+    /** Горизонтальные отступы ячеек, как в DataTable; `none` — без доп. отступов (узкие деревья навигации) */
+    horizontalPadding?: 'none' | 'small' | 'medium' | 'large';
+    /** `compact` — плотные строки без отступов DataTable (дерево настроек Toro) */
+    density?: 'default' | 'compact';
+    /**
+     * Если задан, подменяет содержимое первой ячейки заголовка (например, заголовок + кнопка).
+     * Остальные колонки по-прежнему из `headers`. Не используется вместе с `headerCells`.
+     */
+    renderFirstColumnHeader?: ReactNode;
+}
+/**
+ * TreeView - компонент для отображения иерархических данных в табличном формате.
+ */
+export declare const TreeView: <T extends TreeNode>(props: TreeViewProps<T>) => import("react/jsx-runtime").JSX.Element;

package/dist/components/ui/widget-plan-fact.d.ts

@@ -0,0 +1,86 @@
+export type TimeBadgeVariant = 'default' | 'warning' | 'error' | 'success';
+interface TimeBadgeProps {
+    /** Дата и время в формате "DD.MM.YYYY HH:mm" */
+    dateTime?: string;
+    /** Длительность в формате "Xd : Yч : Zмин" */
+    duration?: string;
+    /** Вариант стиля бейджа */
+    variant?: TimeBadgeVariant;
+    /** Дополнительные CSS-классы */
+    className?: string;
+}
+/**
+ * Компонент для отображения даты/времени и длительности в виде бейджа.
+ * Поддерживает различные варианты стилей: default, warning (жёлтый), error (красный), success (зелёный).
+ *
+ * @component
+ * @param {TimeBadgeProps} props - Пропсы компонента
+ * @param {string} [props.dateTime] - Дата и время в формате "DD.MM.YYYY HH:mm"
+ * @param {string} [props.duration] - Длительность в формате "Xd : Yч : Zмин"
+ * @param {TimeBadgeVariant} [props.variant='default'] - Вариант стиля бейджа
+ * @param {string} [props.className] - Дополнительные CSS-классы
+ * @returns {JSX.Element}
+ *
+ * @example
+ * <TimeBadge
+ *   dateTime="01.12.2025 10:00"
+ *   duration="14д : 24ч : 20мин"
+ *   variant="error"
+ * />
+ */
+declare const TimeBadge: {
+    ({ dateTime, duration, variant, className }: TimeBadgeProps): import("react/jsx-runtime").JSX.Element | null;
+    displayName: string;
+};
+export interface PlanFactRow {
+    /** Метка для плана (например, "План начала") */
+    planLabel?: string;
+    /** Значение плана (например, "01.11.2025 10:00") */
+    planValue?: string;
+    /** Метка для факта (например, "Факт начала") */
+    factLabel?: string;
+    /** Значение факта (отображается через TimeBadge) */
+    factDateTime?: string;
+    factDuration?: string;
+    /** Вариант стиля для факта */
+    factVariant?: TimeBadgeVariant;
+    /** Расхождение (например, "Расхождение 30д : 2ч : 30мин") */
+    delta?: string;
+}
+interface WidgetPlanFactProps {
+    /** Массив строк с планом и фактом */
+    rows: PlanFactRow[];
+    /** Ориентация виджета: вертикальная (строки) или горизонтальная (колонки) */
+    orientation?: 'vertical' | 'horizontal';
+    /** Дополнительные CSS-классы для корневого элемента */
+    className?: string;
+}
+/**
+ * Виджет для отображения сравнения плановых и фактических значений.
+ * Отображает три секции (Начало, Окончание, Длительность) с планом и фактом.
+ *
+ * @component
+ * @param {WidgetPlanFactProps} props - Пропсы компонента
+ * @param {PlanFactRow[]} props.rows - Массив строк с планом и фактом
+ * @param {'vertical' | 'horizontal'} [props.orientation='vertical'] - Ориентация виджета
+ * @param {string} [props.className] - Дополнительные CSS-классы
+ * @returns {JSX.Element}
+ *
+ * @example
+ * <WidgetPlanFact
+ *   rows={[
+ *     {
+ *       planLabel: 'План начала',
+ *       planValue: '01.11.2025 10:00',
+ *       factLabel: 'Факт начала',
+ *       factDateTime: '01.12.2025 10:00',
+ *       delta: 'Расхождение 30д : 2ч : 30мин',
+ *     },
+ *   ]}
+ * />
+ */
+declare const WidgetPlanFact: {
+    ({ rows, orientation, className }: WidgetPlanFactProps): import("react/jsx-runtime").JSX.Element | null;
+    displayName: string;
+};
+export { TimeBadge, WidgetPlanFact };

package/dist/date.d.ts

@@ -0,0 +1,8 @@
+import { DateRange } from './main';
+export declare const toRuDateString: (date: Date | string) => string;
+export declare const formatSingleDateMask: (value: string) => string;
+export declare const formatMultipleDatesMask: (value: string) => string;
+export declare const formatRangeMask: (value: string) => string;
+export declare const parseDateString: (value: string) => Date | null;
+export declare const parseMultipleDatesString: (value: string) => Date[];
+export declare const parseRangeString: (value: string) => DateRange | null;

package/dist/hooks/useColumnFilters.d.ts

@@ -0,0 +1,6 @@
+import { ColumnFiltersState } from '@tanstack/react-table';
+export declare const useColumnFilters: () => {
+    state: ColumnFiltersState;
+    setState: import('react').Dispatch<import('react').SetStateAction<ColumnFiltersState>>;
+    get: <T = string>(id: string, filtersState?: ColumnFiltersState) => T | undefined;
+};

package/dist/hooks/useColumnSizing.d.ts

@@ -0,0 +1,20 @@
+import { ColumnSizingState, OnChangeFn } from '@tanstack/react-table';
+/**
+ * Хук для управления шириной столбцов таблицы с опциональной персистентностью в localStorage.
+ *
+ * @param storageKey - Уникальный ключ таблицы для хранения в localStorage.
+ *   Если не передан — состояние живёт только в рамках сессии (без сохранения).
+ * @param defaultSizing - Начальные размеры столбцов (используются если в localStorage ещё нет данных)
+ *
+ * @example
+ * // С сохранением в localStorage
+ * const { columnSizing, onColumnSizingChange } = useColumnSizing('orders-table');
+ *
+ * @example
+ * // Без сохранения (только в рамках сессии)
+ * const { columnSizing, onColumnSizingChange } = useColumnSizing(undefined);
+ */
+export declare function useColumnSizing(storageKey: string | undefined, defaultSizing?: ColumnSizingState): {
+    columnSizing: ColumnSizingState;
+    onColumnSizingChange: OnChangeFn<ColumnSizingState>;
+};

package/dist/hooks/useCombinedRefs.d.ts

@@ -0,0 +1 @@
+export declare const useCombinedRefs: (...refs: React.ForwardedRef<HTMLInputElement>[]) => (node: HTMLInputElement | null) => void;

package/dist/hooks/useConfirm.d.ts

@@ -0,0 +1,49 @@
+import { FC } from 'react';
+export type ConfirmType = 'theme-filled' | 'warning-filled' | 'fade-contrast-filled' | 'fade-contrast-outlined';
+export type InputComponent = FC<{
+    value: string;
+    onChange: (value: string) => void;
+}>;
+interface ConfirmState {
+    title: string;
+    description: string;
+    confirmText: string;
+    confirmType: ConfirmType;
+    confirmHidden: boolean;
+    cancelText: string;
+    cancelHidden: boolean;
+    input?: InputComponent;
+    inputValue: string;
+    inputPlaceholder: string;
+    inputRequiredLabel: string;
+    inputMaxLength?: number;
+    inputRequired?: boolean;
+    setInput: (inputValue: string) => void;
+    confirmed: boolean | null;
+    visible: boolean;
+    setVisible: (visible: boolean) => void;
+    show: (options: PromptOptions) => void;
+    hide: () => void;
+    confirm: (input?: string) => void;
+    cancel: () => void;
+}
+export interface PromptOptions {
+    title?: string;
+    description?: string;
+    confirmText?: string;
+    confirmType?: ConfirmType;
+    confirmHidden?: boolean;
+    cancelText?: string;
+    cancelHidden?: boolean;
+    input?: InputComponent;
+    inputPlaceholder?: string;
+    inputRequiredLabel?: string;
+    inputMaxLength?: number;
+    inputRequired?: boolean;
+}
+export declare const useConfirmStore: import('zustand').UseBoundStore<import('zustand').StoreApi<ConfirmState>>;
+export declare const useConfirm: () => {
+    confirm: (options: PromptOptions) => Promise<boolean | null>;
+    prompt: (options: PromptOptions) => Promise<string>;
+};
+export {};

package/dist/hooks/useNotify.d.ts

@@ -0,0 +1,28 @@
+interface ErrorsObj {
+    errors: {
+        [key: string]: string[];
+    };
+}
+export interface ErrorResponse {
+    error: string;
+    errors: string[] | ErrorsObj;
+    message: string;
+    detail: string;
+    path: string;
+    status: number;
+    timestamp: string;
+}
+export declare const getErrorData: (error: Error | Record<string, unknown>) => ErrorResponse | undefined;
+export declare const parseValueFromError: (key: string, error: string) => string;
+export type MessageFromServer = string;
+export type MessageForUser = string | ((errors?: string[]) => string);
+export declare const useNotify: (text?: string) => {
+    toast: typeof import('./useToast').toast;
+    notifyError: (text?: string, prefix?: string) => void;
+    onError: (error: Error | Record<string, unknown>) => void;
+    getErrorHandler: (errorMessageMap: Record<MessageFromServer, MessageForUser>) => (error: Error | Record<string, unknown>) => void;
+    getSuccessHandler: (text: string) => () => void;
+    notifySuccess: (text?: string) => void;
+    onSuccess: () => void;
+};
+export {};

package/dist/hooks/usePreviewsFilePicker.d.ts

@@ -0,0 +1,40 @@
+import { AttachmentItem, ContentType } from '../lib/attachments';
+export interface PreviewsFilePickerMaxSizes {
+    image?: number;
+    video?: number;
+    total?: number;
+    audio?: number;
+    pdf?: number;
+    word?: number;
+    excel?: number;
+    archive?: number;
+}
+export interface UsePreviewsFilePickerParams {
+    accepts?: ContentType[];
+    multiple?: boolean;
+    max?: number;
+    maxSizes?: PreviewsFilePickerMaxSizes;
+    withCompress?: boolean;
+    onAdd?: (files: File[]) => void;
+    handleFileLimit?: (filetype: ContentType) => void;
+    handleAllFilesLimit?: () => void;
+    /**
+     * Текущие вложения: для лимита max, подсчёта слотов и суммарного размера файлов с полем `file`.
+     */
+    attachmentData?: AttachmentItem[];
+}
+export interface UsePreviewsFilePickerResult {
+    inputRef: React.RefObject<HTMLInputElement>;
+    openPicker: () => void;
+    processing: boolean;
+    /** true, если нельзя открыть диалог (лимит файлов или идёт обработка) */
+    pickerDisabled: boolean;
+    acceptAttr: string;
+    multiple: boolean;
+    onFileInputChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
+}
+/**
+ * Логика выбора файлов как в Previews: лимиты по типам, общий размер, сжатие, onAdd.
+ * Скрытый input рендерит потребитель; триггер вызывает openPicker().
+ */
+export declare const usePreviewsFilePicker: (params: UsePreviewsFilePickerParams) => UsePreviewsFilePickerResult;

package/dist/hooks/useSidebar.d.ts

@@ -0,0 +1,10 @@
+import { ImperativePanelHandle } from 'react-resizable-panels';
+export declare const useSidebar: (collapsedLayout?: number[], expandedLayout?: number[]) => {
+    layoutName: string;
+    collapsedName: string;
+    defaultLayout: any;
+    isCollapsed: boolean;
+    ref: import('react').RefObject<ImperativePanelHandle>;
+    collapse: () => void;
+    expand: () => void;
+};

package/dist/hooks/useStoredExpand.d.ts

@@ -0,0 +1,18 @@
+import { Dispatch, SetStateAction } from 'react';
+export type ExpandState = Record<string | number, boolean>;
+export interface UseStoredExpandOptions {
+    storage?: 'localStorage' | 'sessionStorage';
+    defaultWhenMissing?: boolean;
+}
+/**
+ * Хук для хранения состояния раскрытия узлов (дерево, аккордеон) в sessionStorage или localStorage.
+ *
+ * @param storageKey - Ключ для хранения в storage
+ * @param options - Опции: storage ('sessionStorage' по умолчанию), defaultWhenMissing (true по умолчанию)
+ */
+export declare const useStoredExpand: (storageKey: string, options?: UseStoredExpandOptions) => {
+    expanded: ExpandState;
+    setExpanded: Dispatch<SetStateAction<ExpandState>>;
+    toggleNode: (id: string | number) => void;
+    isNodeExpanded: (id: string | number) => boolean;
+};

package/dist/hooks/useStoredFields.d.ts

@@ -0,0 +1,4 @@
+export declare const useStoredFields: (storageKey: string, defaultFields?: string[]) => {
+    fields: string[];
+    handleFieldsChange: (newFields: string[]) => void;
+};

package/dist/hooks/useStoredTabs.d.ts

@@ -0,0 +1,4 @@
+export declare const useStoredTabs: (defaultTab: string, storageKey: string) => {
+    tab: string;
+    handleTabChange: (newTab: string) => void;
+};

package/dist/hooks/useTableStates.d.ts

@@ -0,0 +1,26 @@
+import { ExpandedState, RowSelectionState, SortingState } from '@tanstack/react-table';
+interface IProps {
+    paginationInitialState?: {
+        pageIndex: number;
+        pageSize: number;
+    };
+    onSort?: (sort: string, sortType: 'asc' | 'desc') => void;
+    onPagination?: (pageIndex: number, pageSize: number) => void;
+}
+export declare const useTableStates: ({ paginationInitialState, onSort, onPagination, }?: IProps) => {
+    selection: RowSelectionState;
+    setSelection: import('react').Dispatch<import('react').SetStateAction<RowSelectionState>>;
+    sorting: SortingState;
+    setSorting: import('react').Dispatch<import('react').SetStateAction<SortingState>>;
+    pagination: {
+        pageIndex: number;
+        pageSize: number;
+    };
+    setPagination: import('react').Dispatch<import('react').SetStateAction<{
+        pageIndex: number;
+        pageSize: number;
+    }>>;
+    expanded: ExpandedState;
+    setExpanded: import('react').Dispatch<import('react').SetStateAction<ExpandedState>>;
+};
+export {};

package/dist/hooks/useTheme.d.ts

@@ -0,0 +1 @@
+export declare const useTheme: () => import('../main').ThemeProviderState;

package/dist/hooks/useToast.d.ts

@@ -0,0 +1,44 @@
+import { ToastActionElement, ToastProps } from '../components/ui/toast';
+import * as React from 'react';
+type ToasterToast = ToastProps & {
+    id: string;
+    title?: React.ReactNode;
+    description?: React.ReactNode;
+    action?: ToastActionElement;
+};
+declare const actionTypes: {
+    readonly ADD_TOAST: "ADD_TOAST";
+    readonly UPDATE_TOAST: "UPDATE_TOAST";
+    readonly DISMISS_TOAST: "DISMISS_TOAST";
+    readonly REMOVE_TOAST: "REMOVE_TOAST";
+};
+type ActionType = typeof actionTypes;
+type Action = {
+    type: ActionType['ADD_TOAST'];
+    toast: ToasterToast;
+} | {
+    type: ActionType['UPDATE_TOAST'];
+    toast: Partial<ToasterToast>;
+} | {
+    type: ActionType['DISMISS_TOAST'];
+    toastId?: ToasterToast['id'];
+} | {
+    type: ActionType['REMOVE_TOAST'];
+    toastId?: ToasterToast['id'];
+};
+interface State {
+    toasts: ToasterToast[];
+}
+export declare const reducer: (state: State, action: Action) => State;
+type Toast = Omit<ToasterToast, 'id'>;
+declare function toast({ ...props }: Toast): {
+    id: string;
+    dismiss: () => void;
+    update: (props: ToasterToast) => void;
+};
+declare function useToast(): {
+    toast: typeof toast;
+    dismiss: (toastId?: string) => void;
+    toasts: ToasterToast[];
+};
+export { useToast, toast };

package/dist/hooks/useTranslation.d.ts

@@ -0,0 +1,4 @@
+import { Translations } from '../components/ui/theme-provider';
+export declare const useTranslation: () => {
+    t: (key: Translations) => string;
+};

package/dist/krit-ui.d.ts

@@ -0,0 +1,2 @@
+export * from './main'
+export {}