@infuro/cms-core 1.0.23 → 1.0.25

package/dist/admin.d.cts

@@ -32,24 +32,39 @@ interface CustomNavSection {
     title: string;
     items: CustomNavItem[];
 }
+/** Single option for CRUD list filters and for `CustomCrudColumn.type === 'select'` form fields. */
+interface CrudFilterSelectOption {
+    value: string;
+    label: string;
+}
 interface CustomCrudColumn {
     field: string;
     displayName: string;
     type?: string;
+    /** Placeholder for plain text/number inputs in the CRUD modal form. */
+    placeholder?: string;
+    /**
+     * For `type: 'select'`: fixed choices in Add/Edit (e.g. job application status).
+     * Example: `{ field: 'status', displayName: 'Status', type: 'select', options: [{ value: 'new', label: 'New' }, ...] }`
+     */
+    options?: CrudFilterSelectOption[];
+    /** Initial value when creating a row (works with `select` and plain fields). */
+    defaultValue?: string | number | boolean;
     /** When set, form renders an async searchable relation dropdown instead of a plain input. */
     relationApi?: string;
     /** Field on the relation entity to show in the list (default: 'name'). */
     relationLabelField?: string;
     /** Field on the relation entity to use as value (default: 'id'). */
     relationValueField?: string;
-}
-/** Single filter: select (status, method, inventory) or dateRange or text (paymentRef, orderNumber). */
-interface CrudFilterSelectOption {
-    value: string;
-    label: string;
+    /** Override query param for auto-generated list filters (default: `field`). */
+    filterParam?: string;
+    /** Override filter control label (default: `displayName`). */
+    filterLabel?: string;
+    /** When `false`, this column is not used for auto-generated list filters. */
+    listFilter?: boolean;
 }
 interface CrudFilter {
-    /** Query param name (e.g. status, dateFrom, paymentRef). */
+    /** Query param name (e.g. status, dateFrom, paymentRef). List filter: select, dateRange, or text. */
     param: string;
     label: string;
     type: 'select' | 'dateRange' | 'text';
@@ -106,13 +121,31 @@ type CrudFilterOption = {
     value: string;
     label: string;
 };
+type CrudFilterFieldType = "select" | "dateRange" | "text" | "number" | "multiSelect";
 type CrudFilterItem = {
     param: string;
     label: string;
-    type: 'select' | 'dateRange' | 'text';
+    type: CrudFilterFieldType;
     options?: CrudFilterOption[];
+    /** When set, merge runtime options from relation list fetch (id → label). */
+    relationApi?: string;
+    relationLabelField?: string;
+    relationValueField?: string;
+    /**
+     * For `dateRange`: URL query keys (default `${param}From` / `${param}To`, e.g. `createdAtFrom`).
+     * Use explicit `dateFrom` / `dateTo` when `param` is `date` (legacy lists).
+     */
+    fromParam?: string;
+    toParam?: string;
+    /**
+     * For `number` filters: query keys for range (defaults `${param}Min`, `${param}Max`).
+     * List handlers must read these keys if server-side filtering is required.
+     */
+    minParam?: string;
+    maxParam?: string;
 };
-declare function AdminCRUD({ title, apiEndpoint, columns, addEditPageUrl, customViewPageUrl, defaultSortField, defaultSortOrder, filters, extraListParams, manageUserGroups, }: {
+
+declare function AdminCRUD({ title, apiEndpoint, columns, addEditPageUrl, customViewPageUrl, defaultSortField, defaultSortOrder, filters, filterColumns, extraListParams, manageUserGroups, }: {
     title: string;
     apiEndpoint: string;
     columns: any[];
@@ -121,6 +154,8 @@ declare function AdminCRUD({ title, apiEndpoint, columns, addEditPageUrl, custom
     defaultSortField?: string;
     defaultSortOrder?: 'asc' | 'desc';
     filters?: CrudFilterItem[];
+    /** Full column config for deriving list filters (`select`, `boolean`, `relationApi`). List `columns` may omit hidden fields. */
+    filterColumns?: any[];
     extraListParams?: Record<string, string>;
     /** When true, show group (role) selector for each user; requires GET /api/admin/roles. */
     manageUserGroups?: boolean;
@@ -134,15 +169,21 @@ type CreateEditFormProps = {
     apiEndpoint: string;
     columns: any[];
     existingData?: Record<string, unknown> | null;
+    /** When creating: pre-fill the modal from this row (POST only; omit `id` in payload). */
+    duplicateSeed?: Record<string, unknown> | null;
 };
-declare function CreateEditForm({ isOpen, onClose, onSaveSuccess, apiEndpoint, columns, existingData, }: CreateEditFormProps): react_jsx_runtime.JSX.Element | null;
+declare function CreateEditForm({ isOpen, onClose, onSaveSuccess, apiEndpoint, columns, existingData, duplicateSeed, }: CreateEditFormProps): react_jsx_runtime.JSX.Element | null;
 
-declare function FormBuilder({ formId }: {
+declare function FormBuilder({ formId, duplicateFromId, }: {
     formId?: string;
+    /** When creating (`!formId`), load this id and clone into a new form. */
+    duplicateFromId?: string;
 }): react_jsx_runtime.JSX.Element;
 
-declare function BlogEditor({ existingBlog }: {
+declare function BlogEditor({ existingBlog, duplicateSource, }: {
     existingBlog?: any;
+    /** Loaded row to copy into a new post (save always POSTs). */
+    duplicateSource?: any;
 }): react_jsx_runtime.JSX.Element;
 
 interface AnalyticsChartProps {

package/dist/admin.d.ts

@@ -32,24 +32,39 @@ interface CustomNavSection {
     title: string;
     items: CustomNavItem[];
 }
+/** Single option for CRUD list filters and for `CustomCrudColumn.type === 'select'` form fields. */
+interface CrudFilterSelectOption {
+    value: string;
+    label: string;
+}
 interface CustomCrudColumn {
     field: string;
     displayName: string;
     type?: string;
+    /** Placeholder for plain text/number inputs in the CRUD modal form. */
+    placeholder?: string;
+    /**
+     * For `type: 'select'`: fixed choices in Add/Edit (e.g. job application status).
+     * Example: `{ field: 'status', displayName: 'Status', type: 'select', options: [{ value: 'new', label: 'New' }, ...] }`
+     */
+    options?: CrudFilterSelectOption[];
+    /** Initial value when creating a row (works with `select` and plain fields). */
+    defaultValue?: string | number | boolean;
     /** When set, form renders an async searchable relation dropdown instead of a plain input. */
     relationApi?: string;
     /** Field on the relation entity to show in the list (default: 'name'). */
     relationLabelField?: string;
     /** Field on the relation entity to use as value (default: 'id'). */
     relationValueField?: string;
-}
-/** Single filter: select (status, method, inventory) or dateRange or text (paymentRef, orderNumber). */
-interface CrudFilterSelectOption {
-    value: string;
-    label: string;
+    /** Override query param for auto-generated list filters (default: `field`). */
+    filterParam?: string;
+    /** Override filter control label (default: `displayName`). */
+    filterLabel?: string;
+    /** When `false`, this column is not used for auto-generated list filters. */
+    listFilter?: boolean;
 }
 interface CrudFilter {
-    /** Query param name (e.g. status, dateFrom, paymentRef). */
+    /** Query param name (e.g. status, dateFrom, paymentRef). List filter: select, dateRange, or text. */
     param: string;
     label: string;
     type: 'select' | 'dateRange' | 'text';
@@ -106,13 +121,31 @@ type CrudFilterOption = {
     value: string;
     label: string;
 };
+type CrudFilterFieldType = "select" | "dateRange" | "text" | "number" | "multiSelect";
 type CrudFilterItem = {
     param: string;
     label: string;
-    type: 'select' | 'dateRange' | 'text';
+    type: CrudFilterFieldType;
     options?: CrudFilterOption[];
+    /** When set, merge runtime options from relation list fetch (id → label). */
+    relationApi?: string;
+    relationLabelField?: string;
+    relationValueField?: string;
+    /**
+     * For `dateRange`: URL query keys (default `${param}From` / `${param}To`, e.g. `createdAtFrom`).
+     * Use explicit `dateFrom` / `dateTo` when `param` is `date` (legacy lists).
+     */
+    fromParam?: string;
+    toParam?: string;
+    /**
+     * For `number` filters: query keys for range (defaults `${param}Min`, `${param}Max`).
+     * List handlers must read these keys if server-side filtering is required.
+     */
+    minParam?: string;
+    maxParam?: string;
 };
-declare function AdminCRUD({ title, apiEndpoint, columns, addEditPageUrl, customViewPageUrl, defaultSortField, defaultSortOrder, filters, extraListParams, manageUserGroups, }: {
+
+declare function AdminCRUD({ title, apiEndpoint, columns, addEditPageUrl, customViewPageUrl, defaultSortField, defaultSortOrder, filters, filterColumns, extraListParams, manageUserGroups, }: {
     title: string;
     apiEndpoint: string;
     columns: any[];
@@ -121,6 +154,8 @@ declare function AdminCRUD({ title, apiEndpoint, columns, addEditPageUrl, custom
     defaultSortField?: string;
     defaultSortOrder?: 'asc' | 'desc';
     filters?: CrudFilterItem[];
+    /** Full column config for deriving list filters (`select`, `boolean`, `relationApi`). List `columns` may omit hidden fields. */
+    filterColumns?: any[];
     extraListParams?: Record<string, string>;
     /** When true, show group (role) selector for each user; requires GET /api/admin/roles. */
     manageUserGroups?: boolean;
@@ -134,15 +169,21 @@ type CreateEditFormProps = {
     apiEndpoint: string;
     columns: any[];
     existingData?: Record<string, unknown> | null;
+    /** When creating: pre-fill the modal from this row (POST only; omit `id` in payload). */
+    duplicateSeed?: Record<string, unknown> | null;
 };
-declare function CreateEditForm({ isOpen, onClose, onSaveSuccess, apiEndpoint, columns, existingData, }: CreateEditFormProps): react_jsx_runtime.JSX.Element | null;
+declare function CreateEditForm({ isOpen, onClose, onSaveSuccess, apiEndpoint, columns, existingData, duplicateSeed, }: CreateEditFormProps): react_jsx_runtime.JSX.Element | null;
 
-declare function FormBuilder({ formId }: {
+declare function FormBuilder({ formId, duplicateFromId, }: {
     formId?: string;
+    /** When creating (`!formId`), load this id and clone into a new form. */
+    duplicateFromId?: string;
 }): react_jsx_runtime.JSX.Element;
 
-declare function BlogEditor({ existingBlog }: {
+declare function BlogEditor({ existingBlog, duplicateSource, }: {
     existingBlog?: any;
+    /** Loaded row to copy into a new post (save always POSTs). */
+    duplicateSource?: any;
 }): react_jsx_runtime.JSX.Element;
 
 interface AnalyticsChartProps {