@yoamigo.com/core 1.3.0 → 1.4.1

package/dist/{icon-metadata-D-2LGr22.d.ts → useSafeTriangle-PCUZIdaA.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 {
@@ -303,6 +315,18 @@ declare function MarkdownText({ content, className }: MarkdownTextProps): react_
  * ```
  */
 
+/**
+ * Audio field value for linking audio assets to content fields.
+ * Used by audio players and other audio components.
+ */
+interface AudioFieldValue {
+    /** Asset ID from the website_assets table */
+    assetId: string;
+    /** Original filename */
+    filename: string;
+    /** CDN URL for the audio file */
+    url: string;
+}
 /**
  * Text content for YaText fields.
  *
@@ -402,182 +426,85 @@ declare function embed(config: EmbedFieldValue): string;
  * "footer.twitterLink.href": link("https://twitter.com/username"),
  */
 declare function link(href: string): string;
-
 /**
- * DynamicIcon Component - Render icons by name with lazy loading
+ * Audio field value for linking audio assets to content fields.
  *
- * This component loads Tabler icons dynamically to enable tree-shaking.
- * Icons are loaded on-demand and cached for subsequent renders.
+ * Used by audio players to link specific tracks to content slots.
+ * The assetId is used to look up the audio file from the API.
  *
  * @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 />} />
- * ```
+ * // In content.ts:
+ * "player.track1": audio({ assetId: "abc123", filename: "song.mp3", url: "/assets/song.mp3" }),
  */
+declare function audio(config: AudioFieldValue): string;
 
-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 { type AudioFieldValue as A, type YaLinkProps as B, ContentStoreProvider as C, YaContainer as D, type EditMode as E, parseBackgroundConfig as F, serializeBackgroundConfig as G, type YaContainerProps as H, type ImageFieldValue as I, type BackgroundConfig as J, type BackgroundImageConfig as K, MpText as M, type OverlayConfig as O, type PageInfo as P, type StaticTextProps as S, type VideoFieldValue as V, YaImage as Y, audio as a, background as b, useContentStore as c, type ContentStore as d, embed as e, MpImage as f, type StaticImageProps as g, MarkdownText as h, image as i, type MarkdownTextProps as j, type YaImageProps as k, link as l, YaVideo as m, serializeVideoValue as n, type YaVideoProps as o, parseEmbedUrl as p, YaEmbed as q, serializeEmbedValue as r, serializeImageValue as s, text as t, useSafeTriangle as u, video as v, type YaEmbedProps as w, type EmbedFieldValue as x, type EmbedType as y, YaLink as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yoamigo.com/core",
-  "version": "1.3.0",
+  "version": "1.4.1",
   "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": {