@omnitron-dev/prism 0.2.0 → 0.3.0

package/dist/utils/transform-number.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Number Input Transform Utilities
+ *
+ * Three-phase number input handling for controlled inputs.
+ * Allows users to type freely while maintaining valid numeric state.
+ *
+ * @module utils/transform-number
+ */
+/**
+ * Options for number transformation.
+ */
+export interface TransformNumberOptions {
+    /** Minimum allowed value */
+    min?: number;
+    /** Maximum allowed value */
+    max?: number;
+    /** Decimal places to allow */
+    decimals?: number;
+    /** Allow negative numbers */
+    allowNegative?: boolean;
+    /** Default value when input is empty or invalid */
+    defaultValue?: number;
+}
+/**
+ * Parse a string to a number, handling edge cases.
+ *
+ * @param value - String value to parse
+ * @param options - Transformation options
+ * @returns Parsed number or undefined if invalid
+ */
+export declare function parseNumber(value: string, options?: TransformNumberOptions): number | undefined;
+/**
+ * Clamp a number to min/max bounds.
+ *
+ * @param value - Value to clamp
+ * @param options - Options with min/max
+ * @returns Clamped value
+ */
+export declare function clampNumber(value: number, options?: TransformNumberOptions): number;
+/**
+ * Round a number to specified decimal places.
+ *
+ * @param value - Value to round
+ * @param decimals - Number of decimal places
+ * @returns Rounded value
+ */
+export declare function roundToDecimals(value: number, decimals: number): number;
+/**
+ * Transform value during onChange (while typing).
+ * Allows intermediate states like empty string, single minus, or trailing decimal.
+ *
+ * @param value - Current input value
+ * @param options - Transformation options
+ * @returns Transformed string value (may include intermediate states)
+ */
+export declare function transformOnChange(value: string, options?: TransformNumberOptions): string;
+/**
+ * Transform value during onBlur (when input loses focus).
+ * Finalizes the value with proper formatting and validation.
+ *
+ * @param value - Current input value
+ * @param options - Transformation options
+ * @returns Finalized numeric value
+ */
+export declare function transformOnBlur(value: string, options?: TransformNumberOptions): number;
+/**
+ * Transform a number for display in an input.
+ * Converts number back to string representation.
+ *
+ * @param value - Numeric value
+ * @param options - Transformation options
+ * @returns String representation for input value
+ */
+export declare function transformForDisplay(value: number | null | undefined, options?: TransformNumberOptions): string;
+/**
+ * Create a complete number input handler.
+ * Returns handlers for onChange, onBlur, and value display.
+ *
+ * @example
+ * ```tsx
+ * const [price, setPrice] = useState(0);
+ * const handlers = createNumberInputHandlers({
+ *   value: price,
+ *   onChange: setPrice,
+ *   min: 0,
+ *   decimals: 2,
+ * });
+ *
+ * <TextField
+ *   value={handlers.displayValue}
+ *   onChange={(e) => handlers.handleChange(e.target.value)}
+ *   onBlur={handlers.handleBlur}
+ * />
+ * ```
+ *
+ * @param config - Handler configuration
+ * @returns Object with handlers and display value
+ */
+export declare function createNumberInputHandlers(config: {
+    value: number;
+    onChange: (value: number) => void;
+    options?: TransformNumberOptions;
+}): {
+    displayValue: string;
+    handleChange: (value: string) => void;
+    handleBlur: () => void;
+};
+//# sourceMappingURL=transform-number.d.ts.map

package/dist/utils/transform-number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-number.d.ts","sourceRoot":"","sources":["../../src/utils/transform-number.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,MAAM,GAAG,SAAS,CAgBnG;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,MAAM,CAYvF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGvE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,MAAM,CAkC7F;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,MAAM,CAmB3F;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,GAAE,sBAA2B,GAAG,MAAM,CAYlH;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,sBAAsB,CAAC;CAClC,GAAG;IACF,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB,CAwBA"}

package/dist/utils/url.d.ts

@@ -0,0 +1,198 @@
+/**
+ * URL Utilities
+ *
+ * Safe URL handling, navigation helpers, and link utilities.
+ *
+ * @module utils/url
+ */
+/**
+ * Options for safe return URL validation.
+ */
+export interface SafeReturnUrlOptions {
+    /** Allowed URL schemes (default: ['http:', 'https:']) */
+    allowedSchemes?: string[];
+    /** Allowed hosts (if empty, only relative URLs allowed) */
+    allowedHosts?: string[];
+    /** Whether to allow relative URLs (default: true) */
+    allowRelative?: boolean;
+    /** Default URL if validation fails */
+    fallback?: string;
+}
+/**
+ * Validate and sanitize a return URL to prevent open redirect vulnerabilities.
+ * Only allows relative paths or URLs to explicitly allowed hosts.
+ *
+ * @example
+ * ```tsx
+ * // In a login callback
+ * const returnUrl = safeReturnUrl(searchParams.get('redirect'), {
+ *   allowedHosts: ['app.example.com'],
+ *   fallback: '/dashboard',
+ * });
+ * router.push(returnUrl);
+ * ```
+ *
+ * @param url - URL to validate
+ * @param options - Validation options
+ * @returns Safe URL or fallback
+ */
+export declare function safeReturnUrl(url: string | null | undefined, options?: SafeReturnUrlOptions): string;
+/**
+ * Check if a navigation link is currently active.
+ *
+ * Features:
+ * - Removes trailing slashes and query parameters before comparison
+ * - Ignores external links (https://...) and hash links (#section)
+ * - Supports deep matching for nested routes
+ * - Handles query parameter paths correctly
+ *
+ * @example
+ * ```tsx
+ * // Basic usage
+ * isActiveLink('/dashboard', '/dashboard/user/list');     // true (deep match)
+ * isActiveLink('/dashboard', '/dashboard/user/list', false); // false (exact match)
+ *
+ * // Query parameters
+ * isActiveLink('/users', '/users?page=1');                // true
+ *
+ * // Hash links and external links
+ * isActiveLink('/home', '#section');                      // false
+ * isActiveLink('/home', 'https://example.com');           // false
+ *
+ * // Navigation items
+ * const navItems = [
+ *   { path: '/dashboard', label: 'Dashboard', exact: true },
+ *   { path: '/users', label: 'Users' },
+ *   { path: '/settings', label: 'Settings' },
+ * ];
+ *
+ * navItems.map(item => (
+ *   <NavItem
+ *     key={item.path}
+ *     active={isActiveLink(location.pathname, item.path, !item.exact)}
+ *   >
+ *     {item.label}
+ *   </NavItem>
+ * ));
+ * ```
+ *
+ * @param currentPathname - Current location pathname
+ * @param targetPath - The link's target path (can include query parameters)
+ * @param deep - Whether to perform deep matching for nested routes (default: true)
+ * @returns True if the link is active
+ */
+export declare function isActiveLink(currentPathname: string, targetPath: string, deep?: boolean): boolean;
+/**
+ * Check if a URL is external (different origin).
+ *
+ * @param url - URL to check
+ * @param currentOrigin - Current page origin (default: window.location.origin)
+ * @returns True if the URL is external
+ */
+export declare function isExternalUrl(url: string, currentOrigin?: string): boolean;
+/**
+ * Build a URL with query parameters.
+ *
+ * @example
+ * ```tsx
+ * const url = buildUrl('/search', {
+ *   q: 'hello world',
+ *   page: 1,
+ *   filter: ['active', 'recent'],
+ * });
+ * // Returns: '/search?q=hello+world&page=1&filter=active&filter=recent'
+ * ```
+ *
+ * @param base - Base URL path
+ * @param params - Query parameters
+ * @returns URL with query string
+ */
+export declare function buildUrl(base: string, params: Record<string, string | number | boolean | (string | number | boolean)[] | null | undefined>): string;
+/**
+ * Parse query parameters from a URL string.
+ *
+ * @param url - URL or query string
+ * @returns Parsed parameters
+ */
+export declare function parseQueryParams(url: string): Record<string, string | string[]>;
+/**
+ * Get a single query parameter value.
+ *
+ * @param url - URL or query string
+ * @param key - Parameter key
+ * @returns Parameter value or undefined
+ */
+export declare function getQueryParam(url: string, key: string): string | undefined;
+/**
+ * Check if a URL has query parameters.
+ *
+ * @param url - URL to check
+ * @returns True if URL has query parameters
+ *
+ * @example
+ * ```ts
+ * hasParams('/search?q=hello'); // true
+ * hasParams('/search');         // false
+ * ```
+ */
+export declare function hasParams(url: string): boolean;
+/**
+ * Remove query parameters from a URL.
+ *
+ * @param url - URL to process
+ * @returns URL without query parameters
+ *
+ * @example
+ * ```ts
+ * removeParams('/search?q=hello'); // '/search'
+ * removeParams('/search');         // '/search'
+ * ```
+ */
+export declare function removeParams(url: string): string;
+/**
+ * Remove trailing slash from a path.
+ *
+ * @param pathname - Path to process
+ * @returns Path without trailing slash
+ *
+ * @example
+ * ```ts
+ * removeLastSlash('/users/');  // '/users'
+ * removeLastSlash('/users');   // '/users'
+ * removeLastSlash('/');        // '/'
+ * ```
+ */
+export declare function removeLastSlash(pathname: string): string;
+/**
+ * Check if a URL is an external link (starts with http:// or https://).
+ *
+ * @param url - URL to check
+ * @returns True if external link
+ *
+ * @example
+ * ```ts
+ * isExternalLink('https://example.com'); // true
+ * isExternalLink('/about');              // false
+ * isExternalLink('#section');            // false
+ * ```
+ */
+export declare function isExternalLink(url: string): boolean;
+/**
+ * Compare two paths for equality (ignoring trailing slashes and query params).
+ *
+ * @param targetUrl - Target URL
+ * @param currentUrl - Current URL
+ * @param options - Comparison options
+ * @returns True if paths are equal
+ *
+ * @example
+ * ```ts
+ * isEqualPath('/users/', '/users');          // true
+ * isEqualPath('/users?page=1', '/users');    // true
+ * isEqualPath('/users', '/users/1', { deep: true }); // false
+ * ```
+ */
+export declare function isEqualPath(targetUrl: string, currentUrl: string, options?: {
+    deep?: boolean;
+}): boolean;
+//# sourceMappingURL=url.d.ts.map

package/dist/utils/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,qDAAqD;IACrD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,GAAE,oBAAyB,GAAG,MAAM,CAyCxG;AAgCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,YAAY,CAAC,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,OAAc,GAAG,OAAO,CAiCvG;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAsB1E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC,GACnG,MAAM,CAwBR;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAe/E;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAY5G"}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@omnitron-dev/prism",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Design System Constructor - High-level UI building blocks for complex frontends",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "_exportsNote": "Every subpath here is backed by a tsup entry in tsup.config.ts. The globs `./components/*` and `./blocks/*` used to be here and were not: they made every component directory resolvable to TypeScript while only three of them shipped JavaScript, so an import like `@omnitron-dev/prism/components/alert` typechecked and failed in the browser — the documentation recommended that style in 55 places. `./utils` was declared with no entry at all. Add an entry to tsup.config.ts and a line here together, or not at all.",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -27,21 +28,17 @@
       "types": "./dist/blocks/index.d.ts",
       "import": "./dist/blocks/index.js"
     },
-    "./blocks/*": {
-      "types": "./dist/blocks/*/index.d.ts",
-      "import": "./dist/blocks/*/index.js"
-    },
     "./components": {
       "types": "./dist/components/index.d.ts",
       "import": "./dist/components/index.js"
     },
-    "./components/*": {
-      "types": "./dist/components/*/index.d.ts",
-      "import": "./dist/components/*/index.js"
+    "./components/editor": {
+      "types": "./dist/components/editor/index.d.ts",
+      "import": "./dist/components/editor/index.js"
     },
-    "./utils": {
-      "types": "./dist/utils/index.d.ts",
-      "import": "./dist/utils/index.js"
+    "./components/emoji-picker": {
+      "types": "./dist/components/emoji-picker/index.d.ts",
+      "import": "./dist/components/emoji-picker/index.js"
     },
     "./state": {
       "types": "./dist/state/index.d.ts",
@@ -86,75 +83,81 @@
     "@emotion/react": "^11.14.0",
     "@emotion/styled": "^11.14.1",
     "@hookform/resolvers": "5.2.2",
-    "@mui/icons-material": "^9.0.1",
-    "@mui/material": "^9.0.1",
-    "@mui/system": "^9.0.1",
-    "@mui/x-data-grid": "^9.2.0",
-    "@mui/x-date-pickers": "^9.2.0",
-    "@tanstack/react-virtual": "^3.13.24",
-    "@tiptap/core": "^3.23.4",
-    "@tiptap/extension-code-block-lowlight": "^3.23.4",
-    "@tiptap/extension-image": "^3.23.4",
-    "@tiptap/extension-link": "^3.23.4",
-    "@tiptap/extension-placeholder": "^3.23.4",
-    "@tiptap/extension-task-item": "^3.23.4",
-    "@tiptap/extension-task-list": "^3.23.4",
-    "@tiptap/extension-text-align": "^3.23.4",
-    "@tiptap/extension-underline": "^3.23.4",
-    "@tiptap/pm": "^3.23.4",
-    "@tiptap/react": "^3.23.4",
-    "@tiptap/starter-kit": "^3.23.4",
+    "@mui/icons-material": "^9.4.0",
+    "@mui/material": "^9.4.0",
+    "@mui/system": "^9.4.0",
+    "@mui/x-data-grid": "^9.13.0",
+    "@mui/x-date-pickers": "^9.13.0",
+    "@tanstack/react-virtual": "^3.14.10",
+    "@tiptap/core": "^3.31.3",
+    "@tiptap/extension-code-block-lowlight": "^3.31.3",
+    "@tiptap/extension-image": "^3.31.3",
+    "@tiptap/extension-link": "^3.31.3",
+    "@tiptap/extension-placeholder": "^3.31.3",
+    "@tiptap/extension-task-item": "^3.31.3",
+    "@tiptap/extension-task-list": "^3.31.3",
+    "@tiptap/extension-text-align": "^3.31.3",
+    "@tiptap/extension-underline": "^3.31.3",
+    "@tiptap/pm": "^3.31.3",
+    "@tiptap/react": "^3.31.3",
+    "@tiptap/starter-kit": "^3.31.3",
     "@types/turndown": "^5.0.6",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "dayjs": "^1.11.20",
-    "framer-motion": "^12.38.0",
-    "immer": "^11.1.8",
+    "commander": "^14.0.3",
+    "dayjs": "^1.11.23",
+    "framer-motion": "^13.2.0",
+    "immer": "^11.1.18",
     "lowlight": "^3.3.0",
+    "maplibre-gl": "^6.7.0",
     "nprogress": "^0.2.0",
-    "react-dropzone": "^15.0.0",
-    "react-hook-form": "^7.75.0",
+    "pmtiles": "^4.5.0",
+    "react-dropzone": "^20.1.1",
+    "react-hook-form": "^7.87.0",
+    "react-map-gl": "^8.1.3",
     "react-markdown": "^10.1.0",
     "rehype-highlight": "^7.0.2",
     "rehype-raw": "^7.0.0",
+    "rehype-sanitize": "^6.0.0",
     "remark-gfm": "^4.0.1",
     "stylis": "^4.4.0",
     "stylis-plugin-rtl": "^2.1.1",
     "turndown": "^7.2.4",
-    "zod": "^4.4.3",
-    "zustand": "^5.0.13",
-    "@omnitron-dev/netron-browser": "0.2.0",
-    "@omnitron-dev/netron-react": "0.2.0"
+    "zod": "^4.5.4",
+    "zustand": "^5.0.15",
+    "@omnitron-dev/netron-browser": "0.3.0",
+    "@omnitron-dev/netron-react": "0.3.0"
   },
   "devDependencies": {
-    "@axe-core/playwright": "^4.11.3",
+    "@axe-core/playwright": "^4.13.0",
     "@mui/lab": "9.0.0-beta.3",
-    "@playwright/test": "^1.60.0",
-    "@testing-library/jest-dom": "^6.9.1",
-    "@testing-library/react": "^16.3.2",
-    "@testing-library/user-event": "^14.6.1",
-    "@types/node": "^25.8.0",
+    "@playwright/test": "^1.62.1",
+    "@testing-library/jest-dom": "^7.0.1",
+    "@testing-library/react": "^16.3.3",
+    "@testing-library/user-event": "^14.6.7",
+    "@types/node": "^25.9.5",
     "@types/nprogress": "^0.2.3",
-    "@types/react": "^19.2.14",
-    "@types/react-dom": "^19.2.3",
-    "@vitejs/plugin-react-swc": "^4.3.1",
-    "@vitest/coverage-v8": "^4.1.6",
-    "apexcharts": "^5.11.0",
-    "commander": "^14.0.3",
-    "happy-dom": "^20.9.0",
-    "react-apexcharts": "^2.1.0",
-    "react-router-dom": "^7.15.1",
-    "sonner": "^2.0.7",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.7",
+    "@vitejs/plugin-react-swc": "^4.3.3",
+    "@vitest/coverage-v8": "^5.0.0",
+    "apexcharts": "^7.1.0",
+    "happy-dom": "^20.14.0",
+    "react-apexcharts": "^2.1.1",
+    "react-router-dom": "7.18.3",
+    "sonner": "^2.0.8",
     "tsup": "^8.5.1",
-    "typescript": "^6.0.3",
-    "vite": "^8.0.13",
-    "vitest": "^4.1.6"
+    "typescript": "^7.0.2",
+    "vite": "^8.2.2",
+    "vitest": "^5.0.0"
   },
   "peerDependencies": {
     "apexcharts": ">=5.0.0",
     "react": "^19.0.0",
     "react-apexcharts": ">=1.8.0",
     "react-dom": "^19.0.0",
+    "react-router": "^7.0.0",
+    "react-router-dom": "^7.0.0",
     "sonner": "^2.0.0"
   },
   "peerDependenciesMeta": {
@@ -164,6 +167,12 @@
     "react-apexcharts": {
       "optional": true
     },
+    "react-router": {
+      "optional": true
+    },
+    "react-router-dom": {
+      "optional": true
+    },
     "sonner": {
       "optional": true
     }
@@ -186,11 +195,12 @@
     "url": "https://github.com/omnitron-dev/prism"
   },
   "scripts": {
-    "build": "tsup",
+    "build": "tsup && tsc -p tsconfig.build.json",
     "dev": "tsup --watch",
     "typecheck": "tsc --noEmit",
     "lint": "eslint src",
-    "test": "vitest",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
     "test:e2e": "playwright test",
     "test:e2e:ui": "playwright test --ui",
     "test:e2e:debug": "playwright test --debug",

package/dist/chunk-2FYNRDXR.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/components/popover/popover.tsx"],"names":[],"mappings":"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","file":"chunk-2FYNRDXR.js","sourcesContent":["'use client';\n\n/**\n * Popover Component\n *\n * Enhanced popover component with arrow support and useful hook.\n *\n * @module @omnitron-dev/prism/components/popover\n */\n\nimport type { ReactNode, MouseEvent, Dispatch, SetStateAction } from 'react';\nimport { useState, useCallback } from 'react';\nimport Popover from '@mui/material/Popover';\nimport { styled, alpha } from '@mui/material/styles';\nimport type { PopoverProps, PopoverOrigin } from '@mui/material/Popover';\nimport type { SxProps, Theme, CSSObject } from '@mui/material/styles';\nimport { listClasses } from '@mui/material/List';\nimport { menuItemClasses } from '@mui/material/MenuItem';\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\nexport type ArrowPlacement =\n  | 'top-left'\n  | 'top-center'\n  | 'top-right'\n  | 'bottom-left'\n  | 'bottom-center'\n  | 'bottom-right'\n  | 'left-top'\n  | 'left-center'\n  | 'left-bottom'\n  | 'right-top'\n  | 'right-center'\n  | 'right-bottom';\n\nexport interface PopoverArrowProps {\n  /** Hide the arrow */\n  hide?: boolean;\n  /** Arrow size in pixels */\n  size?: number;\n  /** Offset from edge */\n  offset?: number;\n  /** Arrow placement */\n  placement?: ArrowPlacement;\n  /** Additional styles */\n  sx?: SxProps<Theme>;\n}\n\nexport interface CustomPopoverProps extends Omit<PopoverProps, 'open'> {\n  /** Whether the popover is open */\n  open: boolean | Element | null;\n  /** Close handler */\n  onClose: () => void;\n  /** Arrow configuration */\n  arrow?: PopoverArrowProps;\n  /** Minimum width of the popover */\n  minWidth?: number | string;\n}\n\n// =============================================================================\n// UTILS\n// =============================================================================\n\nconst POPOVER_DISTANCE = 0.75;\n\ninterface AnchorOriginConfig {\n  paperStyles?: CSSObject;\n  anchorOrigin: PopoverOrigin;\n  transformOrigin: PopoverOrigin;\n}\n\nfunction calculateAnchorOrigin(arrow: ArrowPlacement = 'top-right'): AnchorOriginConfig {\n  const configs: Record<ArrowPlacement, AnchorOriginConfig> = {\n    'top-left': {\n      paperStyles: { ml: -POPOVER_DISTANCE },\n      anchorOrigin: { vertical: 'bottom', horizontal: 'left' },\n      transformOrigin: { vertical: 'top', horizontal: 'left' },\n    },\n    'top-center': {\n      paperStyles: undefined,\n      anchorOrigin: { vertical: 'bottom', horizontal: 'center' },\n      transformOrigin: { vertical: 'top', horizontal: 'center' },\n    },\n    'top-right': {\n      paperStyles: { ml: POPOVER_DISTANCE },\n      anchorOrigin: { vertical: 'bottom', horizontal: 'right' },\n      transformOrigin: { vertical: 'top', horizontal: 'right' },\n    },\n    'bottom-left': {\n      paperStyles: { ml: -POPOVER_DISTANCE },\n      anchorOrigin: { vertical: 'top', horizontal: 'left' },\n      transformOrigin: { vertical: 'bottom', horizontal: 'left' },\n    },\n    'bottom-center': {\n      paperStyles: undefined,\n      anchorOrigin: { vertical: 'top', horizontal: 'center' },\n      transformOrigin: { vertical: 'bottom', horizontal: 'center' },\n    },\n    'bottom-right': {\n      paperStyles: { ml: POPOVER_DISTANCE },\n      anchorOrigin: { vertical: 'top', horizontal: 'right' },\n      transformOrigin: { vertical: 'bottom', horizontal: 'right' },\n    },\n    'left-top': {\n      paperStyles: { mt: -POPOVER_DISTANCE },\n      anchorOrigin: { vertical: 'top', horizontal: 'right' },\n      transformOrigin: { vertical: 'top', horizontal: 'left' },\n    },\n    'left-center': {\n      paperStyles: undefined,\n      anchorOrigin: { vertical: 'center', horizontal: 'right' },\n      transformOrigin: { vertical: 'center', horizontal: 'left' },\n    },\n    'left-bottom': {\n      paperStyles: { mt: POPOVER_DISTANCE },\n      anchorOrigin: { vertical: 'bottom', horizontal: 'right' },\n      transformOrigin: { vertical: 'bottom', horizontal: 'left' },\n    },\n    'right-top': {\n      paperStyles: { mt: -POPOVER_DISTANCE },\n      anchorOrigin: { vertical: 'top', horizontal: 'left' },\n      transformOrigin: { vertical: 'top', horizontal: 'right' },\n    },\n    'right-center': {\n      paperStyles: undefined,\n      anchorOrigin: { vertical: 'center', horizontal: 'left' },\n      transformOrigin: { vertical: 'center', horizontal: 'right' },\n    },\n    'right-bottom': {\n      paperStyles: { mt: POPOVER_DISTANCE },\n      anchorOrigin: { vertical: 'bottom', horizontal: 'left' },\n      transformOrigin: { vertical: 'bottom', horizontal: 'right' },\n    },\n  };\n\n  return configs[arrow] || configs['top-right'];\n}\n\n// =============================================================================\n// ARROW COMPONENT\n// =============================================================================\n\ninterface ArrowStyledProps {\n  ownerState: {\n    size: number;\n    offset: number;\n    placement: ArrowPlacement;\n  };\n}\n\nconst Arrow = styled('span', {\n  shouldForwardProp: (prop) => prop !== 'ownerState',\n})<ArrowStyledProps>(({ theme, ownerState }) => {\n  const { size, offset, placement } = ownerState;\n\n  const directions: Record<string, CSSObject> = {\n    top: { top: 0, rotate: '135deg', translate: '0 -50%' },\n    bottom: { bottom: 0, rotate: '-45deg', translate: '0 50%' },\n    left: { left: 0, rotate: '45deg', translate: '-50% 0' },\n    right: { right: 0, rotate: '-135deg', translate: '50% 0' },\n  };\n\n  const getDirection = () => {\n    if (placement.startsWith('top-')) return directions.top;\n    if (placement.startsWith('bottom-')) return directions.bottom;\n    if (placement.startsWith('left-')) return directions.left;\n    if (placement.startsWith('right-')) return directions.right;\n    return {};\n  };\n\n  const getPosition = () => {\n    if (placement.endsWith('-left')) return { left: offset };\n    if (placement.endsWith('-right')) return { right: offset };\n    if (placement.endsWith('-top')) return { top: offset };\n    if (placement.endsWith('-bottom')) return { bottom: offset };\n    if (placement.endsWith('-center')) {\n      if (placement.startsWith('top-') || placement.startsWith('bottom-')) {\n        return { left: 0, right: 0, margin: 'auto' };\n      }\n      return { top: 0, bottom: 0, margin: 'auto' };\n    }\n    return {};\n  };\n\n  return {\n    width: size,\n    height: size,\n    position: 'absolute',\n    borderBottomLeftRadius: size / 4,\n    clipPath: 'polygon(0% 0%, 100% 100%, 0% 100%)',\n    backgroundColor: theme.palette.background.paper,\n    border: `solid 1px ${alpha(theme.palette.grey[500], 0.12)}`,\n    ...getDirection(),\n    ...getPosition(),\n  };\n});\n\n// =============================================================================\n// COMPONENT\n// =============================================================================\n\n/**\n * CustomPopover - Enhanced popover with arrow support.\n *\n * @example\n * ```tsx\n * const popover = usePopover();\n *\n * <Button onClick={popover.onOpen}>Open Menu</Button>\n *\n * <CustomPopover\n *   open={popover.open}\n *   onClose={popover.onClose}\n *   anchorEl={popover.anchorEl}\n *   arrow={{ placement: 'top-right' }}\n * >\n *   <MenuItem>Option 1</MenuItem>\n *   <MenuItem>Option 2</MenuItem>\n * </CustomPopover>\n * ```\n */\nexport function CustomPopover({\n  open,\n  onClose,\n  children,\n  anchorEl,\n  arrow,\n  minWidth = 140,\n  slotProps,\n  ...other\n}: CustomPopoverProps): ReactNode {\n  const arrowSize = arrow?.size ?? 14;\n  const arrowOffset = arrow?.offset ?? 17;\n  const arrowPlacement = arrow?.placement ?? 'top-right';\n  const hideArrow = arrow?.hide ?? false;\n\n  const { paperStyles, anchorOrigin, transformOrigin } = calculateAnchorOrigin(arrowPlacement);\n\n  const isOpen = Boolean(open);\n\n  return (\n    <Popover\n      open={isOpen}\n      anchorEl={anchorEl}\n      onClose={onClose}\n      anchorOrigin={anchorOrigin}\n      transformOrigin={transformOrigin}\n      slotProps={{\n        ...slotProps,\n        paper: {\n          ...(typeof slotProps?.paper === 'object' ? slotProps.paper : {}),\n          sx: [\n            paperStyles as SxProps<Theme>,\n            {\n              overflow: 'inherit',\n              [`& .${listClasses.root}`]: { minWidth },\n              [`& .${menuItemClasses.root}`]: { gap: 2 },\n            },\n            ...(typeof slotProps?.paper === 'object' && slotProps.paper && 'sx' in slotProps.paper\n              ? Array.isArray(slotProps.paper.sx)\n                ? slotProps.paper.sx\n                : [slotProps.paper.sx]\n              : []),\n          ],\n        },\n      }}\n      {...other}\n    >\n      {!hideArrow && (\n        <Arrow\n          ownerState={{\n            size: arrowSize,\n            offset: arrowOffset,\n            placement: arrowPlacement,\n          }}\n          sx={arrow?.sx}\n        />\n      )}\n      {children}\n    </Popover>\n  );\n}\n\n// =============================================================================\n// HOOK\n// =============================================================================\n\n/**\n * Return type for usePopover hook with generic element type.\n *\n * @typeParam T - The HTML element type (default: HTMLElement)\n */\nexport interface UsePopoverReturn<T extends HTMLElement = HTMLElement> {\n  /** Whether the popover is open */\n  open: boolean;\n  /** The anchor element (typed to T) */\n  anchorEl: T | null;\n  /** Open the popover - accepts MouseEvent with typed currentTarget */\n  onOpen: (event: MouseEvent<T>) => void;\n  /** Close the popover */\n  onClose: () => void;\n  /** Set the anchor element directly (typed to T | null) */\n  setAnchorEl: Dispatch<SetStateAction<T | null>>;\n}\n\n/**\n * usePopover - Generic hook for managing popover state.\n *\n * Type-safe hook that accepts a generic type parameter for the anchor element.\n * This ensures type safety when accessing `event.currentTarget` and `anchorEl`.\n *\n * @typeParam T - The HTML element type (default: HTMLElement)\n * @returns Popover state and controls with typed elements\n *\n * @example\n * ```tsx\n * // Basic usage with default HTMLElement\n * function MenuButton() {\n *   const popover = usePopover();\n *\n *   return (\n *     <>\n *       <IconButton onClick={popover.onOpen}>\n *         <MoreVertIcon />\n *       </IconButton>\n *\n *       <CustomPopover\n *         open={popover.open}\n *         onClose={popover.onClose}\n *         anchorEl={popover.anchorEl}\n *       >\n *         <MenuItem onClick={popover.onClose}>Edit</MenuItem>\n *         <MenuItem onClick={popover.onClose}>Delete</MenuItem>\n *       </CustomPopover>\n *     </>\n *   );\n * }\n *\n * // Type-safe usage with specific element type\n * function TypedButton() {\n *   const popover = usePopover<HTMLButtonElement>();\n *\n *   // TypeScript knows anchorEl is HTMLButtonElement | null\n *   // and onOpen accepts MouseEvent<HTMLButtonElement>\n *\n *   return (\n *     <>\n *       <button onClick={popover.onOpen}>Click me</button>\n *       <Popover open={popover.open} anchorEl={popover.anchorEl} onClose={popover.onClose}>\n *         Content here\n *       </Popover>\n *     </>\n *   );\n * }\n * ```\n */\nexport function usePopover<T extends HTMLElement = HTMLElement>(): UsePopoverReturn<T> {\n  const [anchorEl, setAnchorEl] = useState<T | null>(null);\n\n  const onOpen = useCallback((event: MouseEvent<T>) => {\n    setAnchorEl(event.currentTarget as T);\n  }, []);\n\n  const onClose = useCallback(() => {\n    setAnchorEl(null);\n  }, []);\n\n  return {\n    open: Boolean(anchorEl),\n    anchorEl,\n    onOpen,\n    onClose,\n    setAnchorEl,\n  };\n}\n"]}

package/dist/chunk-77KIJLPP.js

@@ -1,37 +0,0 @@
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __esm = (fn, res) => function __init() {
-  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
-};
-var __commonJS = (cb, mod) => function __require() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-export { __commonJS, __esm, __export, __toCommonJS, __toESM };
-//# sourceMappingURL=chunk-77KIJLPP.js.map
-//# sourceMappingURL=chunk-77KIJLPP.js.map

package/dist/chunk-77KIJLPP.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-77KIJLPP.js"}