epic-modals 0.0.10 → 1.0.1

package/dist/core/viewport.d.ts

@@ -1,92 +0,0 @@
-import { Position, Bounds } from './types';
-/** Bounds of an existing modal for overlap calculation */
-export interface ModalBounds {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}
-export interface ViewportConstraintOptions {
-    /** Margin from viewport edges (default: 8) */
-    margin?: number;
-    /** Allow element to go partially off-screen if larger than viewport */
-    allowPartialVisibility?: boolean;
-}
-/**
- * Constrain a position to keep an element within viewport bounds
- */
-export declare function constrainToViewport(x: number, y: number, width: number, height: number, options?: ViewportConstraintOptions): Position;
-/**
- * Constrain size and position to fit within viewport
- */
-export declare function constrainSizeToViewport(x: number, y: number, width: number, height: number, options?: ViewportConstraintOptions): Bounds;
-/**
- * Calculate overlap area between two rectangles
- * @internal Exported for testing
- */
-export declare function calculateOverlap(a: {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}, b: {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}): number;
-/**
- * Calculate total overlap of a modal at a given position with all existing modals
- * @internal Exported for testing
- */
-export declare function calculateTotalOverlap(x: number, y: number, width: number, height: number, existingModals: ModalBounds[], gap: number): number;
-export interface SmartPositionOptions {
-    /** Minimum gap between modals (default: 16). Also used as viewport edge margin unless `margin` is set. */
-    modalGap?: number;
-    /** Margin from viewport edges (default: uses modalGap value) */
-    margin?: number;
-    /** Number of positions to test along each axis */
-    gridResolution?: number;
-    /** Additional bounds to avoid (e.g., navigation bars, toolbars) */
-    avoidBounds?: ModalBounds[];
-    /** Margin to add around avoidBounds elements (default: 16) */
-    avoidMargin?: number;
-}
-/** Modal with ID for rearrangement tracking */
-export interface ModalBoundsWithId extends ModalBounds {
-    id: string;
-}
-/** Result of rearrangement calculation */
-export interface RearrangementResult {
-    /** New position for the new modal */
-    newModalPosition: Position;
-    /** Map of modal IDs to their new positions */
-    existingModalMoves: Map<string, Position>;
-}
-/**
- * Get bounds of elements matching the given CSS selectors
- */
-export declare function getElementBounds(selectors: string[]): ModalBounds[];
-/**
- * Calculate position quality score (0 = best/center, 1 = worst/corner)
- * Considers both distance from center and proximity to edges
- * @internal Exported for testing
- */
-export declare function calculatePositionScore(x: number, y: number, width: number, height: number, vw: number, vh: number, margin: number): number;
-/**
- * Find the best position for a new modal that minimizes overlap with existing modals.
- * Prefers positions closer to center - corners are only used as last resort.
- * Tests positions in a grid pattern and returns the best one.
- * Falls back to center if no existing modals.
- *
- * Note: avoidBounds are treated as STRICT - positions that overlap them are filtered out.
- * Modal-to-modal overlap is treated more leniently (up to 30% acceptable for better centering).
- */
-export declare function findSmartPosition(width: number, height: number, existingModals: ModalBounds[], options?: SmartPositionOptions): Position;
-/**
- * Calculate rearrangement of existing modals to make room for a new modal.
- * Distributes modals evenly across the viewport width.
- * Returns null if rearrangement is not possible (not enough space).
- */
-export declare function calculateRearrangement(newModalWidth: number, newModalHeight: number, existingModals: ModalBoundsWithId[], options?: SmartPositionOptions): RearrangementResult | null;
-//# sourceMappingURL=viewport.d.ts.map

package/dist/core/viewport.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=viewport.test.d.ts.map

package/dist/react/Dock.d.ts

@@ -1,10 +0,0 @@
-import { ReactNode } from 'react';
-export interface DockProps {
-    /** Custom icon renderer - receives icon name, returns React element */
-    renderIcon?: (props: {
-        icon: string;
-    }) => ReactNode;
-}
-export declare function Dock({ renderIcon }: DockProps): import("react/jsx-runtime").JSX.Element;
-export default Dock;
-//# sourceMappingURL=Dock.d.ts.map

package/dist/react/index.d.ts

@@ -1,15 +0,0 @@
-export { Modal } from './Modal';
-export type { ModalProps } from './Modal';
-export { ModalProvider } from './ModalProvider';
-export type { ModalProviderProps } from './ModalProvider';
-export { Dock } from './Dock';
-export type { DockProps } from './Dock';
-export { useModal, useModals } from './useModal';
-export { useModalZIndex } from './useModalZIndex';
-export type { UseModalZIndexReturn } from './useModalZIndex';
-export { ModalIdContext } from './context';
-export { createSvelteBridge, reactChildrenToSvelteSnippet } from './svelte-bridge';
-export { openModal, closeModal, minimizeModal, restoreModal, bringToFront, isModalOpen, isModalRegistered, openChildModal, triggerAttention, } from '../core/state.svelte';
-export { init, createBackdrop, createDock } from '../vanilla/index';
-export type { InitOptions, InitControl, BackdropControl, DockControl } from '../vanilla/index';
-//# sourceMappingURL=index.d.ts.map

package/dist/react/reactiveProps.svelte.d.ts

@@ -1,17 +0,0 @@
-/**
- * Reactive Props Helper for React-Svelte Bridge
- *
- * In Svelte 5, props passed to mount() need to be reactive ($state) to update.
- * This helper creates a reactive props object that can be mutated from React.
- */
-/**
- * Creates a reactive props object that can be passed to Svelte's mount()
- * and updated from non-Svelte code (like React).
- */
-export declare function createReactiveProps<T extends Record<string, unknown>>(initial: T): T;
-/**
- * Updates a reactive props object with new values.
- * Only updates changed properties to minimize reactivity triggers.
- */
-export declare function updateReactiveProps<T extends Record<string, unknown>>(props: T, updates: Partial<T>): void;
-//# sourceMappingURL=reactiveProps.svelte.d.ts.map

package/dist/react/svelte-bridge.d.ts

@@ -1,18 +0,0 @@
-import { default as React, ReactNode } from 'react';
-import { Component, Snippet } from 'svelte';
-/**
- * Create a React wrapper for a Svelte component
- */
-export declare function createSvelteBridge<P extends Record<string, unknown>>(SvelteComponent: Component<any>): (props: P & {
-    children?: ReactNode;
-}) => React.ReactElement<{
-    ref: React.RefObject<HTMLDivElement | null>;
-    'data-svelte-bridge': string;
-}, string | React.JSXElementConstructor<any>>;
-/**
- * Convert React children to a Svelte-compatible format
- * Note: This is a basic implementation. Complex React children
- * may require a portal-based approach.
- */
-export declare function reactChildrenToSvelteSnippet(children: ReactNode): Snippet | undefined;
-//# sourceMappingURL=svelte-bridge.d.ts.map

package/dist/react/useModalZIndex.d.ts

@@ -1,35 +0,0 @@
-import { ModalId } from '../core/types';
-export interface UseModalZIndexReturn {
-    /** Z-index for floating elements (same as modal, appears on top due to DOM order) */
-    zIndex: number;
-    /** Portal target element or selector */
-    portalTarget: string | HTMLElement;
-}
-/**
- * React hook for getting z-index and portal target for floating elements inside a modal
- * @param modalId - Optional modal ID. If not provided, uses context from parent Modal component.
- * @returns Object with zIndex and portalTarget for positioning
- *
- * @example
- * ```tsx
- * import { useModalZIndex } from '@modals/react';
- * import { createPortal } from 'react-dom';
- *
- * function MyDropdown() {
- *   // Automatically uses parent modal's ID from context
- *   const { zIndex, portalTarget } = useModalZIndex();
- *   const portalEl = typeof portalTarget === 'string'
- *     ? document.querySelector(portalTarget)
- *     : portalTarget;
- *
- *   return portalEl && createPortal(
- *     <div className="dropdown" style={{ zIndex }}>
- *       Dropdown content
- *     </div>,
- *     portalEl
- *   );
- * }
- * ```
- */
-export declare function useModalZIndex(modalId?: ModalId): UseModalZIndexReturn;
-//# sourceMappingURL=useModalZIndex.d.ts.map

package/dist/svelte/hooks/useModalAnimation.svelte.d.ts

@@ -1,16 +0,0 @@
-import { AnimationTransform, Position, Dimensions } from '../../core/types';
-export declare function useModalAnimation(getId: () => string, getModalEl: () => HTMLElement | null, getPosition: () => Position, setPosition: (pos: Position) => void, getHasBeenDragged: () => boolean, setHasBeenDragged: (value: boolean) => void, getHasBeenResized: () => boolean, getSize: () => Dimensions, onMinimize: (position: Position, hasBeenDragged: boolean, size: Dimensions) => void): {
-    readonly isMinimizing: boolean;
-    readonly isRestoring: boolean;
-    readonly isOpening: boolean;
-    readonly isClosing: boolean;
-    readonly animationTransform: AnimationTransform | null;
-    readonly pendingOpenSource: Position | null;
-    startMinimize: (customTarget?: Position, onComplete?: () => void) => void;
-    startRestore: (storePosition: Position | undefined, modalSize: Dimensions | undefined) => void;
-    startClose: (callback: () => void) => void;
-    setPendingOpenSource: (source: Position | null) => void;
-    tryStartOpenAnimation: () => boolean;
-    forceClearMinimize: () => void;
-};
-//# sourceMappingURL=useModalAnimation.svelte.d.ts.map

package/dist/svelte/hooks/useModalDrag.svelte.d.ts

@@ -1,16 +0,0 @@
-import { Position } from '../../core/types';
-export declare function useModalDrag(initialPosition?: Position): {
-    readonly position: Position;
-    readonly hasBeenDragged: boolean;
-    readonly isDragging: boolean;
-    onPointerDown: (event: PointerEvent, element: HTMLElement) => void;
-    onPointerMove: (_event: PointerEvent, _element: HTMLElement, modalSize: {
-        width: number;
-        height: number;
-    }) => void;
-    onPointerUp: (event: PointerEvent, element: HTMLElement) => void;
-    setPosition: (newPosition: Position) => void;
-    setHasBeenDragged: (value: boolean) => void;
-    reset: () => void;
-};
-//# sourceMappingURL=useModalDrag.svelte.d.ts.map

package/dist/svelte/hooks/useModalResize.svelte.d.ts

@@ -1,18 +0,0 @@
-import { Position, Dimensions } from '../../core/types';
-export declare function useModalResize(getModalEl: () => HTMLElement | null, getPosition: () => Position, setPosition: (pos: Position) => void, getHasBeenDragged: () => boolean, setHasBeenDragged: (value: boolean) => void, onPositionChange: (position: Position, size: Dimensions) => void, getSymmetricResize?: () => boolean): {
-    readonly isResizing: boolean;
-    readonly resizeDirection: string;
-    readonly size: Dimensions;
-    readonly hasBeenResized: boolean;
-    readonly isActive: boolean;
-    readonly justFinishedResizing: boolean;
-    start: (e: PointerEvent, direction: string) => void;
-    setHasBeenResized: () => void;
-    setSize: (newSize: Dimensions) => void;
-    reset: () => void;
-    constrainToViewport: () => void;
-    handlers: {
-        startResize: (e: PointerEvent, direction: string) => void;
-    };
-};
-//# sourceMappingURL=useModalResize.svelte.d.ts.map

package/dist/svelte/index.d.ts

@@ -1,14 +0,0 @@
-export { default as Modal } from './Modal.svelte';
-export { default as Dock } from './Dock.svelte';
-export { default as Backdrop } from './Backdrop.svelte';
-export { default as ModalProvider } from './ModalProvider.svelte';
-export { default as ModalHeader } from './ModalHeader.svelte';
-export { default as ResizeHandles } from './ResizeHandles.svelte';
-export { default as Portal } from './Portal.svelte';
-export { RENDER_ICON_CONTEXT, MODAL_ID_CONTEXT } from './context';
-export * from './hooks';
-export { openModal, closeModal, minimizeModal, restoreModal, bringToFront, isModalOpen, isModalRegistered, getModalsStore, openChildModal, restoreAllMinimizedModals, triggerAttention, } from '../core/state.svelte';
-export type { UseModalReturn } from './hooks/useModal.svelte';
-export type { UseModalZIndexReturn } from './hooks/useModalZIndex.svelte';
-export { getConfig, setConfig, resetConfig, getConfigVersion } from '../core/config.svelte';
-//# sourceMappingURL=index.d.ts.map