@yoamigo.com/core 1.3.0 → 1.4.0

package/dist/{icon-metadata-D-2LGr22.d.ts → useSafeTriangle-D5RnB8wa.d.ts}

@@ -1,6 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import React__default, { ReactNode, CSSProperties, ComponentType } from 'react';
-import { IconProps } from '@tabler/icons-react';
+import React__default, { ReactNode, CSSProperties } from 'react';
 
 type EditMode = 'read-only' | 'inline-edit';
 interface ContentStore {
@@ -201,14 +200,27 @@ interface BackgroundImageConfig {
         y: number;
     };
 }
+interface GradientStop {
+    color: string;
+    position: number;
+}
+interface GradientConfig {
+    /** Gradient type: linear or radial */
+    gradientType: 'linear' | 'radial';
+    /** Angle in degrees for linear gradients (0 = to top, 90 = to right, 180 = to bottom, 270 = to left) */
+    angle?: number;
+    /** Color stops for the gradient */
+    stops: GradientStop[];
+}
 interface OverlayConfig {
     color: string;
     opacity: number;
 }
 interface BackgroundConfig {
-    type: 'none' | 'color' | 'image';
+    type: 'none' | 'color' | 'image' | 'gradient';
     backgroundColor?: string;
     backgroundImage?: BackgroundImageConfig;
+    gradient?: GradientConfig;
     overlay?: OverlayConfig;
 }
 interface YaContainerProps {
@@ -403,181 +415,73 @@ declare function embed(config: EmbedFieldValue): string;
  */
 declare function link(href: string): string;
 
-/**
- * DynamicIcon Component - Render icons by name with lazy loading
- *
- * This component loads Tabler icons dynamically to enable tree-shaking.
- * Icons are loaded on-demand and cached for subsequent renders.
- *
- * @example
- * ```tsx
- * // Basic usage
- * <DynamicIcon name="IconBrandTwitter" size={24} />
- *
- * // With custom styling
- * <DynamicIcon name="IconHeart" size={20} color="red" stroke={1.5} />
- *
- * // With fallback while loading
- * <DynamicIcon name="IconUser" size={24} fallback={<Spinner />} />
- * ```
- */
-
-interface DynamicIconProps extends Omit<IconProps, 'ref'> {
-    /** Name of the Tabler icon (e.g., "IconBrandTwitter", "IconHeart") */
-    name: string;
-    /** Optional fallback element to show while loading */
-    fallback?: React__default.ReactNode;
-    /** Additional class name for the icon wrapper */
-    className?: string;
+interface UseSafeTriangleOptions {
+    /** Delay before showing popover (ms) */
+    showDelay?: number;
+    /** Delay before hiding popover after mouse leaves (ms) */
+    hideDelay?: number;
+    /** Whether the hook is enabled (for edit mode check) */
+    enabled?: boolean;
+}
+interface UseSafeTriangleReturn<T extends HTMLElement, U extends HTMLElement> {
+    /** Ref to attach to the trigger element */
+    triggerRef: React.RefObject<T | null>;
+    /** Ref to attach to the popover element */
+    popoverRef: React.RefObject<U | null>;
+    /** Whether the popover should be visible */
+    isVisible: boolean;
+    /** Event handlers to spread on the trigger container */
+    handlers: {
+        onMouseEnter: () => void;
+        onMouseLeave: () => void;
+        onFocus: () => void;
+    };
+    /** Event handlers to spread on the popover element */
+    popoverHandlers: {
+        onMouseEnter: () => void;
+        onMouseLeave: () => void;
+    };
+    /** Manually show the popover */
+    show: () => void;
+    /** Manually hide the popover */
+    hide: () => void;
 }
 /**
- * Renders a Tabler icon by name with lazy loading.
- *
- * The component first checks the cache for an already-loaded icon.
- * If not found, it dynamically imports the icon and caches it.
- *
- * For production builds where specific icons are known ahead of time,
- * consider pre-registering icons with `registerIcon()` for faster initial render.
- */
-declare function DynamicIconComponent({ name, fallback, className, size, stroke, ...props }: DynamicIconProps): React__default.ReactElement | null;
-/**
- * Memoized DynamicIcon to prevent unnecessary re-renders.
- * Re-renders only when name or size/stroke props change.
- */
-declare const DynamicIcon: React__default.MemoExoticComponent<typeof DynamicIconComponent>;
-
-/**
- * Icon Registry - Dynamic import system with caching
- *
- * This module provides tree-shakeable icon loading:
- * - Pre-register icons for faster initial render (sync)
- * - Dynamic import for lazy loading (async)
- * - LRU-like cache to prevent memory bloat
- */
-
-type IconComponent = ComponentType<IconProps>;
-type IconLoader = () => Promise<{
-    default: IconComponent;
-}>;
-/**
- * Pre-register an icon with a custom loader.
- * Use this for icons that should be available immediately (e.g., commonly used icons).
+ * Hook for managing safe triangle popover state.
  *
- * @example
- * ```ts
- * // Pre-register for faster loading
- * registerIcon('IconBrandTwitter', () => import('@tabler/icons-react').then(m => ({ default: m.IconBrandTwitter })))
- * ```
- */
-declare function registerIcon(name: string, loader: IconLoader): void;
-/**
- * Pre-register multiple icons at once.
+ * Uses the centralized PopoverManager to coordinate between multiple
+ * YaLink/YaIcon instances, ensuring only one popover is active at a time.
  *
- * @example
- * ```ts
- * registerIcons({
- *   IconBrandTwitter: () => import('@tabler/icons-react').then(m => ({ default: m.IconBrandTwitter })),
- *   IconBrandFacebook: () => import('@tabler/icons-react').then(m => ({ default: m.IconBrandFacebook })),
- * })
- * ```
- */
-declare function registerIcons(loaders: Record<string, IconLoader>): void;
-/**
- * Get a cached icon component synchronously.
- * Returns null if the icon hasn't been loaded yet.
+ * ## How It Works
+ * 1. Registers this popover instance with PopoverManager on mount
+ * 2. Returns handlers to attach to trigger and popover elements
+ * 3. PopoverManager calls onShow/onHide callbacks to control `isVisible` state
  *
- * @example
- * ```ts
- * const Icon = getIcon('IconBrandTwitter')
- * if (Icon) {
- *   return <Icon size={24} />
- * }
- * ```
- */
-declare function getIcon(name: string): IconComponent | null;
-/**
- * Load an icon dynamically with caching.
- * Uses pre-registered loader if available, otherwise falls back to dynamic import.
+ * ## Stale Popover Handling
+ * When a popover is hidden, it may remain in the DOM briefly for exit animations
+ * (see YaLink's editPopoverState). During this time:
+ * - onPopoverEnter: Still fires, PopoverManager uses it to cancel active hide timers
+ * - onPopoverLeave: Filtered out here (stale popovers shouldn't start hide timers)
  *
- * @example
- * ```ts
- * const Icon = await loadIcon('IconBrandTwitter')
- * if (Icon) {
- *   return <Icon size={24} />
- * }
- * ```
- */
-declare function loadIcon(name: string): Promise<IconComponent | null>;
-/**
- * Preload multiple icons in parallel.
- * Useful for preloading icons that will be used soon.
+ * The CSS class `.is-hiding` should have `pointer-events: none` to prevent
+ * stale popovers from capturing clicks/hovers meant for the active popover.
  *
  * @example
- * ```ts
- * // Preload social icons before they're needed
- * await preloadIcons(['IconBrandTwitter', 'IconBrandFacebook', 'IconBrandInstagram'])
+ * ```tsx
+ * const { triggerRef, popoverRef, isVisible, handlers, popoverHandlers } = useSafeTriangle()
+ *
+ * return (
+ *   <div>
+ *     <a ref={triggerRef} {...handlers}>
+ *       Hover me
+ *     </a>
+ *     {isVisible && (
+ *       <div ref={popoverRef} {...popoverHandlers}>Popover content</div>
+ *     )}
+ *   </div>
+ * )
  * ```
  */
-declare function preloadIcons(names: string[]): Promise<void>;
-/**
- * Check if an icon is loaded and cached.
- */
-declare function isIconLoaded(name: string): boolean;
-
-/**
- * Icon Metadata - Curated list of commonly used icons
- *
- * This file contains ONLY metadata (strings) for search/filtering.
- * Actual icon components are loaded dynamically via icon-registry.ts
- *
- * Categories:
- * - brand: Social media and brand logos
- * - communication: Email, phone, chat
- * - media: Play, pause, volume, music
- * - navigation: Arrows, menu, home
- * - commerce: Cart, payment, shipping
- * - ui: Common UI elements
- * - files: Documents, folders
- * - weather: Weather icons
- * - misc: Miscellaneous useful icons
- *
- * Search Features:
- * - Keyword matching (exact substring)
- * - Alias matching (common abbreviations, rebrands)
- * - Fuzzy matching (typo tolerance via Levenshtein distance)
- */
-type IconCategory = 'brand' | 'communication' | 'media' | 'navigation' | 'commerce' | 'ui' | 'files' | 'weather' | 'misc';
-interface IconMeta {
-    name: string;
-    category: IconCategory;
-    keywords: string[];
-}
-/**
- * Curated list of ~150 commonly used icons
- * These cover most website builder use cases
- */
-declare const ICON_METADATA: IconMeta[];
-/**
- * Category display names for the icon picker UI
- */
-declare const ICON_CATEGORIES: Record<IconCategory, string>;
-/**
- * Get icons by category
- */
-declare function getIconsByCategory(category: IconCategory): IconMeta[];
-/**
- * Search icons by keyword, alias, or fuzzy name match
- */
-declare function searchIcons(query: string): IconMeta[];
-/**
- * Get icon metadata by name
- */
-declare function getIconMeta(name: string): IconMeta | undefined;
-/**
- * Get human-readable label from icon name
- * e.g., "IconBrandTwitter" -> "Twitter"
- * e.g., "IconShoppingCart" -> "Shopping Cart"
- */
-declare function getIconLabel(name: string): string;
+declare function useSafeTriangle<T extends HTMLElement = HTMLElement, U extends HTMLElement = HTMLDivElement>(options?: UseSafeTriangleOptions): UseSafeTriangleReturn<T, U>;
 
-export { serializeBackgroundConfig as $, getIconMeta as A, type IconCategory as B, ContentStoreProvider as C, DynamicIcon as D, type EditMode as E, type IconMeta as F, serializeImageValue as G, type YaImageProps as H, type IconComponent as I, type ImageFieldValue as J, YaVideo as K, serializeVideoValue as L, MpText as M, type YaVideoProps as N, YaEmbed as O, type PageInfo as P, serializeEmbedValue as Q, type YaEmbedProps as R, type StaticTextProps as S, type EmbedFieldValue as T, type EmbedType as U, type VideoFieldValue as V, YaLink as W, type YaLinkProps as X, YaImage as Y, YaContainer as Z, parseBackgroundConfig as _, type DynamicIconProps as a, type YaContainerProps as a0, type BackgroundConfig as a1, type BackgroundImageConfig as a2, type OverlayConfig as a3, background as b, registerIcons as c, loadIcon as d, embed as e, isIconLoaded as f, getIcon as g, type IconLoader as h, image as i, getIconLabel as j, type ContentStore as k, link as l, MpImage as m, type StaticImageProps as n, MarkdownText as o, preloadIcons as p, type MarkdownTextProps as q, registerIcon as r, parseEmbedUrl as s, text as t, useContentStore as u, video as v, ICON_METADATA as w, ICON_CATEGORIES as x, getIconsByCategory as y, searchIcons as z };
+export { YaContainer as A, parseBackgroundConfig as B, ContentStoreProvider as C, serializeBackgroundConfig as D, type EditMode as E, type YaContainerProps as F, type BackgroundConfig as G, type BackgroundImageConfig as H, type ImageFieldValue as I, MpText as M, type OverlayConfig as O, type PageInfo as P, type StaticTextProps as S, type VideoFieldValue as V, YaImage as Y, useContentStore as a, background as b, type ContentStore as c, MpImage as d, embed as e, type StaticImageProps as f, MarkdownText as g, type MarkdownTextProps as h, image as i, type YaImageProps as j, YaVideo as k, link as l, serializeVideoValue as m, type YaVideoProps as n, YaEmbed as o, parseEmbedUrl as p, serializeEmbedValue as q, type YaEmbedProps as r, serializeImageValue as s, text as t, useSafeTriangle as u, video as v, type EmbedFieldValue as w, type EmbedType as x, YaLink as y, type YaLinkProps as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yoamigo.com/core",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Core components, router, and utilities for YoAmigo templates",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",
@@ -34,10 +34,18 @@
     "./icons": {
       "types": "./dist/icons.d.ts",
       "import": "./dist/icons.js"
+    },
+    "./icons/custom": {
+      "types": "./dist/icons-custom.d.ts",
+      "import": "./dist/icons-custom.js"
     }
   },
+  "bin": {
+    "icon-scanner": "./bin/icon-scanner.cjs"
+  },
   "files": [
     "dist",
+    "bin",
     "LICENSE",
     "README.md"
   ],
@@ -65,6 +73,8 @@
     "typecheck": "tsc --noEmit",
     "lint": "eslint src --ext .ts,.tsx",
     "lint:check": "eslint src --ext .ts,.tsx",
+    "generate:icons": "tsx scripts/generate-icon-loaders.ts",
+    "prebuild": "pnpm generate:icons",
     "prepublishOnly": "pnpm build"
   },
   "dependencies": {