@yoamigo.com/core 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import React, { ReactNode, CSSProperties } from 'react';
+import React$1, { ReactNode, CSSProperties } from 'react';
 export { C as ContentStoreProviderProd, d as MarkdownText, e as MarkdownTextProps, P as PageInfo, b as StaticImage, c as StaticImageProps, M as StaticText, S as StaticTextProps, Y as YaLink, f as YaLinkProps, u as useContentStoreProd } from './MarkdownText-BUTYfqXS.js';
 export { Link, LinkProps, NavigateFunction, Router, RouterProps, useNavigate } from './router.js';
 export { Route, Switch, useParams } from 'wouter';
@@ -7,6 +7,7 @@ export { A as AssetResolverFn, C as ContentRegistry, c as contentRegistry, a as
 export { i as initBuilderSelection } from './builder-selection-CYP91nRu.js';
 
 type EditMode = 'read-only' | 'inline-edit';
+type ChangeSource = 'user' | 'ai' | 'initial';
 interface PageInfo {
     path: string;
     label: string;
@@ -16,7 +17,8 @@ interface ActiveFieldCallbacks {
 }
 interface ContentStore {
     getValue: (fieldId: string) => string;
-    setValue: (fieldId: string, value: string) => void;
+    setValue: (fieldId: string, value: string, source?: ChangeSource) => void;
+    getChangeSource: (fieldId: string) => ChangeSource;
     mode: EditMode;
     setMode: (mode: EditMode) => void;
     subscribe: (listener: () => void) => () => void;
@@ -44,7 +46,7 @@ interface YaTextProps {
     className?: string;
     as?: YaTextElement;
     /** Optional fallback content (used if fieldId not in store) */
-    children?: React.ReactNode;
+    children?: React$1.ReactNode;
 }
 declare module '@tiptap/core' {
     interface Commands<ReturnType> {
@@ -125,7 +127,9 @@ interface YaVideoProps {
     objectFit?: 'cover' | 'contain' | 'fill';
     /** Loading strategy */
     loading?: 'lazy' | 'eager';
-    /** Fallback for backward compatibility */
+    /** Default video value (used when nothing in content store) */
+    defaultValue?: VideoFieldValue;
+    /** Fallback for backward compatibility (deprecated: use defaultValue) */
     fallbackSrc?: string;
     /** Fallback poster image */
     fallbackPoster?: string;
@@ -134,7 +138,7 @@ interface YaVideoProps {
  * Serialize video field value for storage
  */
 declare function serializeVideoValue(value: VideoFieldValue): string;
-declare function YaVideo({ fieldId, className, aspectRatio: propAspectRatio, objectFit: propObjectFit, loading, fallbackSrc, fallbackPoster, }: YaVideoProps): react_jsx_runtime.JSX.Element;
+declare function YaVideo({ fieldId, className, aspectRatio: propAspectRatio, objectFit: propObjectFit, loading, defaultValue, fallbackSrc, fallbackPoster, }: YaVideoProps): react_jsx_runtime.JSX.Element;
 
 interface BackgroundImageConfig {
     src: string;
@@ -191,6 +195,40 @@ interface SafeHtmlProps {
  */
 declare function SafeHtml({ content, className, mode }: SafeHtmlProps): react_jsx_runtime.JSX.Element;
 
+interface SafeTriangleBelowProps {
+    /** Ref to the trigger element */
+    triggerRef: React.RefObject<HTMLElement | null>;
+    /** Ref to the popover element */
+    popoverRef: React.RefObject<HTMLElement | null>;
+    /** Whether the popover is currently visible */
+    isVisible: boolean;
+    /** Called when mouse leaves the safe zone */
+    onLeave?: () => void;
+    /** Called when mouse stays inside the safe zone (cancels hide timeout) */
+    onStayInside?: () => void;
+}
+/**
+ * SafeTriangleBelow creates a safe zone between a trigger element and a popover,
+ * preventing the popover from closing when users move their mouse through the gap.
+ *
+ * The safe zone is a bounding box around both elements. Mouse position is tracked
+ * and onLeave is called when the mouse exits this zone.
+ *
+ * The SVG visualization is purely for debugging (pointer-events: none) -
+ * all mouse tracking is done via position checking, allowing clicks to pass through.
+ *
+ * Usage:
+ * ```tsx
+ * <SafeTriangleBelow
+ *   triggerRef={triggerRef}
+ *   popoverRef={popoverRef}
+ *   isVisible={isOpen}
+ *   onLeave={() => setIsOpen(false)}
+ * />
+ * ```
+ */
+declare function SafeTriangleBelow({ triggerRef, popoverRef, isVisible, onLeave, onStayInside, }: SafeTriangleBelowProps): null;
+
 /**
  * Animation state for a single field
  */
@@ -580,4 +618,61 @@ interface AnimatedTextOptions {
  */
 declare function useAnimatedText(fieldId: string, content: string, options?: AnimatedTextOptions): AnimatedTextResult;
 
-export { type AIEditContextValue, AIEditProvider, type AnimatedTextOptions, type AnimatedTextResult, type AnimationConfig, type AnimationMetadata, type AnimationOptions, type AnimationPhase, type AnimationResult, type AnimationState, type AnimationStrategy, type BackgroundConfig, type BackgroundImageConfig, type ContentStoreContextType, type ContentStoreMode, ContentStoreProvider, type ImageFieldValue, type ImageValue, type LinkValue, type OverlayConfig, SafeHtml, type SafeHtmlProps, type TextAnimationMetadata, type TextDiff, type VideoFieldValue, YaContainer, type YaContainerProps, YaImage, type YaImageProps, YaText, type YaTextProps, YaVideo, type YaVideoProps, buildIntermediateText, calculateAnimationTiming, computeTextDiff, containsHtml, getTextCursorPosition, imageCrossfadeStrategy, linkTransitionStrategy, parseBackgroundConfig, serializeBackgroundConfig, serializeImageValue, serializeVideoValue, stripHtml, textTypingStrategy, useAIEditAnimation, useAIEditContext, useAIEditContextOptional, useAnimatedText, useContentStore };
+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;
+    };
+    /** Props to spread on the SafeTriangleBelow component */
+    triangleProps: {
+        triggerRef: React.RefObject<T | null>;
+        popoverRef: React.RefObject<U | null>;
+        isVisible: boolean;
+        onLeave: () => void;
+        onStayInside: () => void;
+    };
+    /** Manually show the popover */
+    show: () => void;
+    /** Manually hide the popover */
+    hide: () => void;
+}
+/**
+ * Hook for managing safe triangle popover state.
+ * Handles show/hide delays and provides all necessary refs and handlers.
+ *
+ * @example
+ * ```tsx
+ * const { triggerRef, popoverRef, isVisible, handlers, triangleProps } = useSafeTriangle()
+ *
+ * return (
+ *   <div>
+ *     <a ref={triggerRef} {...handlers}>
+ *       Hover me
+ *     </a>
+ *     {isVisible && (
+ *       <div ref={popoverRef}>Popover content</div>
+ *     )}
+ *     <SafeTriangleBelow {...triangleProps} />
+ *   </div>
+ * )
+ * ```
+ */
+declare function useSafeTriangle<T extends HTMLElement = HTMLElement, U extends HTMLElement = HTMLDivElement>(options?: UseSafeTriangleOptions): UseSafeTriangleReturn<T, U>;
+
+export { type AIEditContextValue, AIEditProvider, type AnimatedTextOptions, type AnimatedTextResult, type AnimationConfig, type AnimationMetadata, type AnimationOptions, type AnimationPhase, type AnimationResult, type AnimationState, type AnimationStrategy, type BackgroundConfig, type BackgroundImageConfig, type ContentStoreContextType, type ContentStoreMode, ContentStoreProvider, type ImageFieldValue, type ImageValue, type LinkValue, type OverlayConfig, SafeHtml, type SafeHtmlProps, SafeTriangleBelow, type TextAnimationMetadata, type TextDiff, type VideoFieldValue, YaContainer, type YaContainerProps, YaImage, type YaImageProps, YaText, type YaTextProps, YaVideo, type YaVideoProps, buildIntermediateText, calculateAnimationTiming, computeTextDiff, containsHtml, getTextCursorPosition, imageCrossfadeStrategy, linkTransitionStrategy, parseBackgroundConfig, serializeBackgroundConfig, serializeImageValue, serializeVideoValue, stripHtml, textTypingStrategy, useAIEditAnimation, useAIEditContext, useAIEditContextOptional, useAnimatedText, useContentStore, useSafeTriangle };