@yoamigo.com/core 1.0.1 → 1.1.0

package/dist/{api-client-D8FkeBAI.d.ts → api-client-BaZ_K5a6.d.ts}

@@ -1,11 +1,3 @@
-/**
- * API Client
- *
- * Handles communication with the backend API for:
- * - Email subscriptions
- * - Contact form submissions
- * - Product/cart operations (future)
- */
 /**
  * Subscribe to newsletter
  */

package/dist/{content-helpers-DOUKazMz.d.ts → icon-metadata-CVUpe16i.d.ts}

@@ -1,5 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import React$1, { ReactNode, CSSProperties } from 'react';
+import React$1, { ReactNode, CSSProperties, ComponentType } from 'react';
+import { IconProps } from '@tabler/icons-react';
 
 type EditMode = 'read-only' | 'inline-edit';
 interface ContentStore {
@@ -159,11 +160,23 @@ interface YaLinkProps {
     /** Available pages for href dropdown (injected by template) */
     availablePages?: PageInfo[];
     /** Optional click handler called after navigation */
-    onClick?: () => void;
+    onClick?: (e?: React$1.MouseEvent) => void;
     /** Target attribute for the link (e.g., "_blank" to open in new tab) */
     target?: string;
     /** Rel attribute for the link (e.g., "noopener noreferrer" for security) */
     rel?: string;
+    /** Title attribute for accessibility (tooltip on hover) */
+    title?: string;
+    /**
+     * Icon position relative to text. Uses fieldId.icon for icon name.
+     * - 'left': Icon before text (e.g., "🐦 Follow us")
+     * - 'right': Icon after text (e.g., "Learn more →")
+     * - 'only': Icon only, no text (e.g., social media buttons)
+     * - undefined: No icon, text only (default)
+     */
+    iconPosition?: 'left' | 'right' | 'only';
+    /** Icon size in pixels (default: 20 for left/right, 24 for only) */
+    iconSize?: number;
 }
 declare module '@tiptap/core' {
     interface Commands<ReturnType> {
@@ -177,7 +190,7 @@ declare module '@tiptap/core' {
         };
     }
 }
-declare function YaLink({ fieldId, href: defaultHref, className, wrapperClassName, style, as: Component, children, availablePages, onClick, target, rel }: YaLinkProps): react_jsx_runtime.JSX.Element;
+declare function YaLink({ fieldId, href: defaultHref, className, wrapperClassName, style, as: Component, children, availablePages, onClick, target, rel, title, iconPosition, iconSize }: YaLinkProps): react_jsx_runtime.JSX.Element;
 
 interface BackgroundImageConfig {
     src: string;
@@ -374,5 +387,197 @@ declare function video(config: VideoFieldValue): string;
  * embed({ type: "soundcloud", src: "user/track" })
  */
 declare function embed(config: EmbedFieldValue): string;
+/**
+ * Link field value for YaLink components (href only).
+ *
+ * YaLink uses compound fields: fieldId.text and fieldId.href
+ * Use this helper for the href value. The text is stored separately.
+ *
+ * @example
+ * // In content.ts:
+ * "hero.listenButton.href": link("#player"),
+ * "hero.listenButton.text": text("Listen to Preview"),
+ *
+ * // Or for external links:
+ * "footer.twitterLink.href": link("https://twitter.com/username"),
+ */
+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$1.ReactNode;
+    /** Additional class name for the icon wrapper */
+    className?: string;
+}
+/**
+ * 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$1.ReactElement | null;
+/**
+ * Memoized DynamicIcon to prevent unnecessary re-renders.
+ * Re-renders only when name or size/stroke props change.
+ */
+declare const DynamicIcon: React$1.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).
+ *
+ * @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.
+ *
+ * @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.
+ *
+ * @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.
+ *
+ * @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.
+ *
+ * @example
+ * ```ts
+ * // Preload social icons before they're needed
+ * await preloadIcons(['IconBrandTwitter', 'IconBrandFacebook', 'IconBrandInstagram'])
+ * ```
+ */
+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;
 
-export { serializeBackgroundConfig as A, type YaContainerProps as B, ContentStoreProvider as C, type BackgroundConfig as D, type EditMode as E, type BackgroundImageConfig as F, 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, type ContentStore as a, background as b, MpImage as c, type StaticImageProps as d, embed as e, MarkdownText as f, type MarkdownTextProps as g, type YaImageProps as h, image as i, YaVideo as j, serializeVideoValue as k, type YaVideoProps as l, YaEmbed as m, serializeEmbedValue as n, type YaEmbedProps as o, parseEmbedUrl as p, type EmbedFieldValue as q, type EmbedType as r, serializeImageValue as s, text as t, useContentStore as u, video as v, YaLink as w, type YaLinkProps as x, YaContainer as y, parseBackgroundConfig as z };
+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 };

package/dist/index.d.ts

@@ -1,11 +1,12 @@
 import { C as ChangeSource, Q as QueryFilter, b as CollectionRecord, o as CartItem, E as EditMode } from './cart-storage-DFdGPcwm.js';
 export { a as CollectionClient, d as CollectionClientConfig, t as ContentStoreContextType, v as ContentStoreMode, p as ContentStoreProvider, L as ListOptions, c as ListResponse, S as SingleResponse, f as clearSessionId, g as getCollectionClient, n as getLocalCartItemCount, k as getLocalCartItems, e as getSessionId, i as initBuilderSelection, r as resetCollectionClient, q as useContentStore } from './cart-storage-DFdGPcwm.js';
-export { D as BackgroundConfig, F as BackgroundImageConfig, C as ContentStoreProviderProd, q as EmbedFieldValue, r as EmbedType, I as ImageFieldValue, f as MarkdownText, g as MarkdownTextProps, O as OverlayConfig, P as PageInfo, c as StaticImage, d as StaticImageProps, M as StaticText, S as StaticTextProps, V as VideoFieldValue, y as YaContainer, B as YaContainerProps, m as YaEmbed, o as YaEmbedProps, Y as YaImage, h as YaImageProps, w as YaLink, x as YaLinkProps, j as YaVideo, l as YaVideoProps, b as background, e as embed, i as image, z as parseBackgroundConfig, p as parseEmbedUrl, A as serializeBackgroundConfig, n as serializeEmbedValue, s as serializeImageValue, k as serializeVideoValue, t as text, u as useContentStoreProd, v as video } from './content-helpers-DOUKazMz.js';
+export { a1 as BackgroundConfig, a2 as BackgroundImageConfig, C as ContentStoreProviderProd, D as DynamicIcon, a as DynamicIconProps, T as EmbedFieldValue, U as EmbedType, x as ICON_CATEGORIES, w as ICON_METADATA, B as IconCategory, I as IconComponent, h as IconLoader, F as IconMeta, J as ImageFieldValue, o as MarkdownText, q as MarkdownTextProps, a3 as OverlayConfig, P as PageInfo, m as StaticImage, n as StaticImageProps, M as StaticText, S as StaticTextProps, V as VideoFieldValue, Z as YaContainer, a0 as YaContainerProps, O as YaEmbed, R as YaEmbedProps, Y as YaImage, H as YaImageProps, W as YaLink, X as YaLinkProps, K as YaVideo, N as YaVideoProps, b as background, e as embed, g as getIcon, j as getIconLabel, A as getIconMeta, y as getIconsByCategory, i as image, f as isIconLoaded, l as link, d as loadIcon, _ as parseBackgroundConfig, s as parseEmbedUrl, p as preloadIcons, r as registerIcon, c as registerIcons, z as searchIcons, $ as serializeBackgroundConfig, Q as serializeEmbedValue, G as serializeImageValue, L as serializeVideoValue, t as text, u as useContentStoreProd, v as video } from './icon-metadata-CVUpe16i.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React$1, { ReactNode } from 'react';
 export { Link, LinkProps, NavigateFunction, RouteDefinition, Router, RouterProps, ScrollRestoration, createRouteDefinition, extractRouteParams, filePathToRoutePath, generatePath, sortRoutesBySpecificity, useNavigate } from './router.js';
 export { Route, Switch, useLocation, 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';
+import '@tabler/icons-react';
 
 /** Common HTML elements that YaText can render as */
 type YaTextElement = 'span' | 'div' | 'p' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'label' | 'strong' | 'em';
@@ -30,6 +31,58 @@ declare module '@tiptap/core' {
 }
 declare function YaText({ fieldId, className, as: Component, children }: YaTextProps): react_jsx_runtime.JSX.Element;
 
+type AccessRule = 'PUBLIC' | 'EMAIL_SIGNUP' | 'SUBSCRIBERS_ONLY' | 'PASSWORD_PROTECTED';
+interface AssetAccessInfo {
+    assetId: string;
+    filename: string;
+    fileType: string;
+    folderId?: string;
+    folderName?: string;
+    accessRule: AccessRule;
+    showPreview: boolean;
+    previewDuration: number;
+    requiresAuth: boolean;
+    authType: 'email' | 'password' | 'subscriber' | null;
+    url?: string;
+}
+interface YaProtectedMediaProps {
+    /** Field ID for the asset */
+    fieldId: string;
+    /** Asset ID from the database */
+    assetId: string;
+    /** Media type: audio or video */
+    type: 'audio' | 'video';
+    /** Optional CSS class name */
+    className?: string;
+    /** Preview poster image for video */
+    poster?: string;
+    /** Default aspect ratio (for video) */
+    aspectRatio?: string;
+    /** Optional title/label for the media */
+    title?: string;
+    /** Called when unlock is successful */
+    onUnlock?: () => void;
+    /** Called when unlock fails */
+    onUnlockError?: (error: string) => void;
+}
+declare function YaProtectedMedia({ fieldId, assetId, type, className, poster, aspectRatio, title, onUnlock, onUnlockError, }: YaProtectedMediaProps): react_jsx_runtime.JSX.Element | null;
+
+interface YaIconProps {
+    /** Field ID for content storage - icon name stored at fieldId.icon */
+    fieldId: string;
+    /** Default icon name if none set in content store (e.g., "IconHeart") */
+    fallback?: string;
+    /** Icon size in pixels (default: 24) */
+    size?: number;
+    /** Icon stroke width (default: 2) */
+    stroke?: number;
+    /** Additional classes for the icon itself */
+    className?: string;
+    /** Classes for the wrapper span (edit mode only) */
+    wrapperClassName?: string;
+}
+declare function YaIcon({ fieldId, fallback, size, stroke, className, wrapperClassName, }: YaIconProps): react_jsx_runtime.JSX.Element | null;
+
 /**
  * SafeHtml Component - Secure HTML Renderer
  *
@@ -1731,4 +1784,19 @@ interface UseSubscriptionStatusResult {
  */
 declare function useSubscriptionStatus(options: UseSubscriptionStatusOptions): UseSubscriptionStatusResult;
 
-export { type AIEditContextValue, AIEditProvider, type AnimatedTextOptions, type AnimatedTextResult, type AnimationConfig, type AnimationMetadata, type AnimationOptions, type AnimationPhase, type AnimationResult, type AnimationState, type AnimationStrategy, type AnyField, CartItem, CartProvider, type CartProviderProps, type CheckoutOptions, type CheckoutResult, type CheckoutSessionStatus, type CollectionContentContextValue, CollectionContentProvider, type CollectionContentProviderProps, type CollectionData, CollectionDetailPage, type CollectionDetailPageProps, type CollectionDetailRenderProps, CollectionItem, type CollectionItemProps, type CollectionItemRenderProps, CollectionList, type CollectionListData, CollectionListPage, type CollectionListPageProps, type CollectionListPaginationProps, type CollectionListProps, type CollectionListRenderProps, CollectionRecord, type ContainerField, type ContentHandle, type CustomerPortalParams, type CustomerPortalResult, type EmbedField, type ImageField, type ImageValue, type LinkField, type LinkValue, type Product, QueryFilter, SafeHtml, type SafeHtmlProps, SafeTriangleBelow, type SubscribeParams, type SubscribeResult, type SubscriptionDetails, type SubscriptionPrice, type SubscriptionProduct, type SubscriptionStatusResult, type SubscriptionStatusType, type SubscriptionTier, type TextAnimationMetadata, type TextDiff, type TextField, Tooltip, type TooltipProps, type UseCartOptions, type UseCartResult, type UseCheckoutOptions, type UseCheckoutResult, type UseCheckoutStatusOptions, type UseCheckoutStatusResult, type UseCollectionListOptions, type UseCollectionListResult, type UseCollectionRecordOptions, type UseCollectionRecordResult, type UseCustomerPortalOptions, type UseCustomerPortalResult, type UseProductOptions, type UseProductResult, type UseProductsOptions, type UseProductsResult, type UseSubscriptionOptions, type UseSubscriptionResult, type UseSubscriptionStatusOptions, type UseSubscriptionStatusResult, type UseSubscriptionTiersOptions, type UseSubscriptionTiersResult, type VideoField, YaText, type YaTextProps, buildIntermediateText, calculateAnimationTiming, computeTextDiff, containsHtml, getTextCursorPosition, imageCrossfadeStrategy, linkTransitionStrategy, parseFieldValue, stringifyFieldValue, stripHtml, textTypingStrategy, useAIEditAnimation, useAIEditContext, useAIEditContextOptional, useAnimatedText, useCart, useCartContext, useCheckout, useCheckoutStatus, useCollectionContent, useCollectionList, useCollectionRecord, useContent, useCustomerPortal, useOptionalCartContext, useProduct, useProducts, useSafeTriangle, useSubscription, useSubscriptionStatus, useSubscriptionTiers };
+interface IconPickerProps {
+    /** Currently selected icon name (e.g., "IconBrandTwitter") */
+    value: string | null;
+    /** Callback when icon is selected */
+    onChange: (iconName: string | null) => void;
+    /** Callback to close the picker */
+    onClose: () => void;
+}
+/**
+ * Get display label for the icon picker trigger
+ */
+declare function getIconPickerLabel(value: string | null): string;
+
+declare function IconPicker({ value, onChange, onClose }: IconPickerProps): react_jsx_runtime.JSX.Element;
+
+export { type AIEditContextValue, AIEditProvider, type AccessRule, type AnimatedTextOptions, type AnimatedTextResult, type AnimationConfig, type AnimationMetadata, type AnimationOptions, type AnimationPhase, type AnimationResult, type AnimationState, type AnimationStrategy, type AnyField, type AssetAccessInfo, CartItem, CartProvider, type CartProviderProps, type CheckoutOptions, type CheckoutResult, type CheckoutSessionStatus, type CollectionContentContextValue, CollectionContentProvider, type CollectionContentProviderProps, type CollectionData, CollectionDetailPage, type CollectionDetailPageProps, type CollectionDetailRenderProps, CollectionItem, type CollectionItemProps, type CollectionItemRenderProps, CollectionList, type CollectionListData, CollectionListPage, type CollectionListPageProps, type CollectionListPaginationProps, type CollectionListProps, type CollectionListRenderProps, CollectionRecord, type ContainerField, type ContentHandle, type CustomerPortalParams, type CustomerPortalResult, type EmbedField, IconPicker, type IconPickerProps, type ImageField, type ImageValue, type LinkField, type LinkValue, type Product, QueryFilter, SafeHtml, type SafeHtmlProps, SafeTriangleBelow, type SubscribeParams, type SubscribeResult, type SubscriptionDetails, type SubscriptionPrice, type SubscriptionProduct, type SubscriptionStatusResult, type SubscriptionStatusType, type SubscriptionTier, type TextAnimationMetadata, type TextDiff, type TextField, Tooltip, type TooltipProps, type UseCartOptions, type UseCartResult, type UseCheckoutOptions, type UseCheckoutResult, type UseCheckoutStatusOptions, type UseCheckoutStatusResult, type UseCollectionListOptions, type UseCollectionListResult, type UseCollectionRecordOptions, type UseCollectionRecordResult, type UseCustomerPortalOptions, type UseCustomerPortalResult, type UseProductOptions, type UseProductResult, type UseProductsOptions, type UseProductsResult, type UseSubscriptionOptions, type UseSubscriptionResult, type UseSubscriptionStatusOptions, type UseSubscriptionStatusResult, type UseSubscriptionTiersOptions, type UseSubscriptionTiersResult, type VideoField, YaIcon, type YaIconProps, YaProtectedMedia, type YaProtectedMediaProps, YaText, type YaTextProps, buildIntermediateText, calculateAnimationTiming, computeTextDiff, containsHtml, getIconPickerLabel, getTextCursorPosition, imageCrossfadeStrategy, linkTransitionStrategy, parseFieldValue, stringifyFieldValue, stripHtml, textTypingStrategy, useAIEditAnimation, useAIEditContext, useAIEditContextOptional, useAnimatedText, useCart, useCartContext, useCheckout, useCheckoutStatus, useCollectionContent, useCollectionList, useCollectionRecord, useContent, useCustomerPortal, useOptionalCartContext, useProduct, useProducts, useSafeTriangle, useSubscription, useSubscriptionStatus, useSubscriptionTiers };