@delmaredigital/payload-puck 0.2.0 → 0.3.0

package/dist/api/types.d.ts

@@ -0,0 +1,302 @@
+import type { NextRequest } from 'next/server';
+import type { Data as PuckData } from '@measured/puck';
+/**
+ * Authenticated user from the auth system
+ */
+export interface AuthenticatedUser {
+    id: string;
+    [key: string]: unknown;
+}
+/**
+ * Result of an authentication check
+ */
+export interface AuthResult {
+    authenticated: boolean;
+    user?: AuthenticatedUser;
+    error?: string;
+}
+/**
+ * Result of a permission check
+ */
+export interface PermissionResult {
+    allowed: boolean;
+    error?: string;
+}
+/**
+ * Authentication and authorization hooks for Puck API routes
+ *
+ * These hooks allow you to integrate with any authentication system
+ * (Better Auth, NextAuth, Payload auth, custom JWT, etc.)
+ *
+ * @example
+ * ```typescript
+ * // Example with Better Auth
+ * const authHooks: PuckApiAuthHooks = {
+ *   authenticate: async (request) => {
+ *     const session = await auth.api.getSession({ headers: await headers() })
+ *     if (!session?.user) return { authenticated: false }
+ *     return { authenticated: true, user: session.user }
+ *   },
+ *   canEdit: async (user, pageId) => {
+ *     return { allowed: hasRole(user, 'editor') }
+ *   },
+ * }
+ * ```
+ */
+export interface PuckApiAuthHooks {
+    /**
+     * Authenticate the incoming request
+     * Should return the authenticated user or authentication failure
+     */
+    authenticate: (request: NextRequest) => Promise<AuthResult>;
+    /**
+     * Check if user can list pages
+     * @default Always allowed for authenticated users
+     */
+    canList?: (user: AuthenticatedUser) => Promise<PermissionResult> | PermissionResult;
+    /**
+     * Check if user can view a specific page
+     * @default Always allowed for authenticated users
+     */
+    canView?: (user: AuthenticatedUser, pageId: string) => Promise<PermissionResult> | PermissionResult;
+    /**
+     * Check if user can create new pages
+     * @default Always allowed for authenticated users
+     */
+    canCreate?: (user: AuthenticatedUser) => Promise<PermissionResult> | PermissionResult;
+    /**
+     * Check if user can edit a specific page
+     * @default Always allowed for authenticated users
+     */
+    canEdit?: (user: AuthenticatedUser, pageId: string) => Promise<PermissionResult> | PermissionResult;
+    /**
+     * Check if user can publish a specific page (change status to published)
+     * @default Same as canEdit
+     */
+    canPublish?: (user: AuthenticatedUser, pageId: string) => Promise<PermissionResult> | PermissionResult;
+    /**
+     * Check if user can delete a specific page
+     * @default Always allowed for authenticated users
+     */
+    canDelete?: (user: AuthenticatedUser, pageId: string) => Promise<PermissionResult> | PermissionResult;
+}
+/**
+ * Mapping configuration for syncing Puck root.props to Payload fields
+ *
+ * @example
+ * ```typescript
+ * // Simple mapping
+ * { from: 'pageLayout', to: 'pageLayout' }
+ *
+ * // Nested field mapping (uses official @payloadcms/plugin-seo convention)
+ * { from: 'title', to: 'meta.title' }
+ *
+ * // With transformation
+ * {
+ *   from: 'publishDate',
+ *   to: 'publishedAt',
+ *   transform: (value) => value ? new Date(value as string).toISOString() : null
+ * }
+ * ```
+ */
+export interface RootPropsMapping {
+    /**
+     * Property name in Puck root.props
+     */
+    from: string;
+    /**
+     * Field path in Payload document (supports dot notation for nested fields)
+     */
+    to: string;
+    /**
+     * Optional transformation function
+     */
+    transform?: (value: unknown) => unknown;
+}
+/**
+ * Error context passed to onError callback
+ */
+export interface ErrorContext {
+    operation: string;
+    request: NextRequest;
+    pageId?: string;
+}
+/**
+ * Configuration for Puck API routes
+ *
+ * @example
+ * ```typescript
+ * const config: PuckApiRoutesConfig = {
+ *   collection: 'pages',
+ *   auth: {
+ *     authenticate: async (request) => {
+ *       // Your auth logic here
+ *     },
+ *     canPublish: async (user) => {
+ *       return { allowed: user.role === 'admin' }
+ *     },
+ *   },
+ *   rootPropsMapping: [
+ *     { from: 'title', to: 'meta.title' },
+ *     { from: 'description', to: 'meta.description' },
+ *   ],
+ *   enableDrafts: true,
+ * }
+ * ```
+ */
+export interface PuckApiRoutesConfig {
+    /**
+     * Payload collection slug for pages
+     * @default 'pages'
+     */
+    collection?: string;
+    /**
+     * Payload configuration - import from @payload-config
+     * Required for Turbopack/Next.js 16+ compatibility
+     *
+     * @example
+     * ```typescript
+     * import config from '@payload-config'
+     *
+     * createPuckApiRoutesWithId({
+     *   payloadConfig: config,
+     *   // ...
+     * })
+     * ```
+     */
+    payloadConfig: Promise<import('payload').SanitizedConfig>;
+    /**
+     * Authentication and authorization hooks
+     */
+    auth: PuckApiAuthHooks;
+    /**
+     * Custom mappings from Puck root.props to Payload fields
+     * These are merged with the default mappings
+     */
+    rootPropsMapping?: RootPropsMapping[];
+    /**
+     * Default Puck data for new pages
+     */
+    defaultPuckData?: PuckData;
+    /**
+     * Enable draft mode for page creation/updates
+     * @default true
+     */
+    enableDrafts?: boolean;
+    /**
+     * Custom error handler for logging/monitoring
+     */
+    onError?: (error: unknown, context: ErrorContext) => void;
+}
+/**
+ * Context passed to Next.js App Router route handlers
+ */
+export interface RouteHandlerContext {
+    params: Promise<Record<string, string>>;
+}
+/**
+ * Context for route handlers that require an id parameter
+ */
+export interface RouteHandlerWithIdContext {
+    params: Promise<{
+        id: string;
+    }>;
+}
+/**
+ * Next.js App Router route handler type
+ */
+export type RouteHandler = (request: NextRequest, context: RouteHandlerContext) => Promise<Response>;
+/**
+ * Next.js App Router route handler type for [id] routes
+ */
+export type RouteHandlerWithId = (request: NextRequest, context: RouteHandlerWithIdContext) => Promise<Response>;
+/**
+ * Route handlers returned by createPuckApiRoutes
+ */
+export interface PuckApiRouteHandlers {
+    GET: RouteHandler;
+    POST: RouteHandler;
+}
+/**
+ * Route handlers returned by createPuckApiRoutesWithId
+ */
+export interface PuckApiRouteWithIdHandlers {
+    GET: RouteHandlerWithId;
+    PATCH: RouteHandlerWithId;
+    DELETE: RouteHandlerWithId;
+}
+/**
+ * Request body for creating a new page
+ */
+export interface CreatePageBody {
+    title: string;
+    slug: string;
+    puckData?: PuckData;
+    status?: 'draft' | 'published';
+}
+/**
+ * Request body for updating a page
+ */
+export interface UpdatePageBody {
+    puckData?: PuckData;
+    title?: string;
+    slug?: string;
+    status?: 'draft' | 'published';
+    /**
+     * When true, save as draft without publishing.
+     * Used by Payload's versions.drafts system.
+     */
+    draft?: boolean;
+    /**
+     * Folder ID for page-tree integration.
+     * When page-tree plugin is active, this determines the page's parent folder.
+     */
+    folder?: string | null;
+    /**
+     * Page segment for page-tree integration.
+     * Combined with folder path to generate the full slug.
+     */
+    pageSegment?: string;
+}
+/**
+ * Standard API response wrapper
+ */
+export interface ApiResponse<T = unknown> {
+    doc?: T;
+    docs?: T[];
+    error?: string;
+    success?: boolean;
+    totalDocs?: number;
+    totalPages?: number;
+    page?: number;
+    limit?: number;
+    hasPrevPage?: boolean;
+    hasNextPage?: boolean;
+}
+/**
+ * A version entry from Payload's versions system
+ */
+export interface PageVersion {
+    id: string;
+    parent: string;
+    version: {
+        title?: string;
+        slug?: string;
+        puckData?: PuckData;
+        _status?: 'draft' | 'published';
+        updatedAt: string;
+        createdAt: string;
+    };
+    createdAt: string;
+    updatedAt: string;
+    autosave?: boolean;
+    latest?: boolean;
+}
+/**
+ * Route handlers returned by createPuckApiRoutesVersions
+ */
+export interface PuckApiVersionsRouteHandlers {
+    GET: RouteHandlerWithId;
+    POST: RouteHandlerWithId;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/api/types.d.ts.map

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

package/dist/api/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/api/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":""}

package/dist/api/utils/mapRootProps.d.ts

@@ -0,0 +1,76 @@
+import type { RootPropsMapping } from '../types';
+/**
+ * Default mappings from Puck root.props to Payload fields
+ *
+ * These mappings sync common page properties from Puck's visual editor
+ * to the corresponding Payload collection fields.
+ *
+ * SEO fields use the official @payloadcms/plugin-seo convention: meta.title, meta.description
+ */
+export declare const DEFAULT_ROOT_PROPS_MAPPINGS: RootPropsMapping[];
+/**
+ * Set a nested value in an object using dot notation path
+ *
+ * @example
+ * ```typescript
+ * const obj = {}
+ * setNestedValue(obj, 'meta.title', 'My Title')
+ * // Result: { meta: { title: 'My Title' } }
+ * ```
+ */
+export declare function setNestedValue(obj: Record<string, unknown>, path: string, value: unknown): void;
+/**
+ * Get a nested value from an object using dot notation path
+ *
+ * @example
+ * ```typescript
+ * const obj = { meta: { title: 'My Title' } }
+ * getNestedValue(obj, 'meta.title') // 'My Title'
+ * ```
+ */
+export declare function getNestedValue(obj: Record<string, unknown>, path: string): unknown;
+/**
+ * Merge mappings, with custom mappings taking precedence over defaults
+ *
+ * @param customMappings - Custom mappings to merge with defaults
+ * @returns Merged array of mappings with duplicates resolved (custom wins)
+ */
+export declare function mergeMappings(customMappings?: RootPropsMapping[]): RootPropsMapping[];
+/**
+ * Map Puck root.props to Payload field update data
+ *
+ * Takes the root.props from Puck data and maps them to the appropriate
+ * Payload fields based on the provided mappings.
+ *
+ * @param rootProps - The root.props object from Puck data
+ * @param customMappings - Optional custom mappings to merge with defaults
+ * @returns Object ready to be spread into Payload update data
+ *
+ * @example
+ * ```typescript
+ * const rootProps = {
+ *   title: 'My Page',
+ *   metaTitle: 'My Page | Site Name',
+ *   metaDescription: 'Description here',
+ * }
+ *
+ * const updateData = mapRootPropsToPayloadFields(rootProps)
+ * // Result: {
+ * //   title: 'My Page',
+ * //   meta: {
+ * //     title: 'My Page | Site Name',
+ * //     description: 'Description here',
+ * //   },
+ * // }
+ * ```
+ */
+export declare function mapRootPropsToPayloadFields(rootProps: Record<string, unknown>, customMappings?: RootPropsMapping[]): Record<string, unknown>;
+/**
+ * Deep merge objects, with source values overwriting target values
+ *
+ * @param target - The target object to merge into
+ * @param source - The source object to merge from
+ * @returns The merged object (target is modified in place)
+ */
+export declare function deepMerge(target: Record<string, unknown>, source: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=mapRootProps.d.ts.map

package/dist/api/utils/mapRootProps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapRootProps.d.ts","sourceRoot":"","sources":["../../../src/api/utils/mapRootProps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAEhD;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,EAAE,gBAAgB,EAuBzD,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,IAAI,CAcN;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,EAAE,MAAM,GACX,OAAO,CAeT;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,cAAc,CAAC,EAAE,gBAAgB,EAAE,GAClC,gBAAgB,EAAE,CAmBpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,cAAc,CAAC,EAAE,gBAAgB,EAAE,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBzB;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyBzB"}

package/dist/api/utils/mapRootProps.js

@@ -0,0 +1,169 @@
+/**
+ * Default mappings from Puck root.props to Payload fields
+ *
+ * These mappings sync common page properties from Puck's visual editor
+ * to the corresponding Payload collection fields.
+ *
+ * SEO fields use the official @payloadcms/plugin-seo convention: meta.title, meta.description
+ */
+export const DEFAULT_ROOT_PROPS_MAPPINGS = [
+    // Core page fields
+    { from: 'title', to: 'title' },
+    { from: 'slug', to: 'slug' },
+    { from: 'pageLayout', to: 'pageLayout' },
+    { from: 'pageType', to: 'pageType' },
+    { from: 'isHomepage', to: 'isHomepage' },
+    // Page-tree integration fields
+    { from: 'folder', to: 'folder' },
+    { from: 'pageSegment', to: 'pageSegment' },
+    // SEO/Meta fields (uses official @payloadcms/plugin-seo convention)
+    { from: 'metaTitle', to: 'meta.title' },
+    { from: 'metaDescription', to: 'meta.description' },
+    { from: 'noindex', to: 'meta.noindex' },
+    { from: 'nofollow', to: 'meta.nofollow' },
+    { from: 'excludeFromSitemap', to: 'meta.excludeFromSitemap' },
+    // Conversion tracking fields
+    { from: 'isConversionPage', to: 'conversionTracking.isConversionPage' },
+    { from: 'conversionType', to: 'conversionTracking.conversionType' },
+    { from: 'conversionValue', to: 'conversionTracking.conversionValue' },
+];
+/**
+ * Set a nested value in an object using dot notation path
+ *
+ * @example
+ * ```typescript
+ * const obj = {}
+ * setNestedValue(obj, 'meta.title', 'My Title')
+ * // Result: { meta: { title: 'My Title' } }
+ * ```
+ */
+export function setNestedValue(obj, path, value) {
+    const keys = path.split('.');
+    let current = obj;
+    for (let i = 0; i < keys.length - 1; i++) {
+        const key = keys[i];
+        if (!(key in current) || typeof current[key] !== 'object') {
+            current[key] = {};
+        }
+        current = current[key];
+    }
+    const finalKey = keys[keys.length - 1];
+    current[finalKey] = value;
+}
+/**
+ * Get a nested value from an object using dot notation path
+ *
+ * @example
+ * ```typescript
+ * const obj = { meta: { title: 'My Title' } }
+ * getNestedValue(obj, 'meta.title') // 'My Title'
+ * ```
+ */
+export function getNestedValue(obj, path) {
+    const keys = path.split('.');
+    let current = obj;
+    for (const key of keys) {
+        if (current === null || current === undefined) {
+            return undefined;
+        }
+        if (typeof current !== 'object') {
+            return undefined;
+        }
+        current = current[key];
+    }
+    return current;
+}
+/**
+ * Merge mappings, with custom mappings taking precedence over defaults
+ *
+ * @param customMappings - Custom mappings to merge with defaults
+ * @returns Merged array of mappings with duplicates resolved (custom wins)
+ */
+export function mergeMappings(customMappings) {
+    if (!customMappings || customMappings.length === 0) {
+        return DEFAULT_ROOT_PROPS_MAPPINGS;
+    }
+    // Create a map to track unique mappings by 'from' field
+    const mappingMap = new Map();
+    // Add defaults first
+    for (const mapping of DEFAULT_ROOT_PROPS_MAPPINGS) {
+        mappingMap.set(mapping.from, mapping);
+    }
+    // Custom mappings override defaults
+    for (const mapping of customMappings) {
+        mappingMap.set(mapping.from, mapping);
+    }
+    return Array.from(mappingMap.values());
+}
+/**
+ * Map Puck root.props to Payload field update data
+ *
+ * Takes the root.props from Puck data and maps them to the appropriate
+ * Payload fields based on the provided mappings.
+ *
+ * @param rootProps - The root.props object from Puck data
+ * @param customMappings - Optional custom mappings to merge with defaults
+ * @returns Object ready to be spread into Payload update data
+ *
+ * @example
+ * ```typescript
+ * const rootProps = {
+ *   title: 'My Page',
+ *   metaTitle: 'My Page | Site Name',
+ *   metaDescription: 'Description here',
+ * }
+ *
+ * const updateData = mapRootPropsToPayloadFields(rootProps)
+ * // Result: {
+ * //   title: 'My Page',
+ * //   meta: {
+ * //     title: 'My Page | Site Name',
+ * //     description: 'Description here',
+ * //   },
+ * // }
+ * ```
+ */
+export function mapRootPropsToPayloadFields(rootProps, customMappings) {
+    const mappings = mergeMappings(customMappings);
+    const result = {};
+    for (const mapping of mappings) {
+        const value = rootProps[mapping.from];
+        // Skip undefined values to avoid overwriting existing data
+        if (value === undefined) {
+            continue;
+        }
+        // Apply transformation if provided
+        const transformedValue = mapping.transform ? mapping.transform(value) : value;
+        // Set the value at the target path
+        setNestedValue(result, mapping.to, transformedValue);
+    }
+    return result;
+}
+/**
+ * Deep merge objects, with source values overwriting target values
+ *
+ * @param target - The target object to merge into
+ * @param source - The source object to merge from
+ * @returns The merged object (target is modified in place)
+ */
+export function deepMerge(target, source) {
+    for (const key of Object.keys(source)) {
+        const sourceValue = source[key];
+        const targetValue = target[key];
+        if (sourceValue !== null &&
+            typeof sourceValue === 'object' &&
+            !Array.isArray(sourceValue) &&
+            targetValue !== null &&
+            typeof targetValue === 'object' &&
+            !Array.isArray(targetValue)) {
+            // Recursively merge nested objects
+            target[key] = deepMerge(targetValue, sourceValue);
+        }
+        else {
+            // Direct assignment for non-object values or arrays
+            target[key] = sourceValue;
+        }
+    }
+    return target;
+}
+//# sourceMappingURL=mapRootProps.js.map

package/dist/api/utils/mapRootProps.js.map

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

package/dist/collections/Templates.d.ts

@@ -0,0 +1,9 @@
+import type { CollectionConfig } from 'payload';
+/**
+ * Templates Collection - Stores reusable Puck component configurations
+ *
+ * This collection stores serialized Puck component data that can be
+ * loaded into Template components for reuse across pages.
+ */
+export declare const TemplatesCollection: CollectionConfig;
+//# sourceMappingURL=Templates.d.ts.map

package/dist/collections/Templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Templates.d.ts","sourceRoot":"","sources":["../../src/collections/Templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,gBAsDjC,CAAA"}

package/dist/collections/Templates.js

@@ -0,0 +1,62 @@
+/**
+ * Templates Collection - Stores reusable Puck component configurations
+ *
+ * This collection stores serialized Puck component data that can be
+ * loaded into Template components for reuse across pages.
+ */
+export const TemplatesCollection = {
+    slug: 'puck-templates',
+    admin: {
+        useAsTitle: 'name',
+        group: 'Puck',
+        defaultColumns: ['name', 'category', 'updatedAt'],
+        description: 'Reusable component templates for the visual editor',
+    },
+    access: {
+        read: () => true,
+        create: ({ req }) => !!req.user,
+        update: ({ req }) => !!req.user,
+        delete: ({ req }) => !!req.user,
+    },
+    fields: [
+        {
+            name: 'name',
+            type: 'text',
+            required: true,
+            admin: {
+                description: 'A descriptive name for this template',
+            },
+        },
+        {
+            name: 'description',
+            type: 'textarea',
+            admin: {
+                description: 'Optional description of what this template contains',
+            },
+        },
+        {
+            name: 'category',
+            type: 'text',
+            admin: {
+                description: 'Category for organizing templates (e.g., "Hero", "Footer", "CTA")',
+            },
+        },
+        {
+            name: 'content',
+            type: 'json',
+            required: true,
+            admin: {
+                description: 'Serialized Puck component data',
+            },
+        },
+        {
+            name: 'thumbnail',
+            type: 'text',
+            admin: {
+                description: 'Optional thumbnail URL for template preview',
+            },
+        },
+    ],
+    timestamps: true,
+};
+//# sourceMappingURL=Templates.js.map

package/dist/collections/Templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Templates.js","sourceRoot":"","sources":["../../src/collections/Templates.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAqB;IACnD,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE;QACL,UAAU,EAAE,MAAM;QAClB,KAAK,EAAE,MAAM;QACb,cAAc,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,CAAC;QACjD,WAAW,EAAE,oDAAoD;KAClE;IACD,MAAM,EAAE;QACN,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI;QAChB,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI;QAC/B,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI;QAC/B,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI;KAChC;IACD,MAAM,EAAE;QACN;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE;gBACL,WAAW,EAAE,sCAAsC;aACpD;SACF;QACD;YACE,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE;gBACL,WAAW,EAAE,qDAAqD;aACnE;SACF;QACD;YACE,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE;gBACL,WAAW,EAAE,mEAAmE;aACjF;SACF;QACD;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE;gBACL,WAAW,EAAE,gCAAgC;aAC9C;SACF;QACD;YACE,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE;gBACL,WAAW,EAAE,6CAA6C;aAC3D;SACF;KACF;IACD,UAAU,EAAE,IAAI;CACjB,CAAA"}

package/dist/components/AccordionClient.d.ts

@@ -0,0 +1,20 @@
+import { type PaddingValue, type DimensionsValue, type BackgroundValue, type AnimationValue, type TransformValue, type ColorValue } from '../fields/shared';
+interface AccordionItemData {
+    title: string;
+    content: string;
+    defaultOpen: boolean;
+}
+export interface AccordionClientProps {
+    items: AccordionItemData[];
+    allowMultiple: boolean;
+    textColor: ColorValue | null;
+    margin: PaddingValue | null;
+    background: BackgroundValue | null;
+    dimensions: DimensionsValue | null;
+    transform: TransformValue | null;
+    animation: AnimationValue | null;
+    customPadding: PaddingValue | null;
+}
+export declare function AccordionClient({ items, allowMultiple, textColor, margin, background, dimensions, transform, animation, customPadding, }: AccordionClientProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=AccordionClient.d.ts.map

package/dist/components/AccordionClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccordionClient.d.ts","sourceRoot":"","sources":["../../src/components/AccordionClient.tsx"],"names":[],"mappings":"AAWA,OAAO,EAQL,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAA;AAGzB,UAAU,iBAAiB;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,OAAO,CAAA;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,iBAAiB,EAAE,CAAA;IAC1B,aAAa,EAAE,OAAO,CAAA;IACtB,SAAS,EAAE,UAAU,GAAG,IAAI,CAAA;IAC5B,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;IAC3B,UAAU,EAAE,eAAe,GAAG,IAAI,CAAA;IAClC,UAAU,EAAE,eAAe,GAAG,IAAI,CAAA;IAClC,SAAS,EAAE,cAAc,GAAG,IAAI,CAAA;IAChC,SAAS,EAAE,cAAc,GAAG,IAAI,CAAA;IAChC,aAAa,EAAE,YAAY,GAAG,IAAI,CAAA;CACnC;AAiDD,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,aAAa,EACb,SAAS,EACT,MAAM,EACN,UAAU,EACV,UAAU,EACV,SAAS,EACT,SAAS,EACT,aAAa,GACd,EAAE,oBAAoB,2CAiFtB"}