@infuro/cms-core 1.0.23 → 1.0.24

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';
@@ -111,8 +126,13 @@ type CrudFilterItem = {
     label: string;
     type: 'select' | 'dateRange' | 'text';
     options?: CrudFilterOption[];
+    /** When set, merge runtime options from relation list fetch (id → label). */
+    relationApi?: string;
+    relationLabelField?: string;
+    relationValueField?: 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 +141,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;

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';
@@ -111,8 +126,13 @@ type CrudFilterItem = {
     label: string;
     type: 'select' | 'dateRange' | 'text';
     options?: CrudFilterOption[];
+    /** When set, merge runtime options from relation list fetch (id → label). */
+    relationApi?: string;
+    relationLabelField?: string;
+    relationValueField?: 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 +141,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;