Merge remote-tracking branch 'theelims/main' into DaisyUI5andTailwind4upgrade

Author: ewowi

CHANGELOG.md

@@ -2,7 +2,7 @@
 
 All notable changes to this project will be documented in this file.
 
-## Upcoming [Main] - tbd
+## Upcoming [0.6.0] - tbd
 
 > [!CAUTION]
 > This update has breaking changes!
@@ -13,6 +13,7 @@ All notable changes to this project will be documented in this file.
 - Added compatibility with ESP32-C6
 - Added getIP() function to WiFiSettingsService.
 - Added Arduino Log Colors
+- Added linker optimization `-O3`, saving a few kb flash memory.
 - Possibility to add a loop callback to ESP32-Sveltekit to leverage its loop threat. Meant to include custom services so no separate task is needed for them.
 - Change wake-up pin in SleepService during runtime. It is also possible to use the internal pull-up or pull-down resistors now.
 - Get current connection status from ESP32-SvelteKit. Useful for status LED or displays.
@@ -41,9 +42,9 @@ All notable changes to this project will be documented in this file.
 - MQTT library updated
 - Analytics task was refactored into a loop() function which is called by the ESP32-sveltekit main task.
 - Updated PsychicHttp to v1.2.1 incl. patches.
-- Updated DaisyUI
+- Updated to DaisyUI 5 and Tailwind CSS 4
 - Updated Svelte 5 --> see [Svelte 5 Migration Guide](https://svelte.dev/docs/svelte/v5-migration-guide)
-- Changed platform to [PIO Arduino](https://github.com/pioarduino/platform-espressif32)
+- Changed platform to [PIO Arduino](https://github.com/pioarduino/platform-espressif32) using Arduino 3 Core. Also upgrades ESP-IDF to v5.
 - ESPD_LOGx: replace first argument with TAG and define TAG as 🐼 [#85](https://github.com/theelims/ESP32-sveltekit/pull/85)
 - Replace rtc_get_reset_reason(0) with esp_reset_reason() [#86](https://github.com/theelims/ESP32-sveltekit/pull/86)
 
@@ -63,6 +64,8 @@ All notable changes to this project will be documented in this file.
 
 #### PIO Arduino & ESP-IDF 5
 
+The firmware is based on the community maintained fork [PIO Arduino](https://github.com/pioarduino/platform-espressif32) of Arduino 3 for ESP32. Which is based on ESP-IDF 5. Please make sure all your dependencies and application code is compatible with ESP-IDF 5.
+
 #### Frontend
 
 SvelteKit was updated to v2 and Svelte to v5. Please check the migration guides for [SvelteKit 2](https://svelte.dev/docs/kit/migrating-to-sveltekit-2) and the [Svelte 5 Migration Guide](https://svelte.dev/docs/svelte/v5-migration-guide) for the changes required on your frontend code.
@@ -74,6 +77,16 @@ npm install --force
 npx sv migrate svelte-5
 ```
 
+Also DaisyUI and Tailwind CSS have been updated to their last major versions. Run the official Tailwind upgrade tool:
+
+```
+npx @tailwindcss/upgrade
+```
+
+This will migrate some of your svelte files to the new naming convention of Tailwind. For DaisyUI follow this [guide](https://daisyui.com/docs/upgrade/#changes-from-v4). Likely you'll need to redo all forms, as the components behave differently. Forms will need the `fieldset` class. Inputs will need an additional `w-full` to have the same behavior as before. And [labels](https://daisyui.com/components/label/) have a different syntax, too.
+
+The themes are to be found in `app.css` now. Add them back if they had been changed from the default.
+
 ## [0.5.0] - 2024-05-06
 
 Changes the Event Socket System to use a clearer message structure and MessagePack. Brings breaking changes to the `EventSocket.h` API.

docs/restfulapi.md

@@ -30,3 +30,4 @@ The back end exposes a number of API endpoints which are referenced in the table
 | GET    | /rest/generateToken?username={username} | `IS_ADMIN`         | `{"token": "734cb5bb-5597b722"}`                                                                                                                                                                                                   | Generates a new JWT token for the user from username                                    |
 | POST   | /rest/sleep                             | `IS_AUTHENTICATED` | none                                                                                                                                                                                                                               | Puts the device in deep sleep mode                                                      |
 | POST   | /rest/downloadUpdate                    | `IS_ADMIN`         | `{"download_url": "https://github.com/theelims/ESP32-sveltekit/releases/download/v0.1.0/firmware_esp32s3.bin"}`                                                                                                                    | Download link for OTA. This requires a valid SSL certificate and will follow redirects. |
+| GET    | /rest/coreDump                          | `IS_AUTHENTICATED` | Text                                                                                                                                                                                                                               | Core dump of the last crash.                                                            |

docs/sveltekit.md

@@ -63,13 +63,12 @@ Also the Svelte Logo can be replaced with your own. It is located under [interfa
 
 ### Daisy UI Themes
 
-The overall theme of the front end is defined by [DaisyUI](https://daisyui.com/docs/themes/) and can be easily changed according to their documentation. Either by selecting one of the standard themes of DaisyUI, or creating your own. By default the `corporate` and `business` for dark are defined in [tailwind.config.cjs](https://github.com/theelims/ESP32-sveltekit/blob/main/interface/tailwind.config.cjs):
+The overall theme of the front end is defined by [DaisyUI](https://daisyui.com/docs/themes/) and can be easily changed according to their documentation. Either by selecting one of the standard themes of DaisyUI, or creating your own. By default the `corporate` and `business` for dark are defined in [app.css](https://github.com/theelims/ESP32-sveltekit/blob/main/interface/src/app.css):
 
 ```js
-	daisyui: {
-		themes: ['corporate', 'business'],
-		darkTheme: 'business'
-	}
+@plugin "daisyui" {
+    themes: corporate --default, business --prefersdark;
+}
 ```
 
 #### Opinionated use of Shadows
@@ -78,13 +77,13 @@ The front end makes some use of colored shadows with the `shadow-primary` and `s
 
 #### Color Scheme Helper
 
-Some JS modules do not accept DaisyUI/TailwindCSS color class names. A small helper function can be imported and used to convert any CSS variable name for a DaisyUI color into HSLA. That way modules like e.g. Charts.js can be styled in the current color scheme in a responsive manner.
+Some JS modules do not accept DaisyUI/TailwindCSS color class names. A small helper function can be imported and used to convert any CSS variable name for a DaisyUI color into OKCHL. That way modules like e.g. Charts.js can be styled in the current color scheme in a responsive manner.
 
 ```js
 import { daisyColor } from "$lib/DaisyUiHelper";
 
-borderColor: daisyColor('--p'),
-backgroundColor: daisyColor('--p', 50),
+borderColor: daisyColor('--color-primary'),
+backgroundColor: daisyColor('--color-primary', 50),
 ```
 
 ## TS Types Definition