litecms 0.1.0

package/dist/admin/index.d.ts

@@ -0,0 +1,147 @@
+import { z } from 'zod';
+import type { SchemaDefinition } from '../schema';
+import type { ActionState } from '../server';
+import type { ImageUploadConfig } from '../components/CmsSimpleForm';
+/**
+ * Configuration for a CMS page
+ */
+export type CmsPageConfig = {
+    /** URL slug for the admin page (e.g., 'home', 'about') */
+    slug: string;
+    /** Display name in navigation */
+    title: string;
+    /** Description to help guide the user (shown below title) */
+    description?: string;
+    /** Public URL path for this page (e.g., '/', '/about', '/work'). Used for auto-generated navigation. */
+    path?: string;
+    /** Schema definition with field metadata */
+    definition: SchemaDefinition<any>;
+    /** Server action to save data */
+    action: (prevState: ActionState<any>, formData: FormData) => Promise<ActionState<any>>;
+    /** Function to fetch current data */
+    getData: () => Promise<any>;
+    /** Icon name (optional, for nav) */
+    icon?: string;
+    /** Order in navigation (lower = higher) */
+    order?: number;
+    /** Group in navigation */
+    group?: string;
+};
+/**
+ * Strongly typed page config
+ */
+export type TypedCmsPageConfig<T extends z.ZodRawShape> = {
+    slug: string;
+    title: string;
+    /** Description to help guide the user (shown below title) */
+    description?: string;
+    /** Public URL path for this page (e.g., '/', '/about', '/work'). Used for auto-generated navigation. */
+    path?: string;
+    definition: SchemaDefinition<T>;
+    action: (prevState: ActionState<z.infer<z.ZodObject<T>>>, formData: FormData) => Promise<ActionState<z.infer<z.ZodObject<T>>>>;
+    getData: () => Promise<z.infer<z.ZodObject<T>>>;
+    icon?: string;
+    order?: number;
+    group?: string;
+};
+/**
+ * Full CMS configuration
+ */
+export type CmsConfig = {
+    /** Site name shown in admin header */
+    siteName?: string;
+    /** Admin panel title */
+    adminTitle?: string;
+    /** Base path for admin (default: '/admin') */
+    basePath?: string;
+    /** Link to public site */
+    publicSiteUrl?: string;
+    /** Registered pages */
+    pages: CmsPageConfig[];
+    /** Configuration for image upload endpoints in form components */
+    storage?: ImageUploadConfig;
+};
+/**
+ * Create a CMS configuration with typed pages.
+ *
+ * @example
+ * ```ts
+ * export const cmsConfig = createCmsConfig({
+ *   siteName: 'My Site',
+ *   pages: [
+ *     definePage({
+ *       slug: 'home',
+ *       title: 'Homepage',
+ *       definition: HomePageDef,
+ *       action: saveHome,
+ *       getData: getHomePageData,
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+export declare function createCmsConfig(config: CmsConfig): CmsConfig;
+/**
+ * Get the current CMS config
+ */
+export declare function getCmsConfig(): CmsConfig;
+/**
+ * Get a page config by slug
+ */
+export declare function getPageBySlug(slug: string): CmsPageConfig | undefined;
+/**
+ * Get all page configs for navigation
+ */
+export declare function getNavPages(): Array<{
+    slug: string;
+    title: string;
+    href: string;
+    group?: string;
+}>;
+/**
+ * Helper to create a page config with type inference.
+ * Use this to get type checking on individual page configs.
+ */
+export declare function definePage<T extends z.ZodRawShape>(config: TypedCmsPageConfig<T>): CmsPageConfig;
+/**
+ * Navigation link extracted from page data
+ */
+export type NavLink = {
+    label: string;
+    href: string;
+    order: number;
+};
+/**
+ * Page info needed for building navigation
+ */
+export type PageNavInfo = {
+    slug: string;
+    path: string;
+    title: string;
+    getData: () => Promise<unknown>;
+};
+/**
+ * Get pages that have a public path defined (for navigation building)
+ */
+export declare function getNavigablePages(): PageNavInfo[];
+/**
+ * Page group
+ */
+export type PageGroup = {
+    name: string | null;
+    pages: Array<{
+        slug: string;
+        title: string;
+        icon?: string;
+    }>;
+};
+/**
+ * Navigation page info
+ */
+export type NavPageInfo = {
+    slug: string;
+    title: string;
+    group?: string;
+    icon?: string;
+};
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/components/CmsAutoForm.d.ts

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+import type { SchemaDefinition } from '../schema';
+import type { ServerAction } from './index';
+/**
+ * Style configuration for auto-generated forms
+ * TODO: Is this still needed?
+ */
+export type CmsAutoFormStyles = {
+    /** Wrapper div className */
+    wrapper?: string;
+    /** Field wrapper className */
+    field?: string;
+    /** Label className */
+    label?: string;
+    /** Input className */
+    input?: string;
+    /** Error message className */
+    error?: string;
+    /** Help text className */
+    help?: string;
+    /** Group wrapper className */
+    group?: string;
+    /** Group title className */
+    groupTitle?: string;
+    /** Form error className */
+    formError?: string;
+    /** Form success className */
+    formSuccess?: string;
+    /** Submit button className */
+    submitButton?: string;
+};
+export type CmsAutoFormProps<T extends z.ZodRawShape> = {
+    /** Schema definition with field metadata */
+    definition: SchemaDefinition<T>;
+    /** Server action to call on submit */
+    action: ServerAction<z.infer<z.ZodObject<T>>>;
+    /** Current values from the database */
+    values?: Partial<z.infer<z.ZodObject<T>>>;
+    /** Style classes for form elements */
+    styles?: CmsAutoFormStyles;
+    /** Submit button text */
+    submitText?: string;
+    /** Submit button pending text */
+    submitPendingText?: string;
+    /** Success message */
+    successMessage?: string;
+    /** Called when form submission succeeds */
+    onSuccess?: (data: z.infer<z.ZodObject<T>>) => void;
+};
+/**
+ * Auto-generated CMS form based on a schema definition.
+ *
+ * Use this component when you have direct access to the `SchemaDefinition` object
+ * (e.g., in a client component that imports the schema directly).
+ *
+ * For server components or when fields need to be serialized, use `CmsSimpleForm` instead
+ * (which accepts pre-extracted `FieldInfo[]`).
+ *
+ * @example
+ * ```tsx
+ * import { HomePageDef } from '@/cms/schemas/home';
+ *
+ * <CmsAutoForm
+ *     definition={HomePageDef}
+ *     action={saveHome}
+ *     values={currentData}
+ * />
+ * ```
+ *
+ * @see CmsSimpleForm - for use with pre-extracted fields (serializable)
+ */
+export declare function CmsAutoForm<T extends z.ZodRawShape>({ definition, action, values, styles, submitText, submitPendingText, successMessage, onSuccess, }: CmsAutoFormProps<T>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=CmsAutoForm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CmsAutoForm.d.ts","sourceRoot":"","sources":["../../src/components/CmsAutoForm.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAa,MAAM,WAAW,CAAC;AAE7D,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,SAAS,CAAC;AAa5D;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC5B,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,IAAI;IACpD,4CAA4C;IAC5C,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAChC,sCAAsC;IACtC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,uCAAuC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,sCAAsC;IACtC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,yBAAyB;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sBAAsB;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CACvD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,EACjD,UAAU,EACV,MAAM,EACN,MAAM,EACN,MAAW,EACX,UAA2B,EAC3B,iBAA+B,EAC/B,cAA6C,EAC7C,SAAS,GACZ,EAAE,gBAAgB,CAAC,CAAC,CAAC,2CA+DrB"}

package/dist/components/CmsField.d.ts

@@ -0,0 +1,50 @@
+import { type FieldPath, type FieldValues } from 'react-hook-form';
+export type CmsFieldProps<TFieldValues extends FieldValues = FieldValues> = {
+    /** Field name (must match schema key, supports dot notation for nested fields) */
+    name: FieldPath<TFieldValues>;
+    /** Label text */
+    label: string;
+    /** Input type */
+    type?: 'text' | 'textarea' | 'number' | 'email' | 'url' | 'select';
+    /** Placeholder text */
+    placeholder?: string;
+    /** Help text shown below the input */
+    helpText?: string;
+    /** Options for select type */
+    options?: Array<{
+        value: string;
+        label: string;
+    }>;
+    /** Number of rows for textarea (default: 4) */
+    rows?: number;
+    /** Whether the field is required */
+    required?: boolean;
+    /** Whether the field is disabled */
+    disabled?: boolean;
+    /** Optional className for the wrapper */
+    className?: string;
+    /** Optional className for the input */
+    inputClassName?: string;
+    /** Optional className for the label */
+    labelClassName?: string;
+    /** Optional className for the error message */
+    errorClassName?: string;
+    /** Optional className for the help text */
+    helpClassName?: string;
+};
+/**
+ * CMS Field component.
+ */
+export declare function CmsField<TFieldValues extends FieldValues = FieldValues>({ name, label, type, placeholder, helpText, options, rows, required, disabled, className, inputClassName, labelClassName, errorClassName, helpClassName, }: CmsFieldProps<TFieldValues>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hidden field for passing data that shouldn't be edited
+ */
+export declare function CmsHiddenField<TFieldValues extends FieldValues = FieldValues>({ name, value, }: {
+    name: FieldPath<TFieldValues>;
+    value: string;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * Checkbox field
+ */
+export declare function CmsCheckbox<TFieldValues extends FieldValues = FieldValues>({ name, label, helpText, disabled, className, inputClassName, labelClassName, errorClassName, helpClassName, }: Omit<CmsFieldProps<TFieldValues>, 'type' | 'placeholder' | 'options' | 'rows' | 'required'>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=CmsField.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CmsField.d.ts","sourceRoot":"","sources":["../../src/components/CmsField.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEH,KAAK,SAAS,EACd,KAAK,WAAW,EACnB,MAAM,iBAAiB,CAAC;AAGzB,MAAM,MAAM,aAAa,CAAC,YAAY,SAAS,WAAW,GAAG,WAAW,IAAI;IACxE,kFAAkF;IAClF,IAAI,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;IAC9B,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;IACnE,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uCAAuC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AA0BF;;GAEG;AACH,wBAAgB,QAAQ,CAAC,YAAY,SAAS,WAAW,GAAG,WAAW,EAAE,EACrE,IAAI,EACJ,KAAK,EACL,IAAa,EACb,WAAW,EACX,QAAQ,EACR,OAAY,EACZ,IAAQ,EACR,QAAgB,EAChB,QAAgB,EAChB,SAAuB,EACvB,cAAc,EACd,cAAc,EACd,cAAc,EACd,aAAa,GAChB,EAAE,aAAa,CAAC,YAAY,CAAC,2CA2H7B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,YAAY,SAAS,WAAW,GAAG,WAAW,EAAE,EAC3E,IAAI,EACJ,KAAK,GACR,EAAE;IACC,IAAI,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;CACjB,2CAEA;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,YAAY,SAAS,WAAW,GAAG,WAAW,EAAE,EACxE,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,QAAgB,EAChB,SAAuB,EACvB,cAAc,EACd,cAAc,EACd,cAAc,EACd,aAAa,GAChB,EAAE,IAAI,CACH,aAAa,CAAC,YAAY,CAAC,EAC3B,MAAM,GAAG,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAC3D,2CA+DA"}

package/dist/components/CmsForm.d.ts

@@ -0,0 +1,74 @@
+import * as React from 'react';
+import { type FieldValues, type DefaultValues } from 'react-hook-form';
+import type { z } from 'zod';
+import type { ActionState } from '../server';
+import type { ServerAction, CmsFormContextValue } from './index';
+export type CmsFormProps<TFormValues extends FieldValues> = {
+    /** Zod schema for validation */
+    schema: z.ZodType<TFormValues>;
+    /** Server action to call on submit */
+    action: ServerAction<TFormValues>;
+    /** Default values for the form */
+    defaultValues?: DefaultValues<TFormValues>;
+    /** Called when form submission succeeds */
+    onSuccess?: (data: TFormValues) => void;
+    /** Called when form submission fails */
+    onError?: (errors: ActionState['errors']) => void;
+    /** Form children */
+    children: React.ReactNode;
+    /** Optional className for the form */
+    className?: string;
+    /** Reset form to default values after successful submission */
+    resetOnSuccess?: boolean;
+};
+/**
+ * CMS Form wrapper that integrates react-hook-form with server actions.
+ *
+ * @example
+ * ```tsx
+ * <CmsForm schema={HomePageSchema} action={saveHome} defaultValues={data}>
+ *   <CmsField name="heroTitle" label="Hero Title" />
+ *   <CmsField name="heroSubtitle" label="Hero Subtitle" />
+ *   <CmsSubmitButton>Save</CmsSubmitButton>
+ * </CmsForm>
+ * ```
+ */
+export declare function CmsForm<TFormValues extends FieldValues>({ schema, action, defaultValues, onSuccess, onError, children, className, resetOnSuccess, }: CmsFormProps<TFormValues>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to access CMS form context
+ */
+export declare function useCmsForm(): CmsFormContextValue;
+/**
+ * Submit button that shows pending state
+ *
+ * @example
+ * ```tsx
+ * <CmsSubmitButton>Save Changes</CmsSubmitButton>
+ * ```
+ */
+export declare function CmsSubmitButton({ children, className, pendingText, }: {
+    children?: React.ReactNode;
+    className?: string;
+    pendingText?: string;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * Display form-level error message
+ */
+export declare function CmsFormError({ className }: {
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * Display success message after form submission
+ *
+ * @example
+ * ```tsx
+ * <CmsFormSuccess className="text-green-600">
+ *   Changes saved successfully!
+ * </CmsFormSuccess>
+ * ```
+ */
+export declare function CmsFormSuccess({ children, className, }: {
+    children?: React.ReactNode;
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=CmsForm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CmsForm.d.ts","sourceRoot":"","sources":["../../src/components/CmsForm.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAGH,KAAK,WAAW,EAChB,KAAK,aAAa,EAErB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEjE,MAAM,MAAM,YAAY,CAAC,WAAW,SAAS,WAAW,IAAI;IACxD,gCAAgC;IAChC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/B,sCAAsC;IACtC,MAAM,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC;IAClC,kCAAkC;IAClC,aAAa,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IAC3C,2CAA2C;IAC3C,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;IACxC,wCAAwC;IACxC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IAClD,oBAAoB;IACpB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAIF;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,WAAW,SAAS,WAAW,EAAE,EACrD,MAAM,EACN,MAAM,EACN,aAAa,EACb,SAAS,EACT,OAAO,EACP,QAAQ,EACR,SAAS,EACT,cAAsB,GACzB,EAAE,YAAY,CAAC,WAAW,CAAC,2CAiF3B;AAED;;GAEG;AACH,wBAAgB,UAAU,wBAMzB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,EAC5B,QAAiB,EACjB,SAAS,EACT,WAAyB,GAC5B,EAAE;IACC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,2CAQA;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,kDAUjE;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,EAC3B,QAAgC,EAChC,SAAS,GACZ,EAAE;IACC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB,kDAUA"}

package/dist/components/CmsImageField.d.ts

@@ -0,0 +1,33 @@
+import { type FieldPath, type FieldValues } from 'react-hook-form';
+export type CmsImageFieldProps<TFieldValues extends FieldValues = FieldValues> = {
+    /** Field name (must match schema key) */
+    name: FieldPath<TFieldValues>;
+    /** Label text */
+    label: string;
+    /** Help text shown below the input */
+    helpText?: string;
+    /** Whether the field is required */
+    required?: boolean;
+    /** Whether the field is disabled */
+    disabled?: boolean;
+    /** Accepted file types (default: 'image/*') */
+    accept?: string;
+    /** Optional className for the wrapper */
+    className?: string;
+    /** Optional className for the label */
+    labelClassName?: string;
+    /** Optional className for the error message */
+    errorClassName?: string;
+    /** Optional className for the help text */
+    helpClassName?: string;
+    /** Storage configuration for image uploads */
+    storage?: {
+        uploadEndpoint: string;
+        listEndpoint?: string;
+    };
+};
+/**
+ * Image Field component.
+ */
+export declare function CmsImageField<TFieldValues extends FieldValues = FieldValues>({ name, label, helpText, required, disabled, accept, className, labelClassName, errorClassName, helpClassName, storage, }: CmsImageFieldProps<TFieldValues>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=CmsImageField.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CmsImageField.d.ts","sourceRoot":"","sources":["../../src/components/CmsImageField.tsx"],"names":[],"mappings":"AACA,OAAO,EAEH,KAAK,SAAS,EACd,KAAK,WAAW,EACnB,MAAM,iBAAiB,CAAC;AAGzB,MAAM,MAAM,kBAAkB,CAAC,YAAY,SAAS,WAAW,GAAG,WAAW,IACzE;IACI,yCAAyC;IACzC,IAAI,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;IAC9B,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,OAAO,CAAC,EAAE;QACN,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACL,CAAC;AAUN;;GAEG;AACH,wBAAgB,aAAa,CAAC,YAAY,SAAS,WAAW,GAAG,WAAW,EAAE,EAC1E,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,QAAgB,EAChB,QAAgB,EAChB,MAAkB,EAClB,SAAuB,EACvB,cAAc,EACd,cAAc,EACd,aAAa,EACb,OAAO,GACV,EAAE,kBAAkB,CAAC,YAAY,CAAC,2CAkIlC"}

package/dist/components/CmsNavSection.d.ts

@@ -0,0 +1,7 @@
+import type { PageGroup } from '../admin';
+export declare function NavSection({ group, basePath, currentSlug, }: {
+    group: PageGroup;
+    basePath: string;
+    currentSlug?: string;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=CmsNavSection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CmsNavSection.d.ts","sourceRoot":"","sources":["../../src/components/CmsNavSection.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,wBAAgB,UAAU,CAAC,EACvB,KAAK,EACL,QAAQ,EACR,WAAW,GACd,EAAE;IACC,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,2CA6BA"}

package/dist/components/CmsSimpleForm.d.ts

@@ -0,0 +1,54 @@
+import type { FieldInfo } from '../schema';
+import type { ServerAction, ImageUploadConfig } from './index';
+export type CmsAutoFormStyles = {
+    wrapper?: string;
+    field?: string;
+    label?: string;
+    input?: string;
+    error?: string;
+    help?: string;
+    group?: string;
+    groupTitle?: string;
+    formError?: string;
+    formSuccess?: string;
+    submitButton?: string;
+};
+export type CmsSimpleFormProps = {
+    /** Pre-extracted field info */
+    fields: FieldInfo[];
+    /** Server action to call on submit */
+    action: ServerAction<Record<string, unknown>>;
+    /** Current values */
+    values?: Record<string, unknown>;
+    /** Style classes */
+    styles?: CmsAutoFormStyles;
+    /** Submit button text */
+    submitText?: string;
+    /** Submit button pending text */
+    submitPendingText?: string;
+    /** Success message */
+    successMessage?: string;
+    /** Configuration for image upload endpoints */
+    storage?: ImageUploadConfig;
+};
+export type { ImageUploadConfig, StorageConfig } from './index';
+/**
+ * Simple Form component that renders a form from pre-extracted field information.
+ *
+ * Use this component when fields have already been extracted from a schema definition
+ * (e.g., in server components where the `SchemaDefinition` cannot be passed directly,
+ * or when using `extractPageProps` from `litecms/admin/config`).
+ *
+ * For client components with direct access to the schema, prefer `CmsAutoForm` instead.
+ *
+ * @example
+ * ```tsx
+ * // In a server component
+ * const props = await extractPageProps(cmsConfig, slug);
+ * return <CmsSimpleForm {...props} />;
+ * ```
+ *
+ * @see CmsAutoForm - for use with SchemaDefinition (not serializable)
+ */
+export declare function CmsSimpleForm({ fields, action, values, styles, submitText, submitPendingText, successMessage, storage, }: CmsSimpleFormProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=CmsSimpleForm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CmsSimpleForm.d.ts","sourceRoot":"","sources":["../../src/components/CmsSimpleForm.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAkB,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAS/E,MAAM,MAAM,iBAAiB,GAAG;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC7B,+BAA+B;IAC/B,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,sCAAsC;IACtC,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9C,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,oBAAoB;IACpB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,yBAAyB;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sBAAsB;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC/B,CAAC;AAEF,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEhE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,EAC1B,MAAM,EACN,MAAM,EACN,MAAW,EACX,MAAW,EACX,UAAmB,EACnB,iBAA+B,EAC/B,cAAgC,EAChC,OAAO,GACV,EAAE,kBAAkB,2CA0KpB"}

package/dist/components/index.d.ts

@@ -0,0 +1,43 @@
+import { ActionState } from '../server';
+import type { FieldInfo } from '../schema';
+export { CmsForm, useCmsForm, CmsSubmitButton, CmsFormError, CmsFormSuccess, type CmsFormProps, } from './CmsForm';
+export { CmsField, CmsHiddenField, CmsCheckbox, type CmsFieldProps, } from './CmsField';
+export { CmsImageField, type CmsImageFieldProps, } from './CmsImageField';
+export { CmsAutoForm, type CmsAutoFormProps, type CmsAutoFormStyles } from './CmsAutoForm';
+export type ServerAction<T> = (prevState: ActionState<T>, formData: FormData) => Promise<ActionState<T>>;
+export type FieldGroupData = {
+    name: string | null;
+    fields: FieldInfo[];
+};
+/**
+ * Context for CMS form state
+ */
+export type CmsFormContextValue = {
+    isPending: boolean;
+    formError?: string;
+    showSuccess: boolean;
+};
+export type StoredImage = {
+    key: string;
+    url: string;
+    lastModified?: string;
+    size?: number;
+};
+/**
+ * Configuration for client-side image upload endpoints.
+ * This is used by form components to upload/list images.
+ *
+ * @note This is different from `StorageConfig` in `litecms/storage` which
+ * configures the S3 client on the server side.
+ */
+export type ImageUploadConfig = {
+    /** API endpoint for uploading images */
+    uploadEndpoint: string;
+    /** API endpoint for listing images (optional) */
+    listEndpoint?: string;
+};
+/**
+ * @deprecated Use `ImageUploadConfig` instead. This alias exists for backwards compatibility.
+ */
+export type StorageConfig = ImageUploadConfig;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,EACH,OAAO,EACP,UAAU,EACV,eAAe,EACf,YAAY,EACZ,cAAc,EACd,KAAK,YAAY,GACpB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACH,QAAQ,EACR,cAAc,EACd,WAAW,EACX,KAAK,aAAa,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACH,aAAa,EACb,KAAK,kBAAkB,GAC1B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE3F,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAC1B,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,EACzB,QAAQ,EAAE,QAAQ,KACjB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7B,MAAM,MAAM,cAAc,GAAG;IACzB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,SAAS,EAAE,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC5B,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,iBAAiB,CAAC"}