@delmaredigital/payload-puck 0.1.3 → 0.3.0

package/dist/views/PuckConfigContext.d.ts

@@ -0,0 +1,71 @@
+/**
+ * PuckConfigContext - Context for providing Puck configuration to the editor
+ *
+ * Since Puck configs contain React components, they cannot be serialized
+ * from server to client. This context allows the consuming application
+ * to provide the config at the client level.
+ *
+ * @example
+ * ```tsx
+ * // In your app's layout or provider setup:
+ * import { PuckConfigProvider } from '@delmaredigital/payload-puck/client'
+ * import { editorConfig } from '@delmaredigital/payload-puck/config/editor'
+ *
+ * export function Providers({ children }) {
+ *   return (
+ *     <PuckConfigProvider config={editorConfig}>
+ *       {children}
+ *     </PuckConfigProvider>
+ *   )
+ * }
+ * ```
+ */
+import { type ReactNode } from 'react';
+import type { Config as PuckConfig } from '@measured/puck';
+import type { LayoutDefinition } from '../layouts/index.js';
+import type { ThemeConfig } from '../theme/index.js';
+export interface PuckConfigContextValue {
+    /**
+     * The Puck configuration with component definitions
+     */
+    config: PuckConfig | null;
+    /**
+     * Layout definitions for the editor preview
+     */
+    layouts?: LayoutDefinition[];
+    /**
+     * Theme configuration for component styling
+     */
+    theme?: ThemeConfig;
+}
+declare const PuckConfigContext: import("react").Context<PuckConfigContextValue>;
+export interface PuckConfigProviderProps {
+    /**
+     * The Puck configuration with component definitions
+     */
+    config: PuckConfig;
+    /**
+     * Layout definitions for the editor preview
+     */
+    layouts?: LayoutDefinition[];
+    /**
+     * Theme configuration for component styling
+     */
+    theme?: ThemeConfig;
+    /**
+     * Children to render
+     */
+    children: ReactNode;
+}
+/**
+ * Provider component that makes Puck configuration available to the editor
+ */
+export declare function PuckConfigProvider({ config, layouts, theme, children, }: PuckConfigProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to access the Puck configuration
+ *
+ * @throws If used outside of a PuckConfigProvider
+ */
+export declare function usePuckConfig(): PuckConfigContextValue;
+export default PuckConfigContext;
+//# sourceMappingURL=PuckConfigContext.d.ts.map

package/dist/views/PuckConfigContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PuckConfigContext.d.ts","sourceRoot":"","sources":["../../src/views/PuckConfigContext.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AACjE,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,MAAM,EAAE,UAAU,GAAG,IAAI,CAAA;IACzB;;OAEG;IACH,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAC5B;;OAEG;IACH,KAAK,CAAC,EAAE,WAAW,CAAA;CACpB;AAED,QAAA,MAAM,iBAAiB,iDAErB,CAAA;AAEF,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,MAAM,EAAE,UAAU,CAAA;IAClB;;OAEG;IACH,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAC5B;;OAEG;IACH,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,MAAM,EACN,OAAO,EACP,KAAK,EACL,QAAQ,GACT,EAAE,uBAAuB,2CAMzB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,sBAAsB,CAGtD;AAED,eAAe,iBAAiB,CAAA"}

package/dist/views/PuckConfigContext.js

@@ -0,0 +1,45 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * PuckConfigContext - Context for providing Puck configuration to the editor
+ *
+ * Since Puck configs contain React components, they cannot be serialized
+ * from server to client. This context allows the consuming application
+ * to provide the config at the client level.
+ *
+ * @example
+ * ```tsx
+ * // In your app's layout or provider setup:
+ * import { PuckConfigProvider } from '@delmaredigital/payload-puck/client'
+ * import { editorConfig } from '@delmaredigital/payload-puck/config/editor'
+ *
+ * export function Providers({ children }) {
+ *   return (
+ *     <PuckConfigProvider config={editorConfig}>
+ *       {children}
+ *     </PuckConfigProvider>
+ *   )
+ * }
+ * ```
+ */
+import { createContext, useContext } from 'react';
+const PuckConfigContext = createContext({
+    config: null,
+});
+/**
+ * Provider component that makes Puck configuration available to the editor
+ */
+export function PuckConfigProvider({ config, layouts, theme, children, }) {
+    return (_jsx(PuckConfigContext.Provider, { value: { config, layouts, theme }, children: children }));
+}
+/**
+ * Hook to access the Puck configuration
+ *
+ * @throws If used outside of a PuckConfigProvider
+ */
+export function usePuckConfig() {
+    const context = useContext(PuckConfigContext);
+    return context;
+}
+export default PuckConfigContext;
+//# sourceMappingURL=PuckConfigContext.js.map

package/dist/views/PuckConfigContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PuckConfigContext.js","sourceRoot":"","sources":["../../src/views/PuckConfigContext.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAA;AAoBjE,MAAM,iBAAiB,GAAG,aAAa,CAAyB;IAC9D,MAAM,EAAE,IAAI;CACb,CAAC,CAAA;AAqBF;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,EACjC,MAAM,EACN,OAAO,EACP,KAAK,EACL,QAAQ,GACgB;IACxB,OAAO,CACL,KAAC,iBAAiB,CAAC,QAAQ,IAAC,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,YAC1D,QAAQ,GACkB,CAC9B,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAA;IAC7C,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,eAAe,iBAAiB,CAAA"}

package/dist/views/PuckEditorClient.d.ts

@@ -0,0 +1,73 @@
+import type { Data as PuckData } from '@measured/puck';
+import type { LayoutDefinition } from '../layouts/index.js';
+export interface PuckEditorClientProps {
+    /**
+     * Page ID for save operations
+     */
+    pageId: string;
+    /**
+     * Collection slug
+     */
+    collection: string;
+    /**
+     * Initial Puck data
+     */
+    initialData: PuckData;
+    /**
+     * Page title for display
+     */
+    pageTitle: string;
+    /**
+     * Page slug for preview
+     */
+    pageSlug: string;
+    /**
+     * Initial document status
+     */
+    initialStatus?: 'draft' | 'published';
+    /**
+     * URL to navigate back to
+     */
+    backUrl?: string;
+    /**
+     * Admin route base
+     */
+    adminRoute?: string;
+    /**
+     * Layout definitions (can also come from context)
+     */
+    layouts?: LayoutDefinition[];
+    /**
+     * Whether page-tree integration is active (auto-detected)
+     * When true, folder picker and page segment fields are injected into root
+     */
+    hasPageTree?: boolean;
+}
+/**
+ * Client component that renders the Puck editor
+ *
+ * The Puck config is obtained from PuckConfigContext. The consuming application
+ * must wrap their app with PuckConfigProvider.
+ *
+ * @example
+ * ```tsx
+ * // In your app's layout:
+ * import { PuckConfigProvider } from '@delmaredigital/payload-puck/client'
+ * import { editorConfig } from '@delmaredigital/payload-puck/config/editor'
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html>
+ *       <body>
+ *         <PuckConfigProvider config={editorConfig}>
+ *           {children}
+ *         </PuckConfigProvider>
+ *       </body>
+ *     </html>
+ *   )
+ * }
+ * ```
+ */
+export declare function PuckEditorClient({ pageId, collection, initialData, pageTitle, pageSlug, initialStatus, backUrl, adminRoute, layouts: layoutsProp, hasPageTree, }: PuckEditorClientProps): import("react/jsx-runtime").JSX.Element;
+export default PuckEditorClient;
+//# sourceMappingURL=PuckEditorClient.d.ts.map

package/dist/views/PuckEditorClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PuckEditorClient.d.ts","sourceRoot":"","sources":["../../src/views/PuckEditorClient.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,IAAI,IAAI,QAAQ,EAAwB,MAAM,gBAAgB,CAAA;AAE5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAM3D,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,WAAW,EAAE,QAAQ,CAAA;IACrB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,WAAW,CAAA;IACrC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAC5B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,UAAU,EACV,WAAW,EACX,SAAS,EACT,QAAQ,EACR,aAAa,EACb,OAAO,EACP,UAAqB,EACrB,OAAO,EAAE,WAAW,EACpB,WAAmB,GACpB,EAAE,qBAAqB,2CA+IvB;AAED,eAAe,gBAAgB,CAAA"}

package/dist/views/PuckEditorClient.js

@@ -0,0 +1,130 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * PuckEditorClient - Client component for the Puck editor in Payload admin
+ *
+ * This wraps PuckEditorCore and provides the necessary context for
+ * running within Payload's admin UI.
+ */
+import { useMemo } from 'react';
+import { PuckEditorCore } from '../editor/PuckEditorCore.client.js';
+import { usePuckConfig } from './PuckConfigContext.js';
+import { createFolderPickerField } from '../fields/FolderPickerField.js';
+import { createPageSegmentField } from '../fields/PageSegmentField.js';
+import { createSlugPreviewField } from '../fields/SlugPreviewField.js';
+/**
+ * Client component that renders the Puck editor
+ *
+ * The Puck config is obtained from PuckConfigContext. The consuming application
+ * must wrap their app with PuckConfigProvider.
+ *
+ * @example
+ * ```tsx
+ * // In your app's layout:
+ * import { PuckConfigProvider } from '@delmaredigital/payload-puck/client'
+ * import { editorConfig } from '@delmaredigital/payload-puck/config/editor'
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html>
+ *       <body>
+ *         <PuckConfigProvider config={editorConfig}>
+ *           {children}
+ *         </PuckConfigProvider>
+ *       </body>
+ *     </html>
+ *   )
+ * }
+ * ```
+ */
+export function PuckEditorClient({ pageId, collection, initialData, pageTitle, pageSlug, initialStatus, backUrl, adminRoute = '/admin', layouts: layoutsProp, hasPageTree = false, }) {
+    // Get config from context
+    const { config: baseConfig, layouts: layoutsFromContext, theme } = usePuckConfig();
+    // Use layouts from props or context
+    const layouts = layoutsProp || layoutsFromContext;
+    // If page-tree is active, inject folder picker fields into root config
+    const config = useMemo(() => {
+        if (!baseConfig || !hasPageTree)
+            return baseConfig;
+        // Create page-tree specific fields
+        const pageTreeFields = {
+            folder: createFolderPickerField({ label: 'Folder' }),
+            pageSegment: createPageSegmentField({ label: 'Page Segment' }),
+            slug: createSlugPreviewField({
+                label: 'URL Slug',
+                hint: 'Auto-generated from folder + page segment',
+            }),
+        };
+        // Merge page-tree fields into root config, replacing slug field
+        const existingRootFields = baseConfig.root?.fields || {};
+        const { slug: _existingSlug, ...otherFields } = existingRootFields;
+        return {
+            ...baseConfig,
+            root: {
+                ...baseConfig.root,
+                fields: {
+                    ...otherFields,
+                    ...pageTreeFields,
+                },
+            },
+        };
+    }, [baseConfig, hasPageTree]);
+    // API endpoint based on collection
+    const apiEndpoint = `/api/puck/${collection}`;
+    // Preview URL - defaults to the page slug
+    const previewUrl = (slug) => `/${slug}`;
+    if (!config) {
+        return (_jsx("div", { style: {
+                display: 'flex',
+                flexDirection: 'column',
+                alignItems: 'center',
+                justifyContent: 'center',
+                height: 'calc(100vh - 120px)',
+                padding: '40px',
+                textAlign: 'center',
+            }, children: _jsxs("div", { style: {
+                    backgroundColor: 'var(--theme-elevation-50)',
+                    border: '1px solid var(--theme-elevation-150)',
+                    borderRadius: '8px',
+                    padding: '32px 48px',
+                    maxWidth: '560px',
+                }, children: [_jsx("h2", { style: {
+                            color: 'var(--theme-elevation-800)',
+                            fontSize: '18px',
+                            fontWeight: 600,
+                            margin: '0 0 12px 0',
+                        }, children: "Puck Configuration Required" }), _jsxs("p", { style: {
+                            color: 'var(--theme-elevation-500)',
+                            fontSize: '14px',
+                            lineHeight: 1.6,
+                            margin: '0 0 16px 0',
+                        }, children: ["To use the Puck editor, wrap your application with", ' ', _jsx("code", { style: {
+                                    backgroundColor: 'var(--theme-elevation-100)',
+                                    padding: '2px 6px',
+                                    borderRadius: '4px',
+                                    fontSize: '13px',
+                                }, children: "PuckConfigProvider" })] }), _jsx("pre", { style: {
+                            backgroundColor: 'var(--theme-elevation-100)',
+                            padding: '16px',
+                            borderRadius: '6px',
+                            fontSize: '12px',
+                            textAlign: 'left',
+                            overflow: 'auto',
+                            margin: 0,
+                        }, children: `// In your layout.tsx:
+import { PuckConfigProvider } from '@delmaredigital/payload-puck/client'
+import { editorConfig } from '@delmaredigital/payload-puck/config/editor'
+
+<PuckConfigProvider config={editorConfig}>
+  {children}
+</PuckConfigProvider>` })] }) }));
+    }
+    return (_jsx("div", { style: {
+            // Take up full available height within the admin template
+            height: 'calc(100vh - 60px)',
+            display: 'flex',
+            flexDirection: 'column',
+        }, children: _jsx(PuckEditorCore, { pageId: pageId, initialData: initialData, config: config, pageTitle: pageTitle, pageSlug: pageSlug, apiEndpoint: apiEndpoint, backUrl: backUrl, previewUrl: previewUrl, initialStatus: initialStatus, layouts: layouts, theme: theme }) }));
+}
+export default PuckEditorClient;
+//# sourceMappingURL=PuckEditorClient.js.map

package/dist/views/PuckEditorClient.js.map

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

package/dist/views/PuckEditorView.d.ts

@@ -0,0 +1,19 @@
+/**
+ * PuckEditorView - React Server Component for Payload Admin
+ *
+ * This is the admin view that wraps the Puck editor within Payload's admin layout.
+ * It fetches page data server-side and passes it to the client component.
+ *
+ * Registered as a custom view via config.admin.components.views
+ */
+import type { AdminViewProps } from 'payload';
+export interface PuckEditorViewProps extends AdminViewProps {
+}
+/**
+ * Server Component that renders the Puck editor within Payload admin
+ *
+ * URL pattern: /admin/puck-editor/:collection/:id
+ */
+export declare function PuckEditorView({ initPageResult, params, searchParams, }: PuckEditorViewProps): Promise<import("react/jsx-runtime").JSX.Element>;
+export default PuckEditorView;
+//# sourceMappingURL=PuckEditorView.d.ts.map

package/dist/views/PuckEditorView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PuckEditorView.d.ts","sourceRoot":"","sources":["../../src/views/PuckEditorView.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAU,MAAM,SAAS,CAAA;AAKrD,MAAM,WAAW,mBAAoB,SAAQ,cAAc;CAE1D;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,EACnC,cAAc,EACd,MAAM,EACN,YAAY,GACb,EAAE,mBAAmB,oDA0JrB;AAED,eAAe,cAAc,CAAA"}

package/dist/views/PuckEditorView.js

@@ -0,0 +1,106 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { DefaultTemplate } from '@payloadcms/next/templates';
+import { getVisibleEntities } from '@payloadcms/ui/shared';
+import { PuckEditorClient } from './PuckEditorClient.js';
+/**
+ * Server Component that renders the Puck editor within Payload admin
+ *
+ * URL pattern: /admin/puck-editor/:collection/:id
+ */
+export async function PuckEditorView({ initPageResult, params, searchParams, }) {
+    const { req } = initPageResult;
+    const { payload } = req;
+    // Get admin route from config
+    const adminRoute = req.payload.config.routes?.admin || '/admin';
+    // Parse segments from URL: /admin/puck-editor/:collection/:id
+    // params.segments contains the full path after /admin/, e.g. ['puck-editor', 'pages', '1']
+    // We need to skip the route prefix ('puck-editor') to get collection and id
+    const segments = (await params)?.segments;
+    // segments[0] = 'puck-editor' (route prefix), segments[1] = collection, segments[2] = id
+    const collection = segments?.[1] || 'pages';
+    const pageId = segments?.[2];
+    if (!pageId) {
+        return (_jsx(DefaultTemplate, { i18n: req.i18n, locale: req.locale, params: params, payload: payload, permissions: initPageResult.permissions, searchParams: searchParams, user: req.user ?? undefined, visibleEntities: getVisibleEntities({ req }), children: _jsx("div", { style: {
+                    display: 'flex',
+                    alignItems: 'center',
+                    justifyContent: 'center',
+                    height: '50vh',
+                    color: 'var(--theme-elevation-500)',
+                }, children: _jsx("p", { children: "No page ID provided. Please navigate from the collection view." }) }) }));
+    }
+    // Fetch the page data
+    let page = null;
+    let error = null;
+    try {
+        page = await payload.findByID({
+            collection: collection,
+            id: pageId,
+            draft: true, // Always get draft for editing
+            depth: 0,
+        });
+    }
+    catch (err) {
+        console.error('[PuckEditorView] Error fetching page:', err);
+        error = err instanceof Error ? err.message : 'Failed to load page';
+    }
+    // Get visible entities for the sidebar navigation
+    const visibleEntities = getVisibleEntities({ req });
+    // Get puck config from plugin custom settings
+    const puckConfig = payload.config.custom?.puck?.config;
+    const layouts = payload.config.custom?.puck?.layouts;
+    const explicitPageTreeConfig = payload.config.custom?.puck?.pageTree;
+    // Determine page-tree config:
+    // 1. If explicitly set to false in plugin options, disable
+    // 2. If explicit config provided, use it
+    // 3. Otherwise, auto-detect by checking for pageSegment field (added by page-tree plugin)
+    let pageTreeConfig = null;
+    if (explicitPageTreeConfig === false) {
+        // Explicitly disabled
+        pageTreeConfig = null;
+    }
+    else if (explicitPageTreeConfig) {
+        // Use explicit config
+        pageTreeConfig = explicitPageTreeConfig;
+    }
+    else {
+        // Auto-detect: check if collection has pageSegment field
+        const collectionConfig = payload.collections[collection]?.config;
+        const hasPageTreeFields = collectionConfig?.fields?.some((field) => field.name === 'pageSegment');
+        if (hasPageTreeFields) {
+            pageTreeConfig = {
+                folderSlug: 'payload-folders',
+                pageSegmentFieldName: 'pageSegment',
+                folderFieldName: 'folder',
+            };
+        }
+    }
+    // Build back URL to collection
+    const backUrl = `${adminRoute}/collections/${collection}/${pageId}`;
+    // Build initial data with page-tree fields if enabled
+    let initialData = page?.puckData || { content: [], root: { props: {} } };
+    // If page-tree integration is enabled, merge folder/pageSegment into root.props
+    if (pageTreeConfig && page) {
+        const folderId = typeof page.folder === 'object' ? page.folder?.id : page.folder;
+        initialData = {
+            ...initialData,
+            root: {
+                ...initialData.root,
+                props: {
+                    ...initialData.root?.props,
+                    folder: folderId || null,
+                    pageSegment: page.pageSegment || '',
+                    slug: page.slug || '',
+                },
+            },
+        };
+    }
+    return (_jsx(DefaultTemplate, { i18n: req.i18n, locale: req.locale, params: params, payload: payload, permissions: initPageResult.permissions, searchParams: searchParams, user: req.user ?? undefined, visibleEntities: visibleEntities, children: error ? (_jsx("div", { style: {
+                display: 'flex',
+                alignItems: 'center',
+                justifyContent: 'center',
+                height: '50vh',
+                color: 'var(--theme-error-500)',
+            }, children: _jsxs("p", { children: ["Error: ", error] }) })) : (_jsx(PuckEditorClient, { pageId: pageId, collection: collection, initialData: initialData, pageTitle: page?.title || 'Untitled', pageSlug: page?.slug || '', initialStatus: page?._status, backUrl: backUrl, adminRoute: adminRoute, layouts: layouts, hasPageTree: !!pageTreeConfig })) }));
+}
+export default PuckEditorView;
+//# sourceMappingURL=PuckEditorView.js.map

package/dist/views/PuckEditorView.js.map

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

package/dist/views/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Views module - Payload admin view components
+ */
+export { PuckEditorView } from './PuckEditorView.js';
+export type { PuckEditorViewProps } from './PuckEditorView.js';
+export { PuckEditorClient } from './PuckEditorClient.js';
+export type { PuckEditorClientProps } from './PuckEditorClient.js';
+export { PuckConfigProvider, usePuckConfig } from './PuckConfigContext.js';
+export type { PuckConfigProviderProps, PuckConfigContextValue } from './PuckConfigContext.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/views/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/views/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAG9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAGlE,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAC1E,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/views/index.js

@@ -0,0 +1,10 @@
+/**
+ * Views module - Payload admin view components
+ */
+// Server component (RSC)
+export { PuckEditorView } from './PuckEditorView.js';
+// Client components
+export { PuckEditorClient } from './PuckEditorClient.js';
+// Context
+export { PuckConfigProvider, usePuckConfig } from './PuckConfigContext.js';
+//# sourceMappingURL=index.js.map

package/dist/views/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/views/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,yBAAyB;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAGpD,oBAAoB;AACpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAGxD,UAAU;AACV,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA"}