@myzbox/react-overlay 1.0.0

package/src/styles/ModalVariants.module.css

@@ -0,0 +1,132 @@
+:root {
+    --rm-success-bg: #d1fae5;
+    --rm-success-color: #065f46;
+    --rm-error-bg: #fee2e2;
+    --rm-error-color: #991b1b;
+    --rm-warning-bg: #fef3c7;
+    --rm-warning-color: #92400e;
+    --rm-info-bg: #dbeafe;
+    --rm-info-color: #1e40af;
+
+    --rm-btn-primary-bg: #2563eb;
+    --rm-btn-primary-hover: #1d4ed8;
+    --rm-btn-primary-text: #ffffff;
+
+    --rm-btn-default-bg: #ffffff;
+    --rm-btn-default-border: #d1d5db;
+    --rm-btn-default-text: #374151;
+    --rm-btn-default-hover: #f3f4f6;
+
+    --rm-btn-destructive-bg: #dc2626;
+    --rm-btn-destructive-hover: #b91c1c;
+}
+
+.drawer {
+    border-radius: 0;
+    max-height: none;
+}
+
+.drawer.left,
+.drawer.right {
+    height: 100vh;
+    border-radius: 0;
+}
+
+.drawer.top,
+.drawer.bottom {
+    width: 100vw;
+    border-radius: 0;
+}
+
+.alertModal {
+    box-sizing: border-box;
+    display: block;
+}
+
+
+.alertContent {
+    display: flex;
+    align-items: center;
+    gap: 1rem;
+}
+
+.icon {
+    width: 2rem;
+    height: 2rem;
+    border-radius: 50%;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    font-weight: bold;
+    flex-shrink: 0;
+}
+
+.success .icon {
+    background: var(--rm-success-bg);
+    color: var(--rm-success-color);
+}
+
+.error .icon {
+    background: var(--rm-error-bg);
+    color: var(--rm-error-color);
+}
+
+.warning .icon {
+    background: var(--rm-warning-bg);
+    color: var(--rm-warning-color);
+}
+
+.info .icon {
+    background: var(--rm-info-bg);
+    color: var(--rm-info-color);
+}
+
+.okButton,
+.confirmButton {
+    box-sizing: border-box;
+    background: var(--rm-btn-primary-bg);
+    color: var(--rm-btn-primary-text);
+    border: none;
+    padding: 0.5rem 1rem;
+    border-radius: 4px;
+    cursor: pointer;
+    font-weight: 500;
+}
+
+.okButton:hover,
+.confirmButton:hover {
+    background: var(--rm-btn-primary-hover);
+}
+
+.okButton:disabled,
+.confirmButton:disabled {
+    opacity: 0.5;
+    cursor: not-allowed;
+}
+
+.cancelButton {
+    box-sizing: border-box;
+    background: var(--rm-btn-default-bg);
+    border: 1px solid var(--rm-btn-default-border);
+    color: var(--rm-btn-default-text);
+    padding: 0.5rem 1rem;
+    border-radius: 4px;
+    cursor: pointer;
+}
+
+.cancelButton:hover {
+    background: var(--rm-btn-default-hover);
+}
+
+.cancelButton:disabled {
+    opacity: 0.5;
+    cursor: not-allowed;
+}
+
+.destructive {
+    background: var(--rm-btn-destructive-bg);
+}
+
+.destructive:hover {
+    background: var(--rm-btn-destructive-hover);
+}

package/src/styles/Popover.module.css

@@ -0,0 +1,70 @@
+.wrapper {
+    position: relative;
+    display: inline-block;
+}
+
+.trigger {
+    cursor: pointer;
+    display: inline-block;
+}
+
+.popover {
+    position: absolute;
+    background-color: white;
+    color: #374151;
+    padding: 1rem;
+    border-radius: 8px;
+    border: 1px solid #e5e7eb;
+    z-index: 900;
+    box-shadow: 0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05);
+    min-width: 200px;
+    animation: fadeIn 0.15s ease-out;
+}
+
+.popover.draggable {
+    cursor: move;
+    user-select: none;
+}
+
+/* Positions */
+.popover.bottom {
+    top: calc(100% + 0.5rem);
+    left: 50%;
+    transform: translateX(-50%);
+    transform-origin: top center;
+}
+
+.popover.top {
+    bottom: calc(100% + 0.5rem);
+    left: 50%;
+    transform: translateX(-50%);
+    transform-origin: bottom center;
+}
+
+.popover.left {
+    right: calc(100% + 0.5rem);
+    top: 50%;
+    transform: translateY(-50%);
+    transform-origin: center right;
+}
+
+.popover.right {
+    left: calc(100% + 0.5rem);
+    top: 50%;
+    transform: translateY(-50%);
+    transform-origin: center left;
+}
+
+@keyframes fadeIn {
+    from {
+        opacity: 0;
+        transform: scale(0.95);
+        margin-top: -5px;
+    }
+
+    to {
+        opacity: 1;
+        transform: scale(1);
+        margin-top: 0;
+    }
+}

package/src/styles/Toast.module.css

@@ -0,0 +1,196 @@
+.toast {
+    display: flex;
+    align-items: center;
+    gap: 12px;
+    min-width: 300px;
+    max-width: 400px;
+    padding: 12px 16px;
+    border-radius: 6px;
+    background: white;
+    box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
+    margin-bottom: 10px;
+    pointer-events: auto;
+    overflow: hidden;
+    animation: slideIn 0.3s ease-out;
+    transition: all 0.3s ease-in-out;
+    position: relative;
+}
+
+.toast.draggable {
+    cursor: move;
+    user-select: none;
+}
+
+.toast.exiting {
+    opacity: 0;
+    transform: scale(0.95);
+    margin-bottom: -40px;
+}
+
+/* Types */
+.toast.success {
+    border-left: 4px solid #10b981;
+}
+
+.toast.error {
+    border-left: 4px solid #ef4444;
+}
+
+.toast.warning {
+    border-left: 4px solid #f59e0b;
+}
+
+.toast.info {
+    border-left: 4px solid #3b82f6;
+}
+
+.icon {
+    font-weight: bold;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 28px;
+    height: 28px;
+    border-radius: 50%;
+    flex-shrink: 0;
+}
+
+.toast.success .icon {
+    background-color: #ecfdf5;
+    color: #059669;
+}
+
+.toast.error .icon {
+    background-color: #fef2f2;
+    color: #dc2626;
+}
+
+.toast.warning .icon {
+    background-color: #fffbeb;
+    color: #d97706;
+}
+
+.toast.info .icon {
+    background-color: #eff6ff;
+    color: #2563eb;
+}
+
+.content {
+    flex: 1;
+    font-size: 14px;
+    color: #374151;
+    line-height: 1.4;
+}
+
+.closeBtn {
+    background: transparent;
+    border: none;
+    cursor: pointer;
+    font-size: 18px;
+    color: #4b5563;
+    padding: 0;
+    display: flex;
+    font-weight: 700;
+    align-items: center;
+    justify-content: center;
+    width: 24px;
+    height: 24px;
+}
+
+.closeBtn:hover {
+    color: #111827;
+    background-color: rgba(0, 0, 0, 0.05);
+    border-radius: 4px;
+}
+
+@keyframes slideIn {
+    from {
+        opacity: 0;
+        transform: translateY(10px);
+    }
+
+    to {
+        opacity: 1;
+        transform: translateY(0);
+    }
+}
+
+/* Container Styles */
+.container {
+    position: fixed;
+    z-index: 9999;
+    pointer-events: none;
+    display: flex;
+    flex-direction: column;
+    padding: 16px;
+    gap: 8px;
+}
+
+.container.top-left {
+    top: 0;
+    left: 0;
+    align-items: flex-start;
+}
+
+.container.top-right {
+    top: 0;
+    right: 0;
+    align-items: flex-end;
+}
+
+.container.top-center {
+    top: 0;
+    left: 50%;
+    transform: translateX(-50%);
+    align-items: center;
+}
+
+.container.bottom-left {
+    bottom: 0;
+    left: 0;
+    align-items: flex-start;
+    flex-direction: column-reverse;
+}
+
+.container.bottom-right {
+    bottom: 0;
+    right: 0;
+    align-items: flex-end;
+    flex-direction: column-reverse;
+}
+
+.container.bottom-center {
+    bottom: 0;
+    left: 50%;
+    transform: translateX(-50%);
+    align-items: center;
+    flex-direction: column-reverse;
+}
+
+/* Animation adjustments based on position */
+.container.bottom-left .toast,
+.container.bottom-right .toast,
+.container.bottom-center .toast {
+    margin-bottom: 0;
+    margin-top: 10px;
+    animation: slideInBottom 0.3s ease-out;
+}
+
+.container.bottom-left .toast.exiting,
+.container.bottom-right .toast.exiting,
+.container.bottom-center .toast.exiting {
+    margin-top: -40px;
+    margin-bottom: 0;
+}
+
+@keyframes slideInBottom {
+    from {
+        opacity: 0;
+        transform: translateY(-10px);
+    }
+
+    to {
+        opacity: 1;
+        transform: translateY(0);
+    }
+}

package/src/styles/Tooltip.module.css

@@ -0,0 +1,50 @@
+.wrapper {
+    position: relative;
+    display: inline-block;
+}
+
+.tooltip {
+    position: absolute;
+    background-color: #111827;
+    color: white;
+    padding: 0.5rem 0.75rem;
+    border-radius: 4px;
+    font-size: 0.875rem;
+    z-index: 1000;
+    white-space: nowrap;
+    pointer-events: none;
+    box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);
+    opacity: 0;
+    animation: fadeIn 0.2s forwards;
+}
+
+/* Positions */
+.tooltip.top {
+    bottom: 100%;
+    left: 50%;
+    transform: translateX(-50%) translateY(-0.5rem);
+}
+
+.tooltip.bottom {
+    top: 100%;
+    left: 50%;
+    transform: translateX(-50%) translateY(0.5rem);
+}
+
+.tooltip.left {
+    right: 100%;
+    top: 50%;
+    transform: translateY(-50%) translateX(-0.5rem);
+}
+
+.tooltip.right {
+    left: 100%;
+    top: 50%;
+    transform: translateY(-50%) translateX(0.5rem);
+}
+
+@keyframes fadeIn {
+    to {
+        opacity: 1;
+    }
+}

package/src/styles/index.css

@@ -0,0 +1,5 @@
+@import "./Modal.module.css";
+@import "./ModalVariants.module.css";
+@import "./Popover.module.css";
+@import "./Toast.module.css";
+@import "./Tooltip.module.css";

package/src/types/Modal.ts

@@ -0,0 +1,100 @@
+import type { ReactNode, RefObject, CSSProperties } from 'react';
+
+export type ModalPosition =
+    | 'center'
+    | 'top'
+    | 'bottom'
+    | 'left'
+    | 'right'
+    | 'top-left'
+    | 'top-right'
+    | 'bottom-left'
+    | 'bottom-right';
+
+export type ModalSize = 'sm' | 'md' | 'lg' | 'xl' | 'full' | 'auto';
+
+export type ModalAnimation = 'zoom' | 'fade' | 'slide-up' | 'slide-down' | 'slide-left' | 'slide-right' | 'drawer-slide-left' | 'drawer-slide-right' | 'drawer-slide-up' | 'drawer-slide-down' | 'none';
+
+export interface ModalProps {
+    /**
+     * Controls the visibility of the modal.
+     */
+    isOpen: boolean;
+    /**
+     * Callback fired when the modal requests to be closed.
+     */
+    onClose: () => void;
+    /**
+     * Content to return inside the modal.
+     */
+    children: ReactNode;
+    /**
+     * Modal title (optional).
+     */
+    title?: ReactNode;
+    /**
+     * Modal footer content (optional).
+     */
+    footer?: ReactNode;
+    /**
+     * Whether to close the modal when clicking on the overlay.
+     * @default true
+     */
+    closeOnOverlayClick?: boolean;
+    /**
+     * Whether to close the modal when pressing the Escape key.
+     * @default true
+     */
+    closeOnEsc?: boolean;
+    /**
+     * Additional class name for the overlay.
+     */
+    overlayClassName?: string;
+    /**
+     * Additional class name for the modal content container.
+     */
+    className?: string;
+    /**
+     * Inline styles for the overlay.
+     */
+    overlayStyle?: CSSProperties;
+    /**
+     * Inline styles for the content.
+     */
+    style?: CSSProperties;
+    /**
+     * Position of the modal on the screen.
+     * @default 'center'
+     */
+    position?: ModalPosition;
+    /**
+     * Size of the modal.
+     * @default 'md'
+     */
+    size?: ModalSize;
+    /**
+     * Animation type.
+     * @default 'zoom'
+     */
+    animation?: ModalAnimation;
+    /**
+     * Element to focus when the modal opens.
+     */
+    initialFocusRef?: RefObject<HTMLElement | null>;
+    /**
+     * Element that should remain accessible (not hidden to screen readers) usually root.
+     */
+    appElement?: HTMLElement | string;
+    /**
+     * Z-index override
+     */
+    zIndex?: number;
+    /**
+     * Enable drag functionality
+     */
+    draggable?: boolean;
+    /**
+     * Whether to hide the header section (title and close button)
+     */
+    hideHeader?: boolean;
+}

package/src/types/Popover.ts

@@ -0,0 +1,13 @@
+import type { ReactNode } from 'react';
+
+export type PopoverPosition = 'top' | 'bottom' | 'left' | 'right';
+
+export interface PopoverProps {
+    children: ReactNode; // The trigger element
+    content: ReactNode | ((close: () => void) => ReactNode);  // The popover content
+    position?: PopoverPosition;
+    className?: string;
+    style?: React.CSSProperties;
+    width?: string | number;
+    draggable?: boolean;
+}

package/src/types/Toast.ts

@@ -0,0 +1,19 @@
+import type { ReactNode } from 'react';
+
+export type ToastType = 'success' | 'error' | 'warning' | 'info';
+export type ToastPosition = 'top-left' | 'top-right' | 'top-center' | 'bottom-left' | 'bottom-right' | 'bottom-center';
+
+export interface ToastOptions {
+    id: string;
+    type: ToastType;
+    content: ReactNode;
+    duration?: number; // ms, if 0 then no auto-close
+    delay?: number;    // ms, wait before showing
+    position?: ToastPosition;
+    draggable?: boolean;
+    onClose?: () => void;
+}
+
+export interface ToastProps extends ToastOptions {
+    onDismiss: (id: string) => void;
+}

package/src/types/Tooltip.ts

@@ -0,0 +1,19 @@
+import type { ReactNode } from 'react';
+
+export type TooltipPosition = 'top' | 'bottom' | 'left' | 'right';
+
+export interface TooltipProps {
+    children: ReactNode;
+    content: ReactNode;
+    position?: TooltipPosition;
+    delay?: number;
+    width?: string | number;
+    height?: string | number;
+    className?: string;
+    style?: React.CSSProperties;
+    /**
+     * By default, tooltips may clip if parent has overflow:hidden.
+     * Using a portal avoids this but adds complexity.
+     * For this implementation, we'll keep it simple first.
+     */
+}