Merge branch 'refactor/flash_refactor' into 'master'

spi_flash: split driver and os driver into `spi_flash` and `esp_mspi` components

Closes IDF-15210

See merge request espressif/esp-idf!45409

examples/custom_bootloader/bootloader_multiboot/bootloader_components/main/bootloader_start.c

@@ -11,7 +11,6 @@
 #include "bootloader_init.h"
 #include "bootloader_utility.h"
 #include "bootloader_common.h"
-#include "bootloader_flash_priv.h"
 #include "esp_app_desc.h"
 
 #define MAX_PARTITIONS  8

examples/storage/custom_flash_driver/bootloader_components/bootloader_flash/bootloader_flash_qio_custom.c

@@ -4,7 +4,6 @@
  * SPDX-License-Identifier: Unlicense OR CC0-1.0
  */
 #include "bootloader_flash_override.h"
-#include "bootloader_flash_priv.h"
 #include "bootloader_flash_custom.h"
 #include "esp_rom_spiflash.h"
 #include "esp_attr.h"

examples/storage/custom_flash_driver/bootloader_components/bootloader_flash/bootloader_flash_unlock_custom.c

@@ -1,9 +1,11 @@
 /*
- * SPDX-FileCopyrightText: 2024 Espressif Systems (Shanghai) CO LTD
+ * SPDX-FileCopyrightText: 2024-2026 Espressif Systems (Shanghai) CO LTD
  *
  * SPDX-License-Identifier: Unlicense OR CC0-1.0
  */
-#include "bootloader_flash_priv.h"
+#include "esp_bit_defs.h"
+#include "bootloader_flash_override.h"
+#include "spi_flash_defs.h"
 #include "esp_rom_spiflash.h"
 #include "esp_rom_sys.h"
 #include "esp_attr.h"
@@ -17,7 +19,7 @@ Overview
 Step-by-Step Implementation
 
 	1.	Include Necessary Headers:
-	•	bootloader_flash_priv.h: For private bootloader functions.
+	•	bootloader_flash_override.h: For `bootloader_execute_flash_command` function.
 	•	esp_rom_spiflash.h: For ROM SPI flash functions.
 	•	esp_rom_sys.h: For basic ROM system functions.
 	•	esp_attr.h and esp_log.h: For attributes and logging.