@sfperusacdev/sf-ui 0.1.11

package/dist/types/src/components/layout/useFormWizard.d.ts

@@ -0,0 +1,40 @@
+import { ReactNode } from 'react';
+import { ButtonVariant } from '../buttons/buttonClassName';
+import { StepperVariant } from '../dashboard/Stepper';
+export type FormWizardStep = {
+    key: string;
+    label: string;
+    sublabel?: string;
+    content: ReactNode;
+    validate?: () => boolean | Promise<boolean>;
+};
+export type FormWizardFooterVariant = "default" | "brand";
+export type UseFormWizardOptions = {
+    steps: FormWizardStep[];
+    activeKey?: string;
+    defaultActiveKey?: string;
+    onActiveKeyChange?: (key: string) => void;
+    onFinish?: () => void;
+    nextLabel?: string;
+    prevLabel?: string;
+    finishLabel?: string;
+    showStepProgress?: boolean;
+    stepperVariant?: StepperVariant;
+    footerVariant?: FormWizardFooterVariant;
+    /** Oculta «Atrás» en el primer paso (mockup transporte). */
+    hidePrevOnFirst?: boolean;
+    nextIcon?: ReactNode;
+    primaryVariant?: ButtonVariant;
+    orientation?: "horizontal" | "vertical";
+};
+export type FormWizardShell = {
+    activeKey: string;
+    activeIndex: number;
+    stepper: ReactNode;
+    content: ReactNode;
+    footer: ReactNode;
+    isFirst: boolean;
+    isLast: boolean;
+    goToStep: (direction: "next" | "prev") => Promise<void>;
+};
+export declare const useFormWizard: ({ steps, activeKey: controlledActiveKey, defaultActiveKey, onActiveKeyChange, onFinish, nextLabel, prevLabel, finishLabel, showStepProgress, stepperVariant, footerVariant, hidePrevOnFirst, nextIcon, primaryVariant, orientation, }: UseFormWizardOptions) => FormWizardShell;

package/dist/types/src/components/maps/base/MapFrame.d.ts

@@ -0,0 +1,8 @@
+import { ReactNode } from 'react';
+export type MapFrameProps = {
+    title?: string;
+    description?: string;
+    className?: string;
+    children: ReactNode;
+};
+export declare const MapFrame: ({ title, description, className, children }: MapFrameProps) => import("react").JSX.Element;

package/dist/types/src/components/maps/base/MapStatus.d.ts

@@ -0,0 +1,5 @@
+export type MapStatusProps = {
+    tone?: "info" | "warning" | "error";
+    children: string;
+};
+export declare const MapStatus: ({ tone, children }: MapStatusProps) => import("react").JSX.Element;

package/dist/types/src/components/maps/base/index.d.ts

@@ -0,0 +1,4 @@
+export { MapFrame } from './MapFrame';
+export type { MapFrameProps } from './MapFrame';
+export { MapStatus } from './MapStatus';
+export type { MapStatusProps } from './MapStatus';

package/dist/types/src/components/maps/forms/AddressSearchInput.d.ts

@@ -0,0 +1,16 @@
+import { FieldValues, Path, UseFormReturn } from 'react-hook-form';
+import { SfPlace } from '../../../types/maps';
+export type AddressSearchInputProps<TFormValues extends FieldValues> = {
+    form: UseFormReturn<TFormValues>;
+    name: Path<TFormValues>;
+    label?: string;
+    info?: string;
+    required?: boolean;
+    placeholder?: string;
+    readOnly?: boolean;
+    disabled?: boolean;
+    className?: string;
+    onChange?: (value: SfPlace | null) => void;
+    onRefresh?: () => Promise<void> | void;
+};
+export declare const AddressSearchInput: <TFormValues extends FieldValues>({ form, name, label, info, required, placeholder, readOnly, disabled, className, onChange, onRefresh, }: AddressSearchInputProps<TFormValues>) => import("react").JSX.Element;

package/dist/types/src/components/maps/forms/AreaInput.d.ts

@@ -0,0 +1,7 @@
+import { FieldValues } from 'react-hook-form';
+import { ShapeInputProps } from './ShapeInput';
+import { SfLatLng } from '../../../types/maps';
+export type AreaInputProps<TFormValues extends FieldValues> = Omit<ShapeInputProps<TFormValues>, "mode"> & {
+    onChange?: (value: SfLatLng[]) => void;
+};
+export declare const AreaInput: <TFormValues extends FieldValues>(props: AreaInputProps<TFormValues>) => import("react").JSX.Element;

package/dist/types/src/components/maps/forms/CoordinatesInput.d.ts

@@ -0,0 +1,6 @@
+import { FieldValues } from 'react-hook-form';
+import { LocationPickerProps } from './LocationPicker';
+import { SfLatLng } from '../../../types/maps';
+export type CoordinatesInputProps<TFormValues extends FieldValues> = LocationPickerProps<TFormValues>;
+export declare const CoordinatesInput: <TFormValues extends FieldValues>(props: CoordinatesInputProps<TFormValues>) => import("react").JSX.Element;
+export type CoordinatesValue = SfLatLng;

package/dist/types/src/components/maps/forms/LocationPicker.d.ts

@@ -0,0 +1,16 @@
+import { FieldValues, Path, UseFormReturn } from 'react-hook-form';
+import { SfLatLng } from '../../../types/maps';
+export type LocationPickerProps<TFormValues extends FieldValues> = {
+    form: UseFormReturn<TFormValues>;
+    name: Path<TFormValues>;
+    label?: string;
+    info?: string;
+    required?: boolean;
+    zoom?: number;
+    readOnly?: boolean;
+    disabled?: boolean;
+    className?: string;
+    onChange?: (value: SfLatLng) => void;
+    onRefresh?: () => Promise<void> | void;
+};
+export declare const LocationPicker: <TFormValues extends FieldValues>({ form, name, label, info, required, zoom, readOnly, disabled, className, onChange, onRefresh, }: LocationPickerProps<TFormValues>) => import("react").JSX.Element;

package/dist/types/src/components/maps/forms/LocationPicker.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/maps/forms/RouteInput.d.ts

@@ -0,0 +1,7 @@
+import { FieldValues } from 'react-hook-form';
+import { ShapeInputProps } from './ShapeInput';
+import { SfLatLng } from '../../../types/maps';
+export type RouteInputProps<TFormValues extends FieldValues> = Omit<ShapeInputProps<TFormValues>, "mode"> & {
+    onChange?: (value: SfLatLng[]) => void;
+};
+export declare const RouteInput: <TFormValues extends FieldValues>(props: RouteInputProps<TFormValues>) => import("react").JSX.Element;

package/dist/types/src/components/maps/forms/ShapeInput.d.ts

@@ -0,0 +1,19 @@
+import { FieldValues, Path, UseFormReturn } from 'react-hook-form';
+import { SfLatLng } from '../../../types/maps';
+type ShapeInputMode = "area" | "route";
+export type ShapeInputProps<TFormValues extends FieldValues> = {
+    form: UseFormReturn<TFormValues>;
+    name: Path<TFormValues>;
+    mode: ShapeInputMode;
+    label?: string;
+    info?: string;
+    required?: boolean;
+    zoom?: number;
+    readOnly?: boolean;
+    disabled?: boolean;
+    className?: string;
+    onChange?: (value: SfLatLng[]) => void;
+    onRefresh?: () => Promise<void> | void;
+};
+export declare const ShapeInput: <TFormValues extends FieldValues>({ form, name, mode, label, info, required, zoom, readOnly, disabled, className, onChange, onRefresh, }: ShapeInputProps<TFormValues>) => import("react").JSX.Element;
+export {};

package/dist/types/src/components/maps/forms/ShapeInput.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/maps/forms/SmartMapInput.d.ts

@@ -0,0 +1,39 @@
+import { FieldValues, Path, UseFormReturn } from 'react-hook-form';
+import { SfLatLng, SfPlace } from '../../../types/maps';
+type SmartMapBaseProps<TFormValues extends FieldValues> = {
+    form: UseFormReturn<TFormValues>;
+    name: Path<TFormValues>;
+    label?: string;
+    info?: string;
+    required?: boolean;
+    readOnly?: boolean;
+    disabled?: boolean;
+    className?: string;
+    onRefresh?: () => Promise<void> | void;
+};
+type SmartMapCoordinatesProps<TFormValues extends FieldValues> = SmartMapBaseProps<TFormValues> & {
+    kind: "coordinates";
+    zoom?: number;
+    onChange?: (value: SfLatLng) => void;
+};
+type SmartMapLocationProps<TFormValues extends FieldValues> = SmartMapBaseProps<TFormValues> & {
+    kind: "location";
+    zoom?: number;
+    onChange?: (value: SfLatLng) => void;
+};
+type SmartMapAddressProps<TFormValues extends FieldValues> = SmartMapBaseProps<TFormValues> & {
+    kind: "address";
+    placeholder?: string;
+    onChange?: (value: SfPlace | null) => void;
+};
+type SmartMapAreaProps<TFormValues extends FieldValues> = SmartMapBaseProps<TFormValues> & {
+    kind: "area";
+    onChange?: (value: SfLatLng[]) => void;
+};
+type SmartMapRouteProps<TFormValues extends FieldValues> = SmartMapBaseProps<TFormValues> & {
+    kind: "route";
+    onChange?: (value: SfLatLng[]) => void;
+};
+export type SmartMapInputProps<TFormValues extends FieldValues> = SmartMapCoordinatesProps<TFormValues> | SmartMapLocationProps<TFormValues> | SmartMapAddressProps<TFormValues> | SmartMapAreaProps<TFormValues> | SmartMapRouteProps<TFormValues>;
+export declare const SmartMapInput: <TFormValues extends FieldValues>(props: SmartMapInputProps<TFormValues>) => import("react").JSX.Element | null;
+export {};

package/dist/types/src/components/maps/forms/SmartMapInput.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/maps/forms/index.d.ts

@@ -0,0 +1,12 @@
+export { AddressSearchInput } from './AddressSearchInput';
+export type { AddressSearchInputProps } from './AddressSearchInput';
+export { CoordinatesInput } from './CoordinatesInput';
+export type { CoordinatesInputProps, CoordinatesValue } from './CoordinatesInput';
+export { AreaInput } from './AreaInput';
+export type { AreaInputProps } from './AreaInput';
+export { LocationPicker } from './LocationPicker';
+export type { LocationPickerProps } from './LocationPicker';
+export { RouteInput } from './RouteInput';
+export type { RouteInputProps } from './RouteInput';
+export { SmartMapInput } from './SmartMapInput';
+export type { SmartMapInputProps } from './SmartMapInput';

package/dist/types/src/components/maps/index.d.ts

@@ -0,0 +1,3 @@
+export * from './base';
+export * from './forms';
+export * from './views';

package/dist/types/src/components/maps/renderers/google/GoogleMapRenderer.d.ts

@@ -0,0 +1,6 @@
+import { SfGoogleMapsEngineConfig, SfMapRendererProps } from '../../../../types/maps';
+type GoogleMapRendererProps = SfMapRendererProps & {
+    config?: SfGoogleMapsEngineConfig;
+};
+export declare const GoogleMapRenderer: ({ config, center, zoom, markers, routes, areas, height, className, readOnly, onClick, onMarkerClick, onMarkerDoubleClick, onMarkerDrag, onMarkerDragEnd, }: GoogleMapRendererProps) => import("react").JSX.Element;
+export {};

package/dist/types/src/components/maps/renderers/google/index.d.ts

@@ -0,0 +1 @@
+export { GoogleMapRenderer } from './GoogleMapRenderer';

package/dist/types/src/components/maps/renderers/index.d.ts

@@ -0,0 +1,2 @@
+export * from './google';
+export * from './leaflet';

package/dist/types/src/components/maps/renderers/leaflet/LeafletMapRenderer.d.ts

@@ -0,0 +1,7 @@
+import { SfMapRendererProps } from '../../../../types/maps';
+type LeafletMapRendererProps = SfMapRendererProps & {
+    tileUrl?: string;
+    attribution?: string;
+};
+export declare const LeafletMapRenderer: ({ center, zoom, markers, routes, areas, height, className, readOnly, tileUrl, attribution, onClick, onMarkerClick, onMarkerDoubleClick, onMarkerDrag, onMarkerDragEnd, }: LeafletMapRendererProps) => import("react").JSX.Element;
+export {};

package/dist/types/src/components/maps/renderers/leaflet/index.d.ts

@@ -0,0 +1 @@
+export { LeafletMapRenderer } from './LeafletMapRenderer';

package/dist/types/src/components/maps/views/MapView.d.ts

@@ -0,0 +1,9 @@
+import { SfMapMarker, SfMapRendererProps, SfMapShape } from '../../../types/maps';
+export type MapViewProps = Omit<SfMapRendererProps, "markers"> & {
+    title?: string;
+    description?: string;
+    markers?: SfMapMarker[];
+    routes?: SfMapShape[];
+    areas?: SfMapShape[];
+};
+export declare const MapView: ({ title, description, center, zoom, markers, routes, areas, height, className, readOnly, onClick, onMarkerClick, onMarkerDoubleClick, onMarkerDrag, onMarkerDragEnd, }: MapViewProps) => import("react").JSX.Element;

package/dist/types/src/components/maps/views/index.d.ts

@@ -0,0 +1,2 @@
+export { MapView } from './MapView';
+export type { MapViewProps } from './MapView';

package/dist/types/src/components/media-inputs/FileDropInput.d.ts

@@ -0,0 +1,21 @@
+import { FieldValues, Path, UseFormReturn } from 'react-hook-form';
+type FileDropInputProps<TFormValues extends FieldValues> = {
+    form: UseFormReturn<TFormValues>;
+    name: Path<TFormValues>;
+    label?: string;
+    info?: string;
+    required?: boolean;
+    accept?: string;
+    multiple?: boolean;
+    maxSizeMb?: number;
+    dropLabel?: string;
+    readOnly?: boolean;
+    disabled?: boolean;
+    small?: boolean;
+    className?: string;
+    onChange?: (files: File[]) => void;
+    onUpload?: (file: File, reportProgress: (percent: number) => void) => Promise<void>;
+    onRefresh?: () => Promise<void> | void;
+};
+export declare const FileDropInput: <TFormValues extends FieldValues>({ form, name, label, info, required, accept, multiple, maxSizeMb, dropLabel, readOnly, disabled, small, className, onChange, onUpload, onRefresh, }: FileDropInputProps<TFormValues>) => import("react").JSX.Element;
+export type { FileDropInputProps };

package/dist/types/src/components/media-inputs/MultiPhotoInput.d.ts

@@ -0,0 +1,20 @@
+import { FieldValues, Path, UseFormReturn } from 'react-hook-form';
+import { PhotoItem } from './types';
+type MultiPhotoInputProps<TFormValues extends FieldValues> = {
+    form: UseFormReturn<TFormValues>;
+    name: Path<TFormValues>;
+    label?: string;
+    info?: string;
+    required?: boolean;
+    max?: number;
+    maxSizeMb?: number;
+    camera?: boolean;
+    readOnly?: boolean;
+    disabled?: boolean;
+    small?: boolean;
+    className?: string;
+    onChange?: (photos: PhotoItem[]) => void;
+    onRefresh?: () => Promise<void> | void;
+};
+export declare const MultiPhotoInput: <TFormValues extends FieldValues>({ form, name, label, info, required, max, maxSizeMb, camera, readOnly, disabled, small, className, onChange, onRefresh, }: MultiPhotoInputProps<TFormValues>) => import("react").JSX.Element;
+export type { MultiPhotoInputProps };

package/dist/types/src/components/media-inputs/MultiPhotoInput.security.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/media-inputs/PhotoCropEditor.d.ts

@@ -0,0 +1,9 @@
+export type PhotoCropEditorProps = {
+    imageUrl: string;
+    fileName: string;
+    aspect?: number;
+    onCancel: () => void;
+    onConfirm: (file: File) => void;
+    className?: string;
+};
+export declare const PhotoCropEditor: ({ imageUrl, fileName, aspect, onCancel, onConfirm, className, }: PhotoCropEditorProps) => import("react").JSX.Element;

package/dist/types/src/components/media-inputs/PhotoCropInput.d.ts

@@ -0,0 +1,19 @@
+import { FieldValues, Path, UseFormReturn } from 'react-hook-form';
+type PhotoCropInputProps<TFormValues extends FieldValues> = {
+    form: UseFormReturn<TFormValues>;
+    name: Path<TFormValues>;
+    label?: string;
+    info?: string;
+    required?: boolean;
+    maxSizeMb?: number;
+    interactive?: boolean;
+    aspect?: number;
+    readOnly?: boolean;
+    disabled?: boolean;
+    small?: boolean;
+    className?: string;
+    onChange?: (file: File | null) => void;
+    onRefresh?: () => Promise<void> | void;
+};
+export declare const PhotoCropInput: <TFormValues extends FieldValues>({ form, name, label, info, required, maxSizeMb, interactive, aspect, readOnly, disabled, small, className, onChange, onRefresh, }: PhotoCropInputProps<TFormValues>) => import("react").JSX.Element;
+export type { PhotoCropInputProps };

package/dist/types/src/components/media-inputs/PhotoInput.d.ts

@@ -0,0 +1 @@
+export { PhotoInput } from '../advanced-inputs/PhotoInput';

package/dist/types/src/components/media-inputs/SignaturePad.d.ts

@@ -0,0 +1 @@
+export { SignaturePad } from '../advanced-inputs/SignaturePad';

package/dist/types/src/components/media-inputs/SmartMediaInput.d.ts

@@ -0,0 +1,43 @@
+import { FieldValues, Path, UseFormReturn } from 'react-hook-form';
+import { PhotoItem } from './types';
+type SmartMediaBaseProps<TFormValues extends FieldValues> = {
+    form: UseFormReturn<TFormValues>;
+    name: Path<TFormValues>;
+    label?: string;
+    info?: string;
+    required?: boolean;
+    readOnly?: boolean;
+    disabled?: boolean;
+    small?: boolean;
+    className?: string;
+    onRefresh?: () => Promise<void> | void;
+};
+type SmartMediaPhotoProps<TFormValues extends FieldValues> = SmartMediaBaseProps<TFormValues> & {
+    kind: "photo";
+    capture?: "user" | "environment";
+    maxSizeMb?: number;
+    onChange?: (file: File | null) => void;
+};
+type SmartMediaMultiPhotoProps<TFormValues extends FieldValues> = SmartMediaBaseProps<TFormValues> & {
+    kind: "multiPhoto";
+    max?: number;
+    camera?: boolean;
+    onChange?: (photos: PhotoItem[]) => void;
+};
+type SmartMediaSignatureProps<TFormValues extends FieldValues> = SmartMediaBaseProps<TFormValues> & {
+    kind: "signature";
+    width?: number;
+    height?: number;
+    onChange?: (dataUrl: string) => void;
+};
+type SmartMediaFileProps<TFormValues extends FieldValues> = SmartMediaBaseProps<TFormValues> & {
+    kind: "file";
+    accept?: string;
+    multiple?: boolean;
+    maxSizeMb?: number;
+    buttonLabel?: string;
+    onChange?: (files: File[]) => void;
+};
+export type SmartMediaInputProps<TFormValues extends FieldValues> = SmartMediaPhotoProps<TFormValues> | SmartMediaMultiPhotoProps<TFormValues> | SmartMediaSignatureProps<TFormValues> | SmartMediaFileProps<TFormValues>;
+export declare const SmartMediaInput: <TFormValues extends FieldValues>(props: SmartMediaInputProps<TFormValues>) => import("react").JSX.Element | null;
+export {};

package/dist/types/src/components/media-inputs/SmartMediaInput.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/media-inputs/cropImageFromArea.d.ts

@@ -0,0 +1,7 @@
+export type CropAreaPixels = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export declare const cropImageFromArea: (imageSrc: string, pixelCrop: CropAreaPixels, fileName: string, mimeType?: string) => Promise<File>;

package/dist/types/src/components/media-inputs/index.d.ts

@@ -0,0 +1,13 @@
+export { FileDropInput } from './FileDropInput';
+export type { FileDropInputProps } from './FileDropInput';
+export { PhotoInput } from './PhotoInput';
+export { SignaturePad } from './SignaturePad';
+export { MultiPhotoInput } from './MultiPhotoInput';
+export type { MultiPhotoInputProps } from './MultiPhotoInput';
+export { SmartMediaInput } from './SmartMediaInput';
+export type { SmartMediaInputProps } from './SmartMediaInput';
+export { PhotoCropInput } from './PhotoCropInput';
+export type { PhotoCropInputProps } from './PhotoCropInput';
+export { isValidFileType, showFilePicker, createPhotoItem, nextPhotoId, revokePhotoPreview, revokePhotoPreviews, normalizePhotoItems, cropImageToSquare, } from './mediaUtils';
+export { emptyPhotoItems } from './types';
+export type { PhotoItem } from './types';

package/dist/types/src/components/media-inputs/mediaUtils.d.ts

@@ -0,0 +1,9 @@
+import { PhotoItem } from './types';
+export declare const nextPhotoId: () => string;
+export declare const isValidFileType: (file: File, acceptString: string) => boolean;
+export declare const showFilePicker: (accept: string, multiple?: boolean) => Promise<File[]>;
+export declare const createPhotoItem: (file: File) => PhotoItem;
+export declare const revokePhotoPreview: (photo: PhotoItem) => void;
+export declare const revokePhotoPreviews: (photos: PhotoItem[]) => void;
+export declare const normalizePhotoItems: (value: unknown) => PhotoItem[];
+export declare const cropImageToSquare: (file: File, quality?: number) => Promise<File>;

package/dist/types/src/components/media-inputs/types.d.ts

@@ -0,0 +1,6 @@
+export type PhotoItem = {
+    id: string;
+    preview: string;
+    file: File;
+};
+export declare const emptyPhotoItems: () => PhotoItem[];

package/dist/types/src/components/overlays/CommandPalette.d.ts

@@ -0,0 +1,17 @@
+export type CommandPaletteItem = {
+    id: string;
+    label: string;
+    group?: string;
+    keywords?: string;
+    onSelect: () => void;
+};
+export type CommandPaletteProps = {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    items: CommandPaletteItem[];
+    placeholder?: string;
+    emptyMessage?: string;
+    enableShortcut?: boolean;
+    className?: string;
+};
+export declare const CommandPalette: ({ open, onOpenChange, items, placeholder, emptyMessage, enableShortcut, className, }: CommandPaletteProps) => import('react').ReactPortal | null;

package/dist/types/src/components/overlays/ConfirmDialog.d.ts

@@ -0,0 +1,14 @@
+import { ReactNode } from 'react';
+type ConfirmDialogProps = {
+    open: boolean;
+    title?: string;
+    message?: ReactNode;
+    confirmLabel?: string;
+    cancelLabel?: string;
+    onConfirm: () => void;
+    onCancel: () => void;
+    loading?: boolean;
+    danger?: boolean;
+};
+export declare const ConfirmDialog: ({ open, title, message, confirmLabel, cancelLabel, onConfirm, onCancel, loading, danger, }: ConfirmDialogProps) => import("react").JSX.Element;
+export {};

package/dist/types/src/components/overlays/ContextMenu.d.ts

@@ -0,0 +1,15 @@
+import { FC, MouseEvent, ReactNode } from 'react';
+import { IconType } from 'react-icons';
+export type ContextMenuItem = {
+    id: string;
+    label: string;
+    icon?: IconType | string;
+    disabled?: boolean;
+    onClick?: (ctxValue?: unknown) => void;
+};
+export type ContextMenuItemDef = ContextMenuItem | ((ctxValue?: unknown) => ContextMenuItem | null | undefined);
+export type ContextMenuProviderProps = {
+    children: ReactNode;
+};
+export declare const ContextMenuProvider: FC<ContextMenuProviderProps>;
+export declare const useContextMenu: (defs: ContextMenuItemDef[]) => (event: MouseEvent<HTMLElement>, ctxValue?: unknown) => void;

package/dist/types/src/components/overlays/Drawer.d.ts

@@ -0,0 +1,23 @@
+import { CSSProperties, ReactNode } from 'react';
+import { OverlayHeaderVariant } from './Modal';
+export type DrawerSide = "left" | "right" | "top" | "bottom";
+export type DrawerProps = {
+    open: boolean;
+    onClose: () => void;
+    side?: DrawerSide;
+    title?: string;
+    subtitle?: string;
+    icon?: ReactNode;
+    children: ReactNode;
+    footer?: ReactNode;
+    subheader?: ReactNode;
+    width?: CSSProperties["width"];
+    height?: CSSProperties["height"];
+    headerVariant?: OverlayHeaderVariant;
+    closeOnOverlay?: boolean;
+    className?: string;
+};
+export declare const Drawer: ({ open, onClose, side, title, subtitle, icon, children, footer, subheader, width, height, headerVariant, closeOnOverlay, className, }: DrawerProps) => import('react').ReactPortal | null;
+/** Alias de `Drawer` — patrón shadcn Sheet (panel lateral o inferior). */
+export declare const Sheet: ({ open, onClose, side, title, subtitle, icon, children, footer, subheader, width, height, headerVariant, closeOnOverlay, className, }: DrawerProps) => import('react').ReactPortal | null;
+export type SheetProps = DrawerProps;

package/dist/types/src/components/overlays/DropdownMenu.d.ts

@@ -0,0 +1,21 @@
+import { FC, ReactNode } from 'react';
+import { IconType } from 'react-icons';
+type DropdownAlign = "start" | "end";
+type DropdownMenuProps = {
+    trigger: ReactNode | ((open: boolean) => ReactNode);
+    children: ReactNode;
+    align?: DropdownAlign;
+    widthClassName?: string;
+    className?: string;
+};
+export declare const useDropdownClose: () => () => void;
+export declare const DropdownMenu: ({ trigger, children, align, widthClassName, className, }: DropdownMenuProps) => import("react").JSX.Element;
+type DropdownMenuItemProps = {
+    label: string;
+    onClick: () => void;
+    icon?: IconType;
+    disabled?: boolean;
+    danger?: boolean;
+};
+export declare const DropdownMenuItem: FC<DropdownMenuItemProps>;
+export {};

package/dist/types/src/components/overlays/MessageDialog.d.ts

@@ -0,0 +1,11 @@
+import { ReactNode } from 'react';
+export type MessageDialogVariant = "info" | "success" | "warning" | "danger";
+export type MessageDialogProps = {
+    open: boolean;
+    onClose: () => void;
+    variant?: MessageDialogVariant;
+    title?: string;
+    message?: ReactNode;
+    actionLabel?: string;
+};
+export declare const MessageDialog: ({ open, onClose, variant, title, message, actionLabel, }: MessageDialogProps) => import("react").JSX.Element;

package/dist/types/src/components/overlays/Modal.d.ts

@@ -0,0 +1,31 @@
+import { ReactNode } from 'react';
+export type ModalSize = "sm" | "md" | "lg" | "xl";
+export type OverlayHeaderVariant = "default" | "brand" | "dark" | "danger";
+export type ModalProps = {
+    open: boolean;
+    onClose: () => void;
+    title?: string;
+    subtitle?: ReactNode;
+    icon?: ReactNode;
+    children: ReactNode;
+    footer?: ReactNode;
+    subheader?: ReactNode;
+    size?: ModalSize;
+    headerVariant?: OverlayHeaderVariant;
+    /** Oculta cabecera estándar (título, subtítulo, icono y cerrar) cuando el consumidor renderiza cabecera propia en el body. */
+    hideHeader?: boolean;
+    closeOnOverlay?: boolean;
+    className?: string;
+};
+export declare const Modal: ({ open, onClose, title, subtitle, icon, children, footer, subheader, size, headerVariant, hideHeader, closeOnOverlay, className, }: ModalProps) => import('react').ReactPortal | null;
+type UseModalOptions = {
+    onOpen?: () => void;
+    onClose?: () => void;
+};
+export declare const useModal: <T>(options?: UseModalOptions) => {
+    isOpen: boolean;
+    open: (data?: T) => void;
+    close: () => void;
+    data: T | undefined;
+};
+export {};

package/dist/types/src/components/overlays/NotificationBell.d.ts

@@ -0,0 +1,12 @@
+export type NotificationItem = {
+    id: string;
+    title: string;
+    message?: string;
+};
+export type NotificationBellProps = {
+    items: NotificationItem[];
+    onItemClick?: (item: NotificationItem) => void;
+    emptyLabel?: string;
+    className?: string;
+};
+export declare const NotificationBell: ({ items, onItemClick, emptyLabel, className, }: NotificationBellProps) => import("react").JSX.Element;

package/dist/types/src/components/overlays/OptionItem.d.ts

@@ -0,0 +1,11 @@
+import { AriaRole, ReactNode } from 'react';
+export type OptionItemProps = {
+    title: string;
+    selected?: boolean;
+    icon?: ReactNode;
+    disabled?: boolean;
+    onClick?: () => void;
+    role?: AriaRole;
+    className?: string;
+};
+export declare const OptionItem: ({ title, selected, icon, disabled, onClick, role, className, }: OptionItemProps) => import("react").JSX.Element;

package/dist/types/src/components/overlays/Popover.d.ts

@@ -0,0 +1,18 @@
+import { FC, ReactNode } from 'react';
+export type PopoverAlign = "start" | "end";
+export type PopoverSide = "top" | "bottom";
+export type PopoverProps = {
+    trigger: ReactNode | ((open: boolean) => ReactNode);
+    children: ReactNode;
+    align?: PopoverAlign;
+    side?: PopoverSide;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    className?: string;
+    contentClassName?: string;
+    triggerId?: string;
+    triggerAriaLabel?: string;
+    triggerDisabled?: boolean;
+    triggerAriaReadOnly?: boolean;
+};
+export declare const Popover: FC<PopoverProps>;

package/dist/types/src/components/overlays/ProductTour.d.ts

@@ -0,0 +1,15 @@
+export type ProductTourStep = {
+    target: string;
+    title: string;
+    description?: string;
+    placement?: "top" | "bottom" | "left" | "right";
+};
+export type ProductTourProps = {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    steps: ProductTourStep[];
+    stepIndex?: number;
+    onStepChange?: (index: number) => void;
+    className?: string;
+};
+export declare const ProductTour: ({ open, onOpenChange, steps, stepIndex: controlledIndex, onStepChange, className, }: ProductTourProps) => import('react').ReactPortal | null;