@yoamigo.com/core 0.1.15 → 0.2.2

package/dist/{MarkdownText-BUTYfqXS.d.ts → MarkdownText-kV5IiAma.d.ts}

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import React$1, { ReactNode } from 'react';
+import React__default, { ReactNode } from 'react';
 
 type EditMode = 'read-only' | 'inline-edit';
 interface ContentStore {
@@ -28,9 +28,9 @@ interface YaLinkProps {
     href?: string;
     className?: string;
     /** Inline styles to apply to the link element */
-    style?: React$1.CSSProperties;
+    style?: React__default.CSSProperties;
     as?: 'a' | 'span';
-    children?: React$1.ReactNode;
+    children?: React__default.ReactNode;
     /** Available pages for href dropdown (injected by template) */
     availablePages?: PageInfo[];
     /** Optional click handler called after navigation */

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import React, { ReactNode } 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';
+import * as React$1 from 'react';
+import React__default, { 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-kV5IiAma.js';
 export { Link, LinkProps, NavigateFunction, Router, RouterProps, useNavigate } from './router.js';
 export { Route, Switch, useParams } from 'wouter';
 export { A as AssetResolverFn, C as ContentRegistry, c as contentRegistry, a as getAllContent, g as getContent, h as hasContent, r as registerContent, b as resolveAssetUrl, s as setAssetResolver } from './asset-resolver-BnIvDkVv.js';
@@ -26,8 +27,7 @@ interface ContentStore {
     clearActiveField: () => void;
     getPages: () => PageInfo[];
 }
-interface ContentStoreContextType extends ContentStore {
-}
+type ContentStoreContextType = ContentStore;
 type ContentStoreMode = EditMode;
 declare function useContentStore(): ContentStoreContextType;
 interface ContentStoreProviderProps {
@@ -45,7 +45,7 @@ interface YaTextProps {
     className?: string;
     as?: YaTextElement;
     /** Optional fallback content (used if fieldId not in store) */
-    children?: React.ReactNode;
+    children?: React__default.ReactNode;
 }
 declare module '@tiptap/core' {
     interface Commands<ReturnType> {
@@ -89,6 +89,94 @@ interface YaImageProps {
 declare function serializeImageValue(value: ImageFieldValue): string;
 declare function YaImage({ fieldId, className, alt, objectFit: propObjectFit, objectPosition: propObjectPosition, loading, fallbackSrc, fallbackAlt, }: YaImageProps): react_jsx_runtime.JSX.Element;
 
+interface VideoFieldValue {
+    /** Video source type */
+    type: 'upload' | 'youtube' | 'vimeo';
+    /** Video URL (for upload) or video ID (for embeds) */
+    src: string;
+    /** Poster image URL */
+    poster?: string;
+    /** Autoplay video (requires muted for browser policy) */
+    autoplay?: boolean;
+    /** Mute video audio */
+    muted?: boolean;
+    /** Loop video playback */
+    loop?: boolean;
+    /** Show video controls */
+    controls?: boolean;
+    /** Play inline on mobile (prevent fullscreen hijack) */
+    playsinline?: boolean;
+    /** Preload strategy */
+    preload?: 'none' | 'metadata' | 'auto';
+    /** CSS object-fit */
+    objectFit?: 'cover' | 'contain' | 'fill';
+    /** CSS aspect-ratio (e.g., "16/9") */
+    aspectRatio?: string;
+    /** Start playback at this time (seconds) */
+    startTime?: number;
+    /** End playback at this time (seconds) */
+    endTime?: number;
+}
+interface YaVideoProps {
+    fieldId: string;
+    className?: string;
+    /** Default aspect ratio from props */
+    aspectRatio?: string;
+    /** Default object-fit */
+    objectFit?: 'cover' | 'contain' | 'fill';
+    /** Loading strategy */
+    loading?: 'lazy' | 'eager';
+    /** 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;
+}
+/**
+ * Serialize video field value for storage
+ */
+declare function serializeVideoValue(value: VideoFieldValue): string;
+declare function YaVideo({ fieldId, className, aspectRatio: propAspectRatio, objectFit: propObjectFit, loading, defaultValue, fallbackSrc, fallbackPoster, }: YaVideoProps): react_jsx_runtime.JSX.Element;
+
+interface BackgroundImageConfig {
+    src: string;
+    objectFit?: 'cover' | 'contain' | 'fill';
+    objectPosition?: string;
+    focalPoint?: {
+        x: number;
+        y: number;
+    };
+}
+interface OverlayConfig {
+    color: string;
+    opacity: number;
+}
+interface BackgroundConfig {
+    type: 'none' | 'color' | 'image';
+    backgroundColor?: string;
+    backgroundImage?: BackgroundImageConfig;
+    overlay?: OverlayConfig;
+}
+interface YaContainerProps {
+    fieldId: string;
+    className?: string;
+    style?: CSSProperties;
+    as?: 'section' | 'div' | 'article' | 'header' | 'footer' | 'main' | 'aside';
+    children: ReactNode;
+    /** Fallback background config if not in store */
+    defaultBackground?: BackgroundConfig;
+}
+/**
+ * Parse background config from content store
+ */
+declare function parseBackgroundConfig(value: string): BackgroundConfig;
+/**
+ * Serialize background config for storage
+ */
+declare function serializeBackgroundConfig(config: BackgroundConfig): string;
+declare function YaContainer({ fieldId, className, style, as: Tag, children, defaultBackground, }: YaContainerProps): react_jsx_runtime.JSX.Element;
+
 /**
  * SafeHtml Component - Secure HTML Renderer
  *
@@ -106,6 +194,39 @@ 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;
+}
+/**
+ * SafeTriangleBelow creates a dynamic SVG triangle between the cursor and a popover
+ * that appears below the trigger, preventing the popover from closing when users
+ * move diagonally toward it.
+ *
+ * Based on the "Safe Triangle" pattern:
+ * @see https://www.smashingmagazine.com/2023/08/better-context-menus-safe-triangles/
+ *
+ * This variant is for popovers that appear BELOW the trigger (vs SafeTriangle which
+ * is for tooltips appearing to the RIGHT).
+ *
+ * Usage:
+ * ```tsx
+ * <SafeTriangleBelow
+ *   triggerRef={triggerRef}
+ *   popoverRef={popoverRef}
+ *   isVisible={isOpen}
+ *   onLeave={() => setIsOpen(false)}
+ * />
+ * ```
+ */
+declare function SafeTriangleBelow({ triggerRef, popoverRef, isVisible, onLeave, }: SafeTriangleBelowProps): React$1.ReactPortal | null;
+
 /**
  * Animation state for a single field
  */
@@ -495,4 +616,60 @@ 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 ContentStoreContextType, type ContentStoreMode, ContentStoreProvider, type ImageFieldValue, type ImageValue, type LinkValue, SafeHtml, type SafeHtmlProps, type TextAnimationMetadata, type TextDiff, YaImage, type YaImageProps, YaText, type YaTextProps, buildIntermediateText, calculateAnimationTiming, computeTextDiff, containsHtml, getTextCursorPosition, imageCrossfadeStrategy, linkTransitionStrategy, serializeImageValue, 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;
+    };
+    /** 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 };