@levo-so/studio 0.1.60 → 0.1.62

package/dist/bridge/StudioPreview.d.ts

@@ -1,6 +1,6 @@
 import { IWorkspace } from '@levo-so/core';
-import { IBlockInstance, IPageExpanded, ITheme, BlockComponent, ISite } from '../interfaces';
 import { IPageDataContext } from '../contentEngine';
+import { BlockComponent, IBlockInstance, IPageExpanded, ISite, ITheme } from '../interfaces';
 export type StudioData = {
     pageData?: {
         pageData: IPageExpanded;

package/dist/bridge/hooks/useElementTracker.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Tracks an element's position every frame via a shared rAF loop.
+ * Handles moving elements (carousels, animations), scroll, resize, and DOM removal.
+ */
+export declare function useElementTracker(element: HTMLElement | null): {
+    highlightRef: import('react').RefObject<HTMLDivElement | null>;
+    isVisible: boolean;
+};
+//# sourceMappingURL=useElementTracker.d.ts.map

package/dist/bridge/index.d.ts

@@ -1,6 +1,6 @@
-export * from './PreviewHighlighter';
-export * from './types';
 export * from './constants';
-export * from './StudioPreview';
 export { MESSAGE_TYPES } from './constants';
+export * from './PreviewHighlighter';
+export * from './StudioPreview';
+export * from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/bridge/utils.d.ts

@@ -1,16 +1,13 @@
-import { ISelection, HighlightRect, IUserHighlight, ISocketUser, SelectionState, IGenerationStatusOverlay, IBlockGenerationInfo } from './types';
+import { HighlightRect, IBlockGenerationInfo, IGenerationStatusOverlay, ISelection, ISocketUser, IUserHighlight, SelectionState } from './types';
 export declare function getElementCoordinates(element: HTMLElement): HighlightRect;
 export declare function getSelectionFromElement(element: HTMLElement): ISelection | null;
 export declare function findElementBySelection(selection: ISelection): HTMLElement | null;
 export declare function createSelectionState(element: HTMLElement, type: "selected" | "hovered"): SelectionState;
 export declare function findParentElement(currentSelections: SelectionState): HTMLElement | null;
-export declare function updateSelectionRects(selections: SelectionState): SelectionState;
 export declare function findBlockElementById(blockId: string): HTMLElement | null;
 export declare function createUserHighlight(user: ISocketUser): IUserHighlight | null;
 export declare function createUserHighlights(users: ISocketUser[]): IUserHighlight[];
-export declare function updateUserHighlightRects(highlights: IUserHighlight[]): IUserHighlight[];
 export declare function isElementWithinUserSelectedBlock(element: HTMLElement, userHighlights: IUserHighlight[]): boolean;
 export declare function createGenerationStatusOverlay(blockInfo: IBlockGenerationInfo): IGenerationStatusOverlay | null;
 export declare function createGenerationStatusOverlays(blocksInfo: IBlockGenerationInfo[]): IGenerationStatusOverlay[];
-export declare function updateGenerationStatusOverlayRects(overlays: IGenerationStatusOverlay[]): IGenerationStatusOverlay[];
 //# sourceMappingURL=utils.d.ts.map

package/dist/components/AnimatedBlock.d.ts

@@ -0,0 +1,50 @@
+import { ComponentType, ReactNode } from 'react';
+import { AnimationProperties, ScrollAnimationOffset, TransitionConfig, ViewportConfig } from '../interfaces';
+/** Children accepted by AnimatedBlock */
+type BlockChildren = ReactNode;
+/** Scroll-linked animation configuration */
+interface IScrollConfig {
+    /** Starting animation state */
+    from: AnimationProperties;
+    /** Ending animation state */
+    to: AnimationProperties;
+    /** Scroll offset range for animation timeline */
+    offset: ScrollAnimationOffset;
+}
+/** Entry (viewport-triggered) animation configuration */
+interface IEntryConfig {
+    /** Starting animation state */
+    from: AnimationProperties;
+    /** Ending animation state */
+    to: AnimationProperties;
+    /** Transition timing config */
+    transition?: TransitionConfig;
+    /** Viewport detection options */
+    viewport?: ViewportConfig;
+}
+/** Props for AnimatedBlock component */
+interface IAnimatedBlockProps {
+    /** Content to render inside the animated container */
+    children: BlockChildren;
+    /** Motion component to render (e.g., motion.div) */
+    MotionComponent: ComponentType<Record<string, unknown>>;
+    /** Props forwarded to the Motion component */
+    motionProps: Record<string, unknown>;
+    /** Scroll animation config — timeline tied to scroll position */
+    scroll?: IScrollConfig;
+    /** Entry animation config — plays once when entering viewport */
+    entry?: IEntryConfig;
+    /** Hover animation state */
+    whileHover?: unknown;
+    /** Exit animation state */
+    exit?: unknown;
+}
+/**
+ * AnimatedBlock - Unified animation component for studio elements
+ *
+ * Handles both entry (viewport-triggered) and scroll-linked animations.
+ * Entry and scroll are mutually exclusive - scroll takes precedence if both provided.
+ */
+declare const AnimatedBlock: React.FC<IAnimatedBlockProps>;
+export default AnimatedBlock;
+//# sourceMappingURL=AnimatedBlock.d.ts.map

package/dist/components/backgroundPresets/exports.d.ts

@@ -1,5 +1,5 @@
 export { default as BackgroundEffects } from './index';
-export * from './presets';
 export * from './presetSystem';
+export * from './presets';
 export * from './presetUtils';
 //# sourceMappingURL=exports.d.ts.map

package/dist/components/backgroundPresets/presetSystem.d.ts

@@ -4,7 +4,7 @@
  * This module provides a complete preset system for background effects,
  * including built-in presets and application logic.
  */
-export { BUILT_IN_PRESETS, PRESET_CATEGORIES, PRESET_MAP, getPresetsByCategory, getAvailableCategories, } from './presets';
+export type { BackgroundEffectConfig, BackgroundPreset, } from '../../interfaces';
+export { BUILT_IN_PRESETS, getAvailableCategories, getPresetsByCategory, PRESET_CATEGORIES, PRESET_MAP, } from './presets';
 export { getEffectConfigFromPresetId, type PresetOperationResult, } from './presetUtils';
-export type { BackgroundPreset, BackgroundEffectConfig, } from '../../interfaces';
 //# sourceMappingURL=presetSystem.d.ts.map

package/dist/components/bookingCard/BookingCard.d.ts

@@ -0,0 +1,65 @@
+import { default as React } from 'react';
+/**
+ * Tax line item from booking calculation
+ * Note: percentage is included in label (e.g., "GST 18%")
+ */
+export interface ITaxLineItem {
+    id: string;
+    label: string;
+    amount: number;
+}
+/**
+ * Booking summary from create booking API
+ */
+export interface IBookingSummary {
+    _id: string;
+    instance_label: string;
+    /** Collection/form name (e.g., "Registration Form") */
+    context_label: string;
+    cover_image: {
+        location: string;
+    } | null;
+    /** QR code image for check-in scanning */
+    qr_image: {
+        location: string;
+    } | null;
+    /** Invoice PDF file, null if not generated */
+    invoice: {
+        location: string;
+    } | null;
+    starts_at: string | null;
+    ends_at: string | null;
+    quantity: number;
+    currency: string;
+    unit_amount: number;
+    total_amount: number;
+    status: string;
+    paid: boolean;
+    /** User-submitted form fields */
+    form_data: Record<string, unknown>;
+    /** Tax line items breakdown */
+    taxes?: ITaxLineItem[];
+    /** Whether tax is included in unit_amount */
+    tax_inclusive?: boolean;
+    /** Discount amount applied */
+    discount?: number;
+}
+export interface IBookingCardProps {
+    summary: IBookingSummary;
+    onComplete?: () => void;
+    className?: string;
+}
+/**
+ * BookingCard
+ *
+ * Inline card for booking payment flow (not a modal):
+ * - Summary: Shows booking details and "Pay Now" button
+ * - Processing: Shows loading state during payment
+ * - Failed: Shows error with retry option
+ * - Confirmed: Shows success message after payment
+ *
+ * For free bookings (status = confirmed), shows confirmation directly.
+ */
+export declare const BookingCard: React.FC<IBookingCardProps>;
+export default BookingCard;
+//# sourceMappingURL=BookingCard.d.ts.map

package/dist/components/bookingCard/index.d.ts

@@ -0,0 +1,2 @@
+export { BookingCard, type IBookingCardProps, type IBookingSummary, type ITaxLineItem, } from './BookingCard';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/bookingModal/BookingConfirmation.d.ts

@@ -0,0 +1,48 @@
+import { default as React } from 'react';
+interface IBookingRecord {
+    _id: string;
+    status: string;
+    paid: boolean;
+    unit_amount: number;
+    currency: string;
+    quantity: number;
+    instance_label?: string;
+}
+interface IBookingSummaryData {
+    _id: string;
+    instance_label: string;
+    cover_image: {
+        location: string;
+    } | null;
+    /** QR code image for check-in scanning */
+    qr_image: {
+        location: string;
+    } | null;
+    /** Invoice PDF file, null if not generated */
+    invoice: {
+        location: string;
+    } | null;
+    starts_at: string | null;
+    ends_at: string | null;
+    quantity: number;
+    currency: string;
+    unit_amount: number;
+    total_amount: number;
+}
+interface IBookingConfirmationProps {
+    booking: IBookingRecord;
+    summary: IBookingSummaryData | null;
+    onClose: () => void;
+}
+/**
+ * BookingConfirmation
+ *
+ * Displays confirmation after successful booking:
+ * - Success icon and message
+ * - Booking ID
+ * - Booking details (name, dates, amount)
+ * - Close button
+ */
+export declare const BookingConfirmation: React.FC<IBookingConfirmationProps>;
+export default BookingConfirmation;
+//# sourceMappingURL=BookingConfirmation.d.ts.map

package/dist/components/bookingModal/BookingModal.d.ts

@@ -0,0 +1,19 @@
+export interface BookingModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    contentId: string;
+    collectionKey: string;
+}
+/**
+ * BookingModal
+ *
+ * Multi-step modal for booking payment flow:
+ * 1. Loading: Creates booking from content
+ * 2. Summary: Shows booking details and "Pay Now" button
+ * 3. Confirmation: Shows success message after payment
+ *
+ * For free bookings (unit_amount = 0), skips payment and goes directly to confirmation.
+ */
+export declare const BookingModal: ({ isOpen, onClose, contentId, collectionKey }: BookingModalProps) => import("react/jsx-runtime").JSX.Element | null;
+export default BookingModal;
+//# sourceMappingURL=BookingModal.d.ts.map

package/dist/components/bookingModal/BookingSummary.d.ts

@@ -0,0 +1,34 @@
+import { default as React } from 'react';
+interface IBookingSummaryData {
+    _id: string;
+    instance_label: string;
+    cover_image: {
+        location: string;
+    } | null;
+    starts_at: string | null;
+    ends_at: string | null;
+    quantity: number;
+    currency: string;
+    unit_amount: number;
+    total_amount: number;
+    status: string;
+    paid: boolean;
+}
+interface IBookingSummaryProps {
+    summary: IBookingSummaryData;
+    onPay: () => void;
+    isLoading: boolean;
+}
+/**
+ * BookingSummary
+ *
+ * Displays booking details before payment:
+ * - Cover image (if available)
+ * - Instance label (booking name)
+ * - Date/time (if available)
+ * - Quantity and pricing
+ * - Pay Now button
+ */
+export declare const BookingSummary: React.FC<IBookingSummaryProps>;
+export default BookingSummary;
+//# sourceMappingURL=BookingSummary.d.ts.map

package/dist/components/bookingModal/index.d.ts

@@ -0,0 +1,4 @@
+export { BookingConfirmation } from './BookingConfirmation';
+export { BookingModal, type BookingModalProps } from './BookingModal';
+export { BookingSummary } from './BookingSummary';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/index.d.ts

@@ -1,2 +1,3 @@
+export * from './bookingModal';
 export * from './ui';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/integrationFilters/FieldRenderer.d.ts

@@ -2,6 +2,9 @@ import { ILemaField } from '@levo-so/core';
 import { default as React } from 'react';
 declare const FieldRenderer: React.FC<{
     field: ILemaField;
+    settings?: {
+        enableVerification?: boolean;
+    };
 }>;
 export default FieldRenderer;
 //# sourceMappingURL=FieldRenderer.d.ts.map

package/dist/components/integrationFilters/IntegrationFilters.d.ts

@@ -1,5 +1,5 @@
-import { default as React } from 'react';
 import { ILemaCollection } from '@levo-so/core';
+import { default as React } from 'react';
 declare const IntegrationFilters: React.FC<{
     selectedFields: string[];
     schema: ILemaCollection;

package/dist/components/integrationFilters/fields/DropdownField.d.ts

@@ -1,5 +1,5 @@
-import { default as React } from 'react';
 import { ILemaField } from '@levo-so/core';
+import { default as React } from 'react';
 declare const DropdownField: React.FC<{
     field: ILemaField;
     isMulti?: boolean;

package/dist/components/integrationFilters/fields/TextField.d.ts

@@ -1,5 +1,5 @@
-import { default as React } from 'react';
 import { ILemaField } from '@levo-so/core';
+import { default as React } from 'react';
 declare const TextField: React.FC<{
     field: ILemaField;
 }>;

package/dist/components/registerModal/AttendeeForm.d.ts

@@ -0,0 +1,27 @@
+export interface IAttendeeFormProps {
+    values: {
+        name: string;
+        email: string;
+        is_business_purchase?: boolean;
+        billing_details?: {
+            name?: string;
+            tax_id?: string;
+            address?: {
+                line1?: string;
+                line2?: string;
+                city?: string;
+                state?: string;
+                postal_code?: string;
+                country?: string;
+            };
+        };
+    };
+    handleChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
+    handleBlur: (e: React.FocusEvent<HTMLInputElement>) => void;
+    handleSubmit: (e?: React.FormEvent<HTMLFormElement>) => void;
+    registerLoading: boolean;
+    onBack: () => void;
+    submitLabel: string;
+}
+export declare const AttendeeForm: React.FC<IAttendeeFormProps>;
+//# sourceMappingURL=AttendeeForm.d.ts.map

package/dist/components/registerModal/CouponView.d.ts

@@ -0,0 +1,14 @@
+import { LevoEvent } from '@levo-so/core';
+import { ITicketWithTaxBreakdown } from './utils';
+export interface ICouponViewProps {
+    couponCode: string;
+    onCouponCodeChange: (code: string) => void;
+    couponError: string | null;
+    couponLoading: boolean;
+    onValidateCoupon: (code?: string) => void;
+    publicCoupons: LevoEvent.Coupon.Root[];
+    onBack: () => void;
+    selectedTicket: LevoEvent.Ticket.Root | ITicketWithTaxBreakdown | null;
+}
+export declare const CouponView: React.FC<ICouponViewProps>;
+//# sourceMappingURL=CouponView.d.ts.map

package/dist/components/registerModal/TicketSelectionStep.d.ts

@@ -0,0 +1,15 @@
+import { LevoEvent } from '@levo-so/core';
+import { IDiscount, ITicketWithTaxBreakdown } from './utils';
+export interface ITicketSelectionStepProps {
+    tickets: (LevoEvent.Ticket.Root | ITicketWithTaxBreakdown)[];
+    selectedTicket: LevoEvent.Ticket.Root | ITicketWithTaxBreakdown | null;
+    onSelectTicket: (ticket: LevoEvent.Ticket.Root | ITicketWithTaxBreakdown) => void;
+    discount: IDiscount | null;
+    couponCode: string;
+    publicCouponsCount: number;
+    onApplyCouponClick: () => void;
+    onRemoveCoupon: () => void;
+    onNext: () => void;
+}
+export declare const TicketSelectionStep: React.FC<ITicketSelectionStepProps>;
+//# sourceMappingURL=TicketSelectionStep.d.ts.map

package/dist/components/registerModal/utils.d.ts

@@ -1,2 +1,86 @@
-export declare const currencySymbol: any;
+import { LevoEvent } from '@levo-so/core';
+export declare const currencySymbol: Record<string, string>;
+/**
+ * Tax line item from API (pre-calculated)
+ */
+export interface ITaxLineItem {
+    id?: string;
+    _id?: string;
+    label: string;
+    percentage: number;
+    amount: number;
+}
+/**
+ * Extended ticket with server-calculated tax breakdown
+ * All values are pre-calculated by the API - no client-side calculation needed
+ */
+export interface ITicketWithTaxBreakdown extends Omit<LevoEvent.Ticket.Root, "taxes"> {
+    /** Base price before tax (for tax-inclusive, back-calculated) */
+    subtotal: number;
+    /** Total tax amount */
+    tax_amount: number;
+    /** Final payable amount */
+    total: number;
+    /** Individual tax line items with amounts */
+    taxes: ITaxLineItem[];
+    /** Whether price includes tax */
+    tax_inclusive: boolean;
+    /** Whether taxes are enabled */
+    tax_enabled: boolean;
+}
+/**
+ * Response from coupon validation API (pre-calculated by server)
+ * All values are pre-calculated - no client-side calculation needed
+ */
+export interface IDiscountWithTax {
+    /** Base price before discount */
+    base_amount: number;
+    /** Final payable amount (legacy, same as total_amount) */
+    sale_amount: number;
+    /** Amount eligible for discount */
+    discountable_amount: number;
+    /** Discount amount applied */
+    discount: number;
+    /** Taxable amount after discount */
+    taxable_amount: number;
+    /** Individual tax line items with amounts */
+    taxes: ITaxLineItem[];
+    /** Total tax amount */
+    tax_amount: number;
+    /** Whether price includes tax */
+    tax_inclusive: boolean;
+    /** Final total payable */
+    total_amount: number;
+}
+/**
+ * Legacy discount interface (for backwards compatibility)
+ * @deprecated Use IDiscountWithTax instead
+ */
+export interface IDiscount {
+    base_amount: number;
+    sale_amount: number;
+    discount: number;
+    taxable_amount?: number;
+    taxes?: ITaxLineItem[];
+    tax_amount?: number;
+    tax_inclusive?: boolean;
+    total_amount?: number;
+}
+export declare const formatCurrency: (value?: {
+    unit_amount?: number;
+    currency?: string;
+} | null) => string;
+/**
+ * Get tax label suffix for price display in ticket selector
+ * Returns "+ taxes" for exclusive, "(inclusive of taxes)" for inclusive
+ */
+export declare const getTaxLabel: (ticket: ITicketWithTaxBreakdown | LevoEvent.Ticket.Root | null) => string | null;
+/**
+ * Check if discount has tax information from API
+ */
+export declare const hasDiscountTaxInfo: (discount: IDiscount | null) => discount is IDiscount & Required<Pick<IDiscount, "taxes" | "tax_amount" | "taxable_amount" | "total_amount">>;
+/**
+ * Check if ticket has tax breakdown from API
+ */
+export declare const hasTicketTaxBreakdown: (ticket: LevoEvent.Ticket.Root | ITicketWithTaxBreakdown | null) => ticket is ITicketWithTaxBreakdown;
 //# sourceMappingURL=utils.d.ts.map

package/dist/components/stripePaymentModal/StripePaymentModal.d.ts

@@ -0,0 +1,22 @@
+import { Stripe } from '@stripe/stripe-js';
+export interface IStripeEmbeddedCheckoutProps {
+    /** Whether modal is open */
+    isOpen: boolean;
+    /** Close modal handler */
+    onClose: () => void;
+    /** Stripe Promise from loadStripe */
+    stripePromise: Promise<Stripe | null> | null;
+    /** Checkout Session client_secret (from embedded mode session) */
+    clientSecret: string;
+    /** Called when checkout completes successfully */
+    onComplete?: () => void;
+}
+/**
+ * Stripe Embedded Checkout Modal
+ *
+ * Renders Stripe's hosted checkout UI inside a modal.
+ * Backend must create Checkout Session with ui_mode: 'embedded'.
+ */
+export declare const StripePaymentModal: ({ isOpen, onClose, stripePromise, clientSecret, onComplete, }: IStripeEmbeddedCheckoutProps) => import("react/jsx-runtime").JSX.Element | null;
+export default StripePaymentModal;
+//# sourceMappingURL=StripePaymentModal.d.ts.map

package/dist/components/stripePaymentModal/index.d.ts

@@ -0,0 +1,3 @@
+export { StripePaymentModal } from './StripePaymentModal';
+export type { IStripeEmbeddedCheckoutProps } from './StripePaymentModal';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/ui/Calendar.d.ts

@@ -1,5 +1,5 @@
 import { DayPicker } from 'react-day-picker';
-import * as React from "react";
+import type * as React from "react";
 export type CalendarProps = React.ComponentProps<typeof DayPicker>;
 export declare const Calendar: ({ className, classNames, showOutsideDays, captionLayout, formatters, components, ...props }: CalendarProps) => import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=Calendar.d.ts.map

package/dist/components/ui/base/avatar.d.ts

@@ -1,5 +1,5 @@
 import { Avatar as AvatarPrimitive } from 'radix-ui';
-import * as React from "react";
+import type * as React from "react";
 declare function Avatar({ className, ...props }: React.ComponentProps<typeof AvatarPrimitive.Root>): import("react/jsx-runtime").JSX.Element;
 declare function AvatarImage({ className, isActive, ...props }: React.ComponentProps<typeof AvatarPrimitive.Image> & {
     isActive?: boolean;

package/dist/components/ui/base/index.d.ts

@@ -1,4 +1,5 @@
-export * from './input';
 export * from './avatar';
+export * from './input';
 export * from './skeleton';
+export * from './tooltip';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/ui/base/input.d.ts

@@ -1,4 +1,4 @@
-import * as React from "react";
+import type * as React from "react";
 declare function Input({ className, type, ...props }: React.ComponentProps<"input">): import("react/jsx-runtime").JSX.Element;
 export { Input };
 //# sourceMappingURL=input.d.ts.map

package/dist/components/ui/base/textarea.d.ts

@@ -1,4 +1,4 @@
-import * as React from "react";
+import type * as React from "react";
 declare function Textarea({ className, ...props }: React.ComponentProps<"textarea">): import("react/jsx-runtime").JSX.Element;
 export { Textarea };
 //# sourceMappingURL=textarea.d.ts.map

package/dist/components/ui/base/tooltip.d.ts

@@ -0,0 +1,17 @@
+import { Tooltip as TooltipPrimitive } from 'radix-ui';
+import * as React from "react";
+declare const TooltipProvider: React.FC<TooltipPrimitive.TooltipProviderProps>;
+declare const Tooltip: React.FC<TooltipPrimitive.TooltipProps>;
+declare const TooltipTrigger: React.ForwardRefExoticComponent<TooltipPrimitive.TooltipTriggerProps & React.RefAttributes<HTMLButtonElement>>;
+declare const TooltipPortal: React.FC<TooltipPrimitive.TooltipPortalProps>;
+declare const TooltipContent: React.ForwardRefExoticComponent<Omit<TooltipPrimitive.TooltipContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const SimpleTooltipWrapper: React.FC<{
+    children: React.ReactNode;
+    label?: string | React.ReactElement;
+    labelClassName?: string;
+    asChild?: boolean;
+    contentProps?: React.ComponentProps<typeof TooltipContent>;
+    side?: "top" | "bottom" | "left" | "right";
+}>;
+export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider, SimpleTooltipWrapper, TooltipPortal, };
+//# sourceMappingURL=tooltip.d.ts.map

package/dist/components/ui/index.d.ts

@@ -1,4 +1,5 @@
-export * from './Calendar';
 export * from './base';
+export * from './Calendar';
+export * from './form/FormInput';
 export * from './form/FormTextarea';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/withBlockProps.d.ts

@@ -1,7 +1,6 @@
-import { ComponentType, ForwardRefExoticComponent, ReactElement, RefAttributes, ReactNode } from 'react';
+import { ComponentType, ForwardRefExoticComponent, ReactElement, ReactNode, RefAttributes } from 'react';
 import { IFieldConfig, IStyles } from '../interfaces';
-type RenderFunction = (item: unknown, index: number) => ReactNode;
-type BlockChildren = ReactNode | RenderFunction;
+type BlockChildren = ReactNode;
 /**
  * Base props interface for all studio elements
  *
@@ -15,11 +14,9 @@ export interface BaseElementProps {
     content?: any;
     generatedClassName?: string;
 }
-export interface WithBlockPropsComponent<P = {}> {
-    (props: P & {
-        children?: BlockChildren;
-    }): ReactElement | null;
-}
+export type WithBlockPropsComponent<P = {}> = (props: P & {
+    children?: BlockChildren;
+}) => ReactElement | null;
 /**
  * withBlockProps - Higher-Order Component for Studio Elements
  *
@@ -32,17 +29,12 @@ export interface WithBlockPropsComponent<P = {}> {
  * 2. Generates CSS classes for element targeting and theme variants
  * 3. Handles nested data access via dot-notation element keys
  * 4. Provides consistent interface for all studio elements
- * 5. Added support for Framer Motion animations driven by studio config
+ * 5. Supports Framer Motion animations via whileInView for entry animations
  *
  * CSS Class Generation:
  * - Base class: `levo-{blockId}-{elementKey}` for unique element targeting
  * - Variant classes: `levo-variant-{groupId}-{variantId}` for theme variants
  *
- * The generated classes enable:
- * - Element-specific styling in CSS
- * - Theme variant styling via class selectors
- * - CSS cascade integration with theme system
- *
  * @example
  * // Element with theme variants selected
  * <Button elementKey="hero.button" />

package/dist/constants/animation.d.ts

@@ -0,0 +1,10 @@
+import { AnimationProperties, TransitionConfig, ViewportConfig } from '../interfaces';
+/** Default visible state - target for all animations */
+export declare const DEFAULT_VISIBLE_STATE: AnimationProperties;
+/** Default "from" state for entry/scroll animations */
+export declare const DEFAULT_FROM_STATE: AnimationProperties;
+/** Default transition config */
+export declare const DEFAULT_TRANSITION: TransitionConfig;
+/** Default viewport config for entry animations */
+export declare const DEFAULT_VIEWPORT: ViewportConfig;
+//# sourceMappingURL=animation.d.ts.map