skillgrid 0.0.69 → 0.0.70

package/dist/components/Popover/Popover.context.d.ts

@@ -0,0 +1,40 @@
+import { CSSProperties } from 'react';
+import { useFloating, useInteractions } from '@floating-ui/react';
+import { PopoverFloatingOptions } from './Popover.type';
+/**
+ * Значение контекста, через которое составные части `Popover` получают
+ * состояние открытия, refs, стили Floating UI и служебные идентификаторы.
+ */
+export interface PopoverContextValue {
+    open: boolean;
+    keepMounted: boolean;
+    disabled: boolean;
+    width?: CSSProperties['width'];
+    widthAsTarget: boolean;
+    targetWidth?: number;
+    contentId: string;
+    triggerId: string;
+    resolvedTriggerId: string;
+    floating: PopoverFloatingOptions;
+    refs: ReturnType<typeof useFloating>['refs'];
+    context: ReturnType<typeof useFloating>['context'];
+    floatingStyles: ReturnType<typeof useFloating>['floatingStyles'];
+    middlewareData: ReturnType<typeof useFloating>['middlewareData'];
+    isMounted: boolean;
+    transitionStyles: CSSProperties;
+    setAnchorNode: (node: HTMLElement | null) => void;
+    setResolvedTriggerId: (id: string) => void;
+    setTriggerDisabled: (disabled: boolean) => void;
+    hasCustomAnchor: boolean;
+    getReferenceProps: ReturnType<typeof useInteractions>['getReferenceProps'];
+    getFloatingProps: ReturnType<typeof useInteractions>['getFloatingProps'];
+}
+/**
+ * Внутренний контекст составного API `Popover`.
+ */
+export declare const PopoverContext: import('react').Context<PopoverContextValue | null>;
+/**
+ * Возвращает и валидирует контекст `Popover`.
+ * Бросает ошибку, если составной компонент использован вне `Popover.Root`.
+ */
+export declare const usePopoverContext: () => PopoverContextValue;

package/dist/components/Popover/Popover.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Составной компонент popover с вложенными частями `Root`, `Trigger`, `Anchor` и `Drop`.
+ */
+declare const Popover: (({ children, open, defaultOpen, onOpenChange, onDismiss, disabled, keepMounted, width, widthAsTarget, floating, }: import('./Popover.type').PopoverRootProps) => import("react/jsx-runtime").JSX.Element) & {
+    Root: ({ children, open, defaultOpen, onOpenChange, onDismiss, disabled, keepMounted, width, widthAsTarget, floating, }: import('./Popover.type').PopoverRootProps) => import("react/jsx-runtime").JSX.Element;
+    Trigger: ({ children, disabled }: import('./Popover.type').PopoverTriggerProps) => import('react').ReactElement<any, string | import('react').JSXElementConstructor<any>>;
+    Anchor: ({ children }: import('./Popover.type').PopoverAnchorProps) => import('react').ReactElement<import('react').HTMLAttributes<HTMLElement> & {
+        ref?: import('react').Ref<Element>;
+    }, string | import('react').JSXElementConstructor<any>>;
+    Drop: import('react').ForwardRefExoticComponent<import('./Popover.type').PopoverContentProps & import('react').RefAttributes<HTMLDivElement>>;
+    DropContent: import('react').ForwardRefExoticComponent<import('./Popover.type').PopoverDropContentProps & import('react').RefAttributes<HTMLDivElement>>;
+    DropHeader: import('react').ForwardRefExoticComponent<import('./Popover.type').PopoverSectionProps & import('react').RefAttributes<HTMLDivElement>>;
+    DropFooter: import('react').ForwardRefExoticComponent<import('./Popover.type').PopoverSectionProps & import('react').RefAttributes<HTMLDivElement>>;
+};
+export { Popover };

package/dist/components/Popover/Popover.type.d.ts

@@ -0,0 +1,129 @@
+import { autoUpdate, flip, FloatingFocusManager, FloatingOverlay, inline, Middleware, Placement, shift, size, Strategy, UseClickProps, UseDismissProps, UseFocusProps, UseHoverProps, UseRoleProps } from '@floating-ui/react';
+import { ComponentPropsWithoutRef, CSSProperties, HTMLAttributes, MutableRefObject, ReactElement, ReactNode } from 'react';
+export type PopoverDividerMode = 'visible' | 'hidden' | 'dynamic';
+/**
+ * Набор пресетов для middleware Floating UI, которые использует Popover.
+ */
+export interface PopoverMiddlewarePresets {
+    /** Включает или настраивает переворот относительно границ видимой области. */
+    flip?: boolean | Parameters<typeof flip>[0];
+    /** Включает или настраивает сдвиг внутри видимой области. */
+    shift?: boolean | Parameters<typeof shift>[0];
+    /** Включает inline-позиционирование для многострочных опорных элементов. */
+    inline?: boolean | Parameters<typeof inline>[0];
+    /** Включает или настраивает middleware для управления размером. */
+    size?: boolean | Parameters<typeof size>[0];
+}
+/**
+ * Конфигурация Floating UI для позиционирования, взаимодействий и портала Popover.
+ */
+export interface PopoverFloatingOptions {
+    /** Предпочтительное положение popover относительно trigger или anchor. */
+    placement?: Placement;
+    /** CSS-стратегия позиционирования, используемая Floating UI. */
+    strategy?: Strategy;
+    /** Полный кастомный список middleware. При передаче заменяет `middlewares`. */
+    middleware?: Middleware[];
+    /** Упрощённые пресеты для встроенной цепочки middleware. */
+    middlewares?: PopoverMiddlewarePresets;
+    /** Рендерит контент внутри React-портала, если установлено `true`. */
+    portal?: boolean;
+    /** Кастомный корневой элемент портала или ref на него. */
+    portalRoot?: HTMLElement | MutableRefObject<HTMLElement | null> | null;
+    /** Добавляет overlay вокруг floating-контента. */
+    overlay?: boolean | Omit<ComponentPropsWithoutRef<typeof FloatingOverlay>, 'children'>;
+    /** Включает управление фокусом внутри floating-контента. */
+    focusManager?: boolean | Omit<ComponentPropsWithoutRef<typeof FloatingFocusManager>, 'children' | 'context'>;
+    /** Включает взаимодействие по клику на trigger. */
+    click?: boolean | UseClickProps;
+    /** Включает взаимодействие по наведению на trigger. */
+    hover?: boolean | UseHoverProps;
+    /** Включает взаимодействие по фокусу на trigger. */
+    focus?: boolean | UseFocusProps;
+    /** Включает закрытие по клику снаружи и по клавише Escape. */
+    dismiss?: boolean | UseDismissProps;
+    /** Настраивает ARIA-role, которую применяет Floating UI. */
+    role?: boolean | UseRoleProps;
+    /** Скрывает popover, когда опорный элемент выходит из видимой области. */
+    hideDetached?: boolean;
+    /** Кастомный жизненный цикл автообновления для floating и опорного элементов. */
+    whileElementsMounted?: (...args: Parameters<typeof autoUpdate>) => ReturnType<typeof autoUpdate>;
+    /** Включает transform-based позиционирование во Floating UI. */
+    transform?: boolean;
+}
+/**
+ * Корневые пропсы, общие для составных компонентов Popover.
+ */
+export interface PopoverRootProps {
+    /** Составные дочерние элементы popover. */
+    children: ReactNode;
+    /** Управляемое состояние открытия. */
+    open?: boolean;
+    /** Начальное состояние открытия для неуправляемого режима. */
+    defaultOpen?: boolean;
+    /** Вызывается при каждом изменении состояния открытия. */
+    onOpenChange?: (open: boolean) => void;
+    /** Вызывается, когда popover закрывается из-за dismiss-взаимодействий. */
+    onDismiss?: () => void;
+    /** Отключает открытие и взаимодействия для всего popover. */
+    disabled?: boolean;
+    /** Сохраняет контент в DOM, когда popover закрыт. */
+    keepMounted?: boolean;
+    /** Ширина drop по умолчанию. Может быть переопределена на `Popover.Drop`. */
+    width?: CSSProperties['width'];
+    /** По умолчанию делает ширину контента равной ширине trigger или anchor. */
+    widthAsTarget?: boolean;
+    /** Конфигурация Floating UI для позиционирования и взаимодействий. */
+    floating?: PopoverFloatingOptions;
+}
+/**
+ * Пропсы элемента, который открывает и закрывает popover.
+ */
+export interface PopoverTriggerProps {
+    /** Единственный дочерний элемент, который получает props и ref trigger-а. */
+    children: ReactElement;
+    /** Отключает trigger-элемент. */
+    disabled?: boolean;
+}
+/**
+ * Пропсы опционального элемента, который используется как опорный элемент для позиционирования.
+ */
+export interface PopoverAnchorProps {
+    /** Единственный дочерний элемент, который получает ref anchor-а. */
+    children: ReactElement;
+}
+/**
+ * Пропсы плавающего контейнера `Popover.Drop`.
+ */
+export interface PopoverContentProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * Составной контент панели popover.
+     * Поддерживает опциональные `Popover.DropHeader` и `Popover.DropFooter`,
+     * а также обязательный `Popover.DropContent`.
+     * Структура проверяется во время выполнения, поэтому здесь допускается
+     * условный JSX вроде `condition && <Popover.DropFooter />`.
+     */
+    children: ReactNode;
+    /** Явно заданная ширина контента. Переопределяет `Popover.Root width`. */
+    width?: CSSProperties['width'];
+    /** Делает ширину этого `Popover.Drop` равной ширине trigger или anchor. */
+    widthAsTarget?: boolean;
+}
+/**
+ * Пропсы обязательной прокручиваемой области контента внутри `Popover.Drop`.
+ */
+export interface PopoverDropContentProps extends HTMLAttributes<HTMLDivElement> {
+    /** Обязательный контент, который рендерится в основной области popover. */
+    children?: ReactNode;
+}
+/**
+ * Общие пропсы для секций header и footer внутри `Popover.Drop`.
+ */
+export interface PopoverSectionProps extends HTMLAttributes<HTMLDivElement> {
+    /** Контент секции. */
+    children?: ReactNode;
+    /** Режим видимости разделителя у края секции. */
+    divider?: PopoverDividerMode;
+    /** Внутренний маркер разделителя, который прокидывается в DOM-узел. */
+    'data-divider-mode'?: PopoverDividerMode;
+}

package/dist/components/Popover/components/PopoverAnchor.d.ts

@@ -0,0 +1,14 @@
+import { HTMLAttributes, ReactElement, Ref } from 'react';
+import { PopoverAnchorProps } from '../Popover.type';
+/**
+ * Пропсы, которые `Popover.Anchor` использует у дочернего элемента для проброса ref.
+ */
+type AnchorChildProps = HTMLAttributes<HTMLElement> & {
+    ref?: Ref<Element>;
+};
+/**
+ * Опциональная опорная точка позиционирования popover.
+ * Позволяет отвязать геометрию floating-элемента от trigger-компонента.
+ */
+declare const PopoverAnchor: ({ children }: PopoverAnchorProps) => ReactElement<AnchorChildProps, string | import('react').JSXElementConstructor<any>>;
+export { PopoverAnchor };

package/dist/components/Popover/components/PopoverContentDivider.d.ts

@@ -0,0 +1,14 @@
+import { PopoverDividerMode } from '../Popover.type';
+/**
+ * Пропсы декоративного разделителя между секциями popover.
+ */
+interface PopoverContentDividerProps {
+    mode: PopoverDividerMode;
+    isVisible: boolean;
+    testId: string;
+}
+/**
+ * Визуальный разделитель между header/body/footer у `Popover.Drop`.
+ */
+declare const PopoverContentDivider: ({ mode, isVisible, testId }: PopoverContentDividerProps) => import("react/jsx-runtime").JSX.Element;
+export { PopoverContentDivider };

package/dist/components/Popover/components/PopoverDrop.d.ts

@@ -0,0 +1,7 @@
+import { PopoverContentProps } from '../Popover.type';
+/**
+ * Плавающая панель `Popover`, которая рендерит секции, контент,
+ * портал, overlay и focus manager поверх состояния из `Popover.Root`.
+ */
+declare const PopoverDrop: import('react').ForwardRefExoticComponent<PopoverContentProps & import('react').RefAttributes<HTMLDivElement>>;
+export { PopoverDrop };

package/dist/components/Popover/components/PopoverDropContent.d.ts

@@ -0,0 +1,7 @@
+import { PopoverDropContentProps } from '../Popover.type';
+/**
+ * Обязательная прокручиваемая область внутри `Popover.Drop`.
+ * Хранит собственный `ref`, чтобы потребитель мог получить доступ к body-контейнеру.
+ */
+declare const PopoverDropContent: import('react').ForwardRefExoticComponent<PopoverDropContentProps & import('react').RefAttributes<HTMLDivElement>>;
+export { PopoverDropContent };

package/dist/components/Popover/components/PopoverFooter.d.ts

@@ -0,0 +1,7 @@
+import { PopoverSectionProps } from '../Popover.type';
+/**
+ * Нижняя секция `Popover.Drop`.
+ * Используется как именованный слот и поддерживает режим разделителя.
+ */
+declare const PopoverFooter: import('react').ForwardRefExoticComponent<PopoverSectionProps & import('react').RefAttributes<HTMLDivElement>>;
+export { PopoverFooter };

package/dist/components/Popover/components/PopoverHeader.d.ts

@@ -0,0 +1,7 @@
+import { PopoverSectionProps } from '../Popover.type';
+/**
+ * Верхняя секция `Popover.Drop`.
+ * Используется как именованный слот и поддерживает режим разделителя.
+ */
+declare const PopoverHeader: import('react').ForwardRefExoticComponent<PopoverSectionProps & import('react').RefAttributes<HTMLDivElement>>;
+export { PopoverHeader };

package/dist/components/Popover/components/PopoverRoot.d.ts

@@ -0,0 +1,7 @@
+import { PopoverRootProps } from '../Popover.type';
+/**
+ * Корневой контейнер popover, который поднимает общее состояние
+ * и раздаёт его составным подкомпонентам через контекст.
+ */
+declare const PopoverRoot: ({ children, open, defaultOpen, onOpenChange, onDismiss, disabled, keepMounted, width, widthAsTarget, floating, }: PopoverRootProps) => import("react/jsx-runtime").JSX.Element;
+export { PopoverRoot };

package/dist/components/Popover/components/PopoverTrigger.d.ts

@@ -0,0 +1,8 @@
+import { ReactElement } from 'react';
+import { PopoverTriggerProps } from '../Popover.type';
+/**
+ * Триггер popover.
+ * Клонирует единственного ребёнка, добавляет ARIA-атрибуты, обработчики Floating UI и ref.
+ */
+declare const PopoverTrigger: ({ children, disabled }: PopoverTriggerProps) => ReactElement<any, string | import('react').JSXElementConstructor<any>>;
+export { PopoverTrigger };

package/dist/components/Popover/index.d.ts

@@ -0,0 +1,2 @@
+export * from './Popover';
+export * from './Popover.type';

package/dist/components/Popover/lib/index.d.ts

@@ -0,0 +1 @@
+export { usePopover } from './use-popover';

package/dist/components/Popover/lib/use-popover.d.ts

@@ -0,0 +1,78 @@
+import { autoUpdate, Middleware, Placement } from '@floating-ui/react';
+import { PopoverRootProps } from '../Popover.type';
+/**
+ * Внутреннее подмножество пропсов `Popover.Root`, которое использует хук состояния и позиционирования.
+ */
+type UsePopoverOptions = Pick<PopoverRootProps, 'defaultOpen' | 'disabled' | 'floating' | 'onDismiss' | 'onOpenChange' | 'open' | 'width' | 'widthAsTarget'>;
+/**
+ * Центральный контроллер popover поверх Floating UI.
+ * Он инкапсулирует:
+ * - controlled/uncontrolled состояние открытия
+ * - сборку middleware и позиционирование
+ * - взаимодействия: click, hover, focus, dismiss, role
+ * - синхронизацию ширины target для `widthAsTarget`
+ * - стили переходов и идентификаторы для составных подкомпонентов
+ */
+export declare function usePopover({ open: controlledOpen, defaultOpen, onOpenChange, onDismiss, disabled, width, widthAsTarget, floating, }: UsePopoverOptions): {
+    open: boolean;
+    disabled: boolean;
+    width: import("csstype").Property.Width<string | number> | undefined;
+    widthAsTarget: boolean;
+    targetWidth: number | undefined;
+    contentId: string;
+    triggerId: string;
+    resolvedTriggerId: string;
+    floating: {
+        placement?: Placement;
+        strategy?: import('@floating-ui/utils').Strategy;
+        middleware?: Middleware[];
+        middlewares?: import('..').PopoverMiddlewarePresets;
+        portal?: boolean;
+        portalRoot?: HTMLElement | import('react').MutableRefObject<HTMLElement | null> | null;
+        overlay?: boolean | Omit<import('react').ComponentPropsWithoutRef<typeof import('@floating-ui/react').FloatingOverlay>, "children">;
+        focusManager?: boolean | Omit<import('react').ComponentPropsWithoutRef<typeof import('@floating-ui/react').FloatingFocusManager>, "children" | "context">;
+        click?: boolean | import('@floating-ui/react').UseClickProps;
+        hover?: boolean | import('@floating-ui/react').UseHoverProps;
+        focus?: boolean | import('@floating-ui/react').UseFocusProps;
+        dismiss?: boolean | import('@floating-ui/react').UseDismissProps;
+        role?: boolean | import('@floating-ui/react').UseRoleProps;
+        hideDetached?: boolean;
+        whileElementsMounted?: (...args: Parameters<typeof autoUpdate>) => ReturnType<typeof autoUpdate>;
+        transform?: boolean;
+    };
+    refs: {
+        reference: import('react').MutableRefObject<import('@floating-ui/react-dom').ReferenceType | null>;
+        floating: React.MutableRefObject<HTMLElement | null>;
+        setReference: (node: import('@floating-ui/react-dom').ReferenceType | null) => void;
+        setFloating: (node: HTMLElement | null) => void;
+    } & import('@floating-ui/react').ExtendedRefs<import('@floating-ui/react').ReferenceType>;
+    context: {
+        x: number;
+        y: number;
+        placement: Placement;
+        strategy: import('@floating-ui/utils').Strategy;
+        middlewareData: import('@floating-ui/core').MiddlewareData;
+        isPositioned: boolean;
+        update: () => void;
+        floatingStyles: React.CSSProperties;
+        open: boolean;
+        onOpenChange: (open: boolean, event?: Event, reason?: import('@floating-ui/react').OpenChangeReason) => void;
+        events: import('@floating-ui/react').FloatingEvents;
+        dataRef: React.MutableRefObject<import('@floating-ui/react').ContextData>;
+        nodeId: string | undefined;
+        floatingId: string | undefined;
+        refs: import('@floating-ui/react').ExtendedRefs<import('@floating-ui/react').ReferenceType>;
+        elements: import('@floating-ui/react').ExtendedElements<import('@floating-ui/react').ReferenceType>;
+    };
+    floatingStyles: import('react').CSSProperties;
+    middlewareData: import('@floating-ui/core').MiddlewareData;
+    hasCustomAnchor: boolean;
+    isMounted: boolean;
+    transitionStyles: import('react').CSSProperties;
+    setAnchorNode: import('react').Dispatch<import('react').SetStateAction<HTMLElement | null>>;
+    setResolvedTriggerId: import('react').Dispatch<import('react').SetStateAction<string>>;
+    setTriggerDisabled: import('react').Dispatch<import('react').SetStateAction<boolean>>;
+    getReferenceProps: (userProps?: React.HTMLProps<Element>) => Record<string, unknown>;
+    getFloatingProps: (userProps?: React.HTMLProps<HTMLElement>) => Record<string, unknown>;
+};
+export {};

package/dist/components/Popover/lib/utils.d.ts

@@ -0,0 +1,87 @@
+import { MutableRefObject, ReactElement, ReactNode, Ref } from 'react';
+import { PopoverDropContentProps, PopoverFloatingOptions, PopoverSectionProps } from '../Popover.type';
+/**
+ * Именованные слоты, которые поддерживает `Popover.Drop`.
+ */
+export type PopoverSlotName = 'content' | 'header' | 'footer';
+/**
+ * Служебный маркер, по которому составные подкомпоненты сообщают свой слот.
+ */
+export type PopoverSlotComponent = {
+    __popoverSlot?: PopoverSlotName;
+};
+/**
+ * Нормализованное представление дочерних элементов `Popover.Drop` после разбора слотов.
+ */
+export interface ParsedPopoverChildren {
+    contentElement: ReactElement<PopoverDropContentProps> | null;
+    headerElement: ReactElement<PopoverSectionProps> | null;
+    footerElement: ReactElement<PopoverSectionProps> | null;
+    hasUnexpectedChildren: boolean;
+}
+/**
+ * Результат проверки структуры `Popover.Drop`.
+ * Используется для безопасного fallback-рендера вместо выброса исключения в runtime.
+ */
+export interface PopoverDropValidationIssue {
+    message: string;
+    developerHint?: string;
+}
+/**
+ * Значения Floating UI по умолчанию, если потребитель не передал свои настройки.
+ */
+export declare const DEFAULT_FLOATING: PopoverFloatingOptions;
+/**
+ * Сужает тип portal root до mutable ref, чтобы потом одинаково его разрешать.
+ */
+export declare const isMutableRefObject: (value: PopoverFloatingOptions["portalRoot"]) => value is MutableRefObject<HTMLElement | null>;
+/**
+ * Преобразует либо HTMLElement, либо ref-объект в реальный корневой DOM-узел портала.
+ */
+export declare const resolvePortalRoot: (portalRoot: PopoverFloatingOptions["portalRoot"]) => HTMLElement | null | undefined;
+/**
+ * Записывает значение либо в callback ref, либо в object ref.
+ */
+export declare const assignRef: <T>(ref: Ref<T | null> | undefined, value: T | null) => void;
+/**
+ * Объединяет несколько ref в один callback ref.
+ */
+export declare const mergeRefs: <T>(...refs: Array<Ref<T | null> | undefined>) => (value: T | null) => void;
+/**
+ * Проверяет, содержит ли список middleware элемент с указанным именем Floating UI.
+ */
+export declare const hasMiddleware: (middleware: PopoverFloatingOptions["middleware"], name: string) => boolean;
+/**
+ * Читает внутренний маркер слота из составного дочернего элемента.
+ */
+export declare const getSlotName: (element: ReactElement) => PopoverSlotName | null;
+export declare const POPOVER_DROP_STRUCTURE_HINT = "\u041E\u0448\u0438\u0431\u043A\u0430 \u0432 \u0441\u0442\u0440\u0443\u043A\u0442\u0443\u0440\u0435 Popover.Drop:\n\n<Popover.Drop>\n  <Popover.DropHeader>{...}</Popover.DropHeader> // \u043E\u043F\u0446\u0438\u043E\u043D\u0430\u043B\u044C\u043D\u044B\u0439 \u0445\u044D\u0434\u0435\u0440 \n  <Popover.DropContent>{...}</Popover.DropContent> // \u043E\u0431\u044F\u0437\u0430\u0442\u0435\u043B\u044C\u043D\u044B\u0439 \u043A\u043E\u043D\u0442\u0435\u043D\u0442\n  <Popover.DropFooter>{...}</Popover.DropFooter> // \u043E\u043F\u0446\u0438\u043E\u043D\u0430\u043B\u044C\u043D\u044B\u0439 \u0444\u0443\u0442\u0435\u0440\n</Popover.Drop>\n";
+/**
+ * Логирует ошибку структуры `Popover.Drop` только в dev-режиме,
+ * чтобы библиотека не показывала внутреннюю диагностику конечным пользователям.
+ */
+export declare const reportPopoverDropValidationIssue: (issue: PopoverDropValidationIssue | null) => void;
+/**
+ * Разбирает прямых детей `Popover.Drop` по именованным слотам.
+ * Неизвестные элементы, дубликаты слотов и непустые примитивные узлы помечаются как невалидные,
+ * чтобы вызывающий код мог выбросить понятную ошибку для разработчика.
+ */
+export declare const parsePopoverChildren: (children: ReactNode) => ParsedPopoverChildren;
+/**
+ * Клонирует slot header или footer и добавляет к нему общие стили секции popover.
+ */
+export declare const renderSection: (sectionElement: ReactElement<PopoverSectionProps> | null, sectionClassName: string) => ReactElement<PopoverSectionProps, string | import('react').JSXElementConstructor<any>> | null;
+/**
+ * Возвращает обязательный content-слот как есть, чтобы сохранить исходный элемент и его ref.
+ */
+export declare const renderBodyContent: (contentElement: ReactElement<PopoverDropContentProps> | null) => ReactElement<PopoverDropContentProps, string | import('react').JSXElementConstructor<any>> | null;
+/**
+ * Проверяет контракт составного API `Popover.Drop`.
+ * Вместо выброса исключения возвращает описание ошибки для безопасного fallback-рендера.
+ */
+export declare const getParsedPopoverChildrenValidationIssue: (parsedChildren: ParsedPopoverChildren) => PopoverDropValidationIssue | null;
+/**
+ * Проверяет, что `Popover.Trigger` и `Popover.Anchor` получают ровно одного клонируемого ребёнка.
+ * В production проверка остаётся минимальной, а в dev-режиме становится строже.
+ */
+export declare const validatePopoverCompoundChild: (componentName: "Popover.Trigger" | "Popover.Anchor", children: ReactNode) => children is ReactElement;

package/dist/hooks/index.d.ts

@@ -1,3 +1,4 @@
 export { useCustomTranslations } from './useCustomTranslations';
 export { useBackgroundColor } from './useBackgroundColor';
 export { useIsMobile } from './useIsMobile';
+export { useCompatId } from './useCompatId';

package/dist/hooks/useCompatId.d.ts

@@ -0,0 +1,7 @@
+/**
+ * React 17-compatible replacement for `useId`.
+ *
+ * Uses the built-in hook when it is available and falls back to a stable
+ * incremental id otherwise.
+ */
+export declare const useCompatId: (prefix?: string) => string;