@delmaredigital/payload-puck 0.1.3 → 0.3.0

package/dist/hooks/useResponsiveStyles.js

@@ -0,0 +1,149 @@
+'use client';
+/**
+ * useResponsiveStyles - Runtime breakpoint detection for responsive values
+ *
+ * Returns the appropriate value for the current viewport width.
+ * Enables live preview in the Puck editor when resizing.
+ */
+import { useState, useEffect, useCallback } from 'react';
+import { BREAKPOINTS, isResponsiveValue } from '../fields/shared';
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Gets the current breakpoint based on window width
+ */
+function getCurrentBreakpoint() {
+    if (typeof window === 'undefined')
+        return 'xs';
+    const width = window.innerWidth;
+    // Check breakpoints from largest to smallest
+    for (let i = BREAKPOINTS.length - 1; i >= 0; i--) {
+        const bp = BREAKPOINTS[i];
+        if (bp.minWidth !== null && width >= bp.minWidth) {
+            return bp.key;
+        }
+    }
+    return 'xs';
+}
+/**
+ * Gets the effective value for a breakpoint with mobile-first cascade
+ * Falls back through smaller breakpoints to xs base
+ */
+function getValueForBreakpoint(value, breakpoint) {
+    // For xs, return xs value directly (it's required)
+    if (breakpoint === 'xs') {
+        return value.xs;
+    }
+    // Check if this breakpoint has an explicit value
+    const explicitValue = value[breakpoint];
+    if (explicitValue !== undefined) {
+        return explicitValue;
+    }
+    // Cascade down to find the nearest defined value (mobile-first)
+    const breakpointOrder = ['xl', 'lg', 'md', 'sm', 'xs'];
+    const currentIndex = breakpointOrder.indexOf(breakpoint);
+    for (let i = currentIndex + 1; i < breakpointOrder.length; i++) {
+        const bp = breakpointOrder[i];
+        const bpValue = value[bp];
+        if (bpValue !== undefined) {
+            return bpValue;
+        }
+    }
+    // Fallback to xs base (always exists in valid ResponsiveValue)
+    return value.xs;
+}
+// =============================================================================
+// Hook: useCurrentBreakpoint
+// =============================================================================
+/**
+ * Returns the current breakpoint based on window width.
+ * Updates when window is resized.
+ */
+export function useCurrentBreakpoint(options = {}) {
+    const { listenToResize = true, debounceDelay = 100 } = options;
+    const [breakpoint, setBreakpoint] = useState(() => getCurrentBreakpoint());
+    useEffect(() => {
+        if (!listenToResize || typeof window === 'undefined')
+            return;
+        let timeoutId = null;
+        const handleResize = () => {
+            if (timeoutId)
+                clearTimeout(timeoutId);
+            timeoutId = setTimeout(() => {
+                setBreakpoint(getCurrentBreakpoint());
+            }, debounceDelay);
+        };
+        window.addEventListener('resize', handleResize);
+        // Initial check
+        setBreakpoint(getCurrentBreakpoint());
+        return () => {
+            window.removeEventListener('resize', handleResize);
+            if (timeoutId)
+                clearTimeout(timeoutId);
+        };
+    }, [listenToResize, debounceDelay]);
+    return breakpoint;
+}
+// =============================================================================
+// Hook: useResponsiveValue
+// =============================================================================
+/**
+ * Returns the appropriate value from a ResponsiveValue based on current viewport.
+ *
+ * @param value - The responsive or non-responsive value
+ * @param defaultValue - Default value if null/undefined
+ * @param options - Configuration options
+ *
+ * @example
+ * ```tsx
+ * function MyComponent({ padding }: { padding: ResponsiveValue<PaddingValue> | PaddingValue | null }) {
+ *   const effectivePadding = useResponsiveValue(padding, DEFAULT_PADDING)
+ *   // effectivePadding will be the appropriate value for current viewport
+ * }
+ * ```
+ */
+export function useResponsiveValue(value, defaultValue, options = {}) {
+    const currentBreakpoint = useCurrentBreakpoint(options);
+    return useCallback(() => {
+        // Handle null/undefined
+        if (value === null || value === undefined) {
+            return defaultValue;
+        }
+        // If not a responsive value, return as-is
+        if (!isResponsiveValue(value)) {
+            return value;
+        }
+        // Get value for current breakpoint with mobile-first cascade
+        return getValueForBreakpoint(value, currentBreakpoint);
+    }, [value, defaultValue, currentBreakpoint])();
+}
+// =============================================================================
+// Hook: useResponsiveStyles (Main Export)
+// =============================================================================
+/**
+ * Converts a responsive value to CSS properties for the current viewport.
+ * Useful for applying styles dynamically in the editor.
+ *
+ * @param value - The responsive or non-responsive value
+ * @param converter - Function to convert value to CSS properties
+ * @param defaultValue - Default value if null/undefined
+ * @param options - Configuration options
+ *
+ * @example
+ * ```tsx
+ * function MyComponent({ dimensions }: Props) {
+ *   const styles = useResponsiveStyles(
+ *     dimensions,
+ *     dimensionsValueToCSS,
+ *     DEFAULT_DIMENSIONS
+ *   )
+ *   return <div style={styles}>...</div>
+ * }
+ * ```
+ */
+export function useResponsiveStyles(value, converter, defaultValue, options = {}) {
+    const effectiveValue = useResponsiveValue(value, defaultValue, options);
+    return converter(effectiveValue) || {};
+}
+//# sourceMappingURL=useResponsiveStyles.js.map

package/dist/hooks/useResponsiveStyles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResponsiveStyles.js","sourceRoot":"","sources":["../../src/hooks/useResponsiveStyles.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useScrollAnimation.d.ts

@@ -0,0 +1,56 @@
+export interface UseScrollAnimationOptions {
+    /**
+     * Whether to trigger animation on scroll into view.
+     * If false, isInView will always be true.
+     * @default true
+     */
+    triggerOnScroll?: boolean;
+    /**
+     * Threshold for intersection (0-1).
+     * 0 = trigger as soon as any pixel is visible.
+     * 1 = trigger only when fully visible.
+     * @default 0.1
+     */
+    threshold?: number;
+    /**
+     * Whether to only trigger once.
+     * If true, hasAnimated will stay true after first trigger.
+     * @default true
+     */
+    once?: boolean;
+    /**
+     * Root margin for intersection observer.
+     * Allows triggering before/after the element enters the viewport.
+     * @example "-50px" // Trigger 50px before entering viewport
+     * @example "100px 0px" // 100px top/bottom, 0px left/right
+     * @default "0px"
+     */
+    rootMargin?: string;
+    /**
+     * Delay in milliseconds before setting isInView to true.
+     * Useful for staggering animations.
+     * @default 0
+     */
+    delay?: number;
+}
+export interface UseScrollAnimationResult<T extends HTMLElement = HTMLElement> {
+    /**
+     * Ref to attach to the element you want to observe
+     */
+    ref: React.RefObject<T | null>;
+    /**
+     * Whether the element is currently in view
+     */
+    isInView: boolean;
+    /**
+     * Whether the element has ever been in view
+     * (useful for once-only animations)
+     */
+    hasAnimated: boolean;
+    /**
+     * Manually reset the animation state
+     */
+    reset: () => void;
+}
+export declare function useScrollAnimation<T extends HTMLElement = HTMLElement>(options?: UseScrollAnimationOptions): UseScrollAnimationResult<T>;
+//# sourceMappingURL=useScrollAnimation.d.ts.map

package/dist/hooks/useScrollAnimation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollAnimation.d.ts","sourceRoot":"","sources":["../../src/hooks/useScrollAnimation.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IAEzB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;IAEd;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,wBAAwB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IAC3E;;OAEG;IACH,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IAE9B;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAA;IAEjB;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAA;IAEpB;;OAEG;IACH,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAMD,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EACpE,OAAO,GAAE,yBAA8B,GACtC,wBAAwB,CAAC,CAAC,CAAC,CAwH7B"}

package/dist/hooks/useScrollAnimation.js

@@ -0,0 +1,116 @@
+'use client';
+/**
+ * useScrollAnimation - Hook for scroll-triggered animations
+ *
+ * Uses IntersectionObserver to detect when an element enters the viewport.
+ * Perfect for triggering entrance animations, lazy loading, or scroll-based effects.
+ */
+import { useRef, useState, useEffect, useCallback } from 'react';
+// =============================================================================
+// Hook Implementation
+// =============================================================================
+export function useScrollAnimation(options = {}) {
+    const { triggerOnScroll = true, threshold = 0.1, once = true, rootMargin = '0px', delay = 0, } = options;
+    const ref = useRef(null);
+    // Always start with isInView: false to allow initial → animate transition
+    const [isInView, setIsInView] = useState(false);
+    const [hasAnimated, setHasAnimated] = useState(false);
+    const timeoutRef = useRef(null);
+    const hasMountedRef = useRef(false);
+    // Reset function
+    const reset = useCallback(() => {
+        setIsInView(false);
+        setHasAnimated(false);
+        hasMountedRef.current = false;
+        if (timeoutRef.current) {
+            clearTimeout(timeoutRef.current);
+            timeoutRef.current = null;
+        }
+    }, []);
+    useEffect(() => {
+        // If not triggering on scroll, animate immediately after mount
+        // Use requestAnimationFrame to ensure the initial state is rendered first
+        if (!triggerOnScroll) {
+            // Skip if already mounted (prevents re-triggering on re-renders)
+            if (hasMountedRef.current)
+                return;
+            hasMountedRef.current = true;
+            // Use double RAF to ensure browser has painted initial state
+            requestAnimationFrame(() => {
+                requestAnimationFrame(() => {
+                    if (delay > 0) {
+                        timeoutRef.current = setTimeout(() => {
+                            setIsInView(true);
+                            setHasAnimated(true);
+                        }, delay);
+                    }
+                    else {
+                        setIsInView(true);
+                        setHasAnimated(true);
+                    }
+                });
+            });
+            return;
+        }
+        // If once mode and already animated, skip observer setup
+        if (once && hasAnimated) {
+            return;
+        }
+        const element = ref.current;
+        if (!element)
+            return;
+        // Check if IntersectionObserver is available (SSR safety)
+        if (typeof IntersectionObserver === 'undefined') {
+            setIsInView(true);
+            setHasAnimated(true);
+            return;
+        }
+        const observer = new IntersectionObserver((entries) => {
+            const [entry] = entries;
+            const inView = entry.isIntersecting;
+            if (inView) {
+                if (delay > 0) {
+                    // Apply delay before setting isInView
+                    timeoutRef.current = setTimeout(() => {
+                        setIsInView(true);
+                        setHasAnimated(true);
+                    }, delay);
+                }
+                else {
+                    setIsInView(true);
+                    setHasAnimated(true);
+                }
+                // If once mode, disconnect observer after triggering
+                if (once) {
+                    observer.disconnect();
+                }
+            }
+            else if (!once) {
+                // Only update isInView to false if not in once mode
+                if (timeoutRef.current) {
+                    clearTimeout(timeoutRef.current);
+                    timeoutRef.current = null;
+                }
+                setIsInView(false);
+            }
+        }, {
+            threshold,
+            rootMargin,
+        });
+        observer.observe(element);
+        return () => {
+            observer.disconnect();
+            if (timeoutRef.current) {
+                clearTimeout(timeoutRef.current);
+                timeoutRef.current = null;
+            }
+        };
+    }, [triggerOnScroll, threshold, once, rootMargin, delay, hasAnimated]);
+    return {
+        ref,
+        isInView,
+        hasAnimated,
+        reset,
+    };
+}
+//# sourceMappingURL=useScrollAnimation.js.map

package/dist/hooks/useScrollAnimation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollAnimation.js","sourceRoot":"","sources":["../../src/hooks/useScrollAnimation.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,6 +1,66 @@
-export { j as ColorPickerFieldProps, C as ConversionType, E as EditorVersion, i as MediaFieldProps, M as MediaObject, b as MergeConfigOptions, g as PageConversionTracking, h as PageDocument, e as PageMeta, f as PageSEO, d as PuckAdminConfig, P as PuckPageData, c as PuckPluginOptions, a as PuckRootProps, S as SharedComponentProps, k as ThemeConfig, T as TiptapFieldProps } from './index-CoUQnyC3.js';
-export { GetPuckFieldsOptions, TemplatesCollection, conversionFieldGroup, createEditorVersionField, createPageLayoutField, createPuckPlugin, editorVersionField, generatePagesCollection, generatePuckEditField, getPuckFields, isHomepageField, pageLayoutField, puckDataField, seoFieldGroup } from './plugin/index.js';
-export { Config as PuckConfig, Data as PuckData } from '@measured/puck';
-import 'payload';
-import './types-D7D3rZ1J.js';
-import 'react';
+/**
+ * @delmaredigital/payload-puck
+ *
+ * A portable PayloadCMS plugin for Puck visual page builder integration.
+ *
+ * @example
+ * ```typescript
+ * // In payload.config.ts
+ * import { createPuckPlugin } from '@delmaredigital/payload-puck/plugin'
+ *
+ * export default buildConfig({
+ *   plugins: [
+ *     createPuckPlugin({
+ *       pagesCollection: 'pages',
+ *     }),
+ *   ],
+ * })
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using config for rendering
+ * import { baseConfig } from '@delmaredigital/payload-puck/config'
+ * import { PageRenderer } from '@delmaredigital/payload-puck/render'
+ *
+ * <PageRenderer data={page.puckData} config={baseConfig} />
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Merging custom components
+ * import { mergeConfigs, editorConfig } from '@delmaredigital/payload-puck/config/editor'
+ *
+ * const customConfig = mergeConfigs({
+ *   base: editorConfig,
+ *   components: {
+ *     CustomHero: myHeroConfig,
+ *   },
+ *   categories: {
+ *     custom: { title: 'Custom', components: ['CustomHero'] },
+ *   },
+ * })
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Creating API routes
+ * // src/app/api/puck/pages/route.ts
+ * import { createPuckApiRoutes } from '@delmaredigital/payload-puck/api'
+ *
+ * export const { GET, POST } = createPuckApiRoutes({
+ *   auth: {
+ *     authenticate: async (request) => {
+ *       const session = await getSession(request)
+ *       if (!session?.user) return { authenticated: false }
+ *       return { authenticated: true, user: session.user }
+ *     },
+ *   },
+ * })
+ * ```
+ */
+export * from './types';
+export { createPuckPlugin, generatePagesCollection, generatePuckEditField, TemplatesCollection, } from './plugin';
+export { getPuckFields, puckDataField, editorVersionField, createEditorVersionField, pageLayoutField, createPageLayoutField, isHomepageField, seoFieldGroup, conversionFieldGroup, } from './plugin';
+export type { GetPuckFieldsOptions } from './plugin/fields/types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AAGH,cAAc,SAAS,CAAA;AAGvB,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,UAAU,CAAA;AAGjB,OAAO,EACL,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,wBAAwB,EACxB,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,oBAAoB,GACrB,MAAM,UAAU,CAAA;AAGjB,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA"}