feat: add configuration options to allow modifying hidden fields during create and edit

Author: ivictbor

adminforth/documentation/docs/tutorial/03-Customization/02-customFieldRendering.md

@@ -239,6 +239,9 @@ Sometimes a custom editor needs to update not only its own field, but also other
 
 For this, custom `edit`/`create` components can emit an `update:recordFieldValue` event with the payload `{ fieldName, fieldValue }`. AdminForth will update the corresponding field in the record.
 
+> If you emit `update:recordFieldValue` to modify a field which is hidden by `showIn.create: false` / `showIn.edit: false`, the backend will reject the request by default.
+> To allow this, set the target column config to `allowModifyWhenNotShowInCreate: true` and/or `allowModifyWhenNotShowInEdit: true`.
+
 ```html title='./custom/TitleWithSlugEditor.vue'
 <template>
   <div class="flex flex-col gap-2">

adminforth/documentation/docs/tutorial/08-Plugins/05-1-upload-api.md

@@ -284,6 +284,9 @@ Sometimes you want to upload a file from one field (custom editor) but store the
 2. Upload from the browser directly to storage.
 3. Emit `update:recordFieldValue` from the custom component with `{ fieldName: pathColumnName, fieldValue: filePath }` so the other field is updated.
 
+> Note: if the target UploadPlugin column is hidden on the current page (`showIn.create: false` / `showIn.edit: false`), the backend rejects such updates by default.
+> To allow this, set the target column config to `allowModifyWhenNotShowInCreate: true` and/or `allowModifyWhenNotShowInEdit: true`.
+
 This lets you reuse the same Upload plugin instance (and its preview logic) while controlling the UX from a different field.
 
 Example Vue custom editor that uploads an avatar and writes the result into another field handled by Upload plugin:

adminforth/modules/restApi.ts

@@ -1233,8 +1233,18 @@ export default class AdminForthRestAPI implements IAdminForthRestAPI {
                 const shown = await isShown(column, 'create', ctxCreate); //
                 const bo = await isBackendOnly(column, ctxCreate);
                 const filledOnCreate = await isFilledOnCreate(column);
-                if ((!shown && !filledOnCreate) || bo) {
-                  return { error: `Field "${fieldName}" cannot be modified as it is restricted from creation (backendOnly or showIn.create is false, please set it to true)`, ok: false };
+                if (bo) {
+                  return {
+                    error: `Field "${fieldName}" cannot be modified as it is restricted from creation (backendOnly is true).`,
+                    ok: false,
+                  };
+                }
+
+                if (!shown && !filledOnCreate && !column.allowModifyWhenNotShowInCreate) {
+                  return {
+                    error: `Field "${fieldName}" cannot be modified as it is restricted from creation (showIn.create is false). If you need to set this hidden field during creation, either configure column.fillOnCreate or set column.allowModifyWhenNotShowInCreate = true.`,
+                    ok: false,
+                  };
                 }
               }
             }
@@ -1354,8 +1364,25 @@ export default class AdminForthRestAPI implements IAdminForthRestAPI {
               if (fieldName in record) {
                 const shown = await isShown(column, 'edit', ctxEdit);
                 const bo = await isBackendOnly(column, ctxEdit);
-                if (!shown || column.editReadonly || bo) {
-                  return { error: `Field "${fieldName}" cannot be modified as it is restricted from editing (backendOnly or showIn.edit is false, please set it to true)`, ok: false };
+                if (bo) {
+                  return {
+                    error: `Field "${fieldName}" cannot be modified as it is restricted from editing (backendOnly is true).`,
+                    ok: false,
+                  };
+                }
+
+                if (column.editReadonly) {
+                  return {
+                    error: `Field "${fieldName}" cannot be modified as it is restricted from editing (editReadonly is true).`,
+                    ok: false,
+                  };
+                }
+
+                if (!shown && !column.allowModifyWhenNotShowInEdit) {
+                  return {
+                    error: `Field "${fieldName}" cannot be modified as it is restricted from editing (showIn.edit is false). If you need to allow updating this hidden field during editing, set column.allowModifyWhenNotShowInEdit = true.`,
+                    ok: false,
+                  };
                 }
               }
             }

adminforth/types/Common.ts

@@ -723,6 +723,26 @@ export interface AdminForthResourceColumnInputCommon {
    */
   editReadonly?: boolean,
 
+  /**
+   * Allows updating this column on Edit requests even when `showIn.edit` resolves to `false`.
+   *
+   * Default is `false`.
+   *
+   * This is useful for custom edit components which update hidden/technical fields via
+   * `update:recordFieldValue`.
+   */
+  allowModifyWhenNotShowInEdit?: boolean,
+
+  /**
+   * Allows setting this column on Create requests even when `showIn.create` resolves to `false`.
+   *
+   * Default is `false`.
+   *
+   * This is useful for custom create components which update hidden/technical fields via
+   * `update:recordFieldValue`.
+   */
+  allowModifyWhenNotShowInCreate?: boolean,
+
   /**
    * Defines on which AdminForth pages this field will be shown. By default all.
    * Example: if you want to show field only in create and edit pages, set it to