feat(settings): schema-driven serialization and window state persistence

[Copilot]

Adds schema-driven config serialization and persistent window state management on top of the settings infrastructure introduced in #329.

Architecture

• ini_doc (new): generic INI document with get/set for int/bool/string and section iteration
• setting_field (new): setting_field_def_t schema + DEFINE_SETTING_{INT,BOOL}_FIELD macros; out-of-range or missing values fall back to defaults and are rewritten to file on flush
• lcui_settings.c: refactored as a base module exposing ini_doc_t* access and two callback lists (deserialize on load, serialize on flush), without reverse dependencies on concrete modules
• lcui_rendering.c / lcui_window_state.c: own their state and register callbacks during module init

Public API

Settings lifecycle (include/LCUI/settings/base.h)

• bool lcui_settings_is_loaded(void);
• bool lcui_settings_load(void);
• bool lcui_settings_flush(void);
• void lcui_settings_unload(void);

Rendering (include/LCUI/settings/rendering.h)

• bool lcui_get_rendering(lcui_rendering_settings_t *out);
• bool lcui_set_rendering(const lcui_rendering_settings_t *in);

Fields: fps_cap, parallel_threads, paint_flashing. Out-of-range values are rejected.

Window state (include/LCUI/settings/window_state.h)

• bool lcui_get_window_state(const char *id, lcui_window_state_t *out);
• bool lcui_set_window_state(const char *id, const lcui_window_state_t *in);
• bool lcui_bind_window_state(ui_widget_t *widget, const char *id);

Fields: x, y, width, height, maximized, stored under [window.<id>] sections. Invalid or out-of-bounds sections are dropped from file on flush.

App identification (include/LCUI/app.h)

• bool lcui_set_app_id(const char *app_id); � reverse-domain format recommended, e.g. "com.example.myapp". Allowed characters: alphanumeric, ., _, -.

PTK changes

• New PTK_EVENT_CREATE event dispatched after native window creation, enabling deferred state restore for display-mode switches that rebuild the window
• Added ptk_window_get_position / ptk_window_set_maximized / ptk_window_is_maximized for geometry and maximized-state access
• X11 backend queries and sets maximized state via _NET_WM_STATE with _NET_WM_STATE_MAXIMIZED_HORZ and _NET_WM_STATE_MAXIMIZED_VERT
• Win32 backend tracks window position in the driver struct

Test coverage (new test_settings suite)

• Rendering settings round-trip, validation, and flush normalization
• Window state round-trip, missing-section handling, invalid-section removal, id validation
• Binding flow: deferred resize before window creation, restore on create, save on close
• Integration tests verify settings persist across load/unload cycles

Examples

// Rendering
lcui_rendering_settings_t r = {
    .fps_cap = 144,
    .parallel_threads = 8,
    .paint_flashing = true
};
lcui_set_rendering(&r);

// Window state: bind a widget to a persistent id
lcui_bind_window_state(widget, "main");

The widget is resized to the saved dimensions immediately (before native window creation), and the new window has geometry/maximized applied once the PTK_EVENT_CREATE fires. On PTK_EVENT_CLOSE, the current state is saved back to [window.main].

// Manual get/set
lcui_window_state_t state = {
    .x = 120, .y = 80,
    .width = 960, .height = 640,
    .maximized = false
};
lcui_set_window_state("main", &state);
lcui_window_state_t out;
lcui_get_window_state("main", &out);

// App identity
lcui_set_app_id("com.example.myapp");
lcui_settings_load();  // reads $XDG_CONFIG_HOME/com.example.myapp/settings.ini

[lc-soft]

@copilot 按照审核意见做修改。

[Copilot]

@copilot 按照审核意见做修改。

已按审核意见完成调整，最新提交：3cceafa。

[lc-soft]

@copilot 修改。

[Copilot]

@copilot 修改。

已修改，提交：3371dc6、3c47c0e。

[lc-soft]

@copilot

[Copilot]

@copilot

已修改，提交：9db7483。

[lc-soft]

@copilot

[Copilot]

@copilot

已修改，提交：95512dc、07f93b2、e80636e。

[lc-soft]

@copilot 按评审意见做修改。改完后总结变更内容，并解释各项变更的理由。

[Copilot]

@copilot 按评审意见做修改。改完后总结变更内容，并解释各项变更的理由。

已按评审意见修改，最新提交：9a7fe1d。

[codecov]

Codecov Report

❌ Patch coverage is 69.93197% with 221 lines in your changes missing coverage. Please review.
✅ Project coverage is 63.70%. Comparing base (7264d24) to head (6b24c29).
⚠️ Report is 2 commits behind head on develop.

Files with missing lines	Patch %	Lines
src/lcui_window_state.c	68.16%	46 Missing and 32 partials ⚠️
src/ini_doc.c	69.44%	43 Missing and 23 partials ⚠️
lib/ptk/src/linux/x11app.c	59.70%	19 Missing and 8 partials ⚠️
src/lcui_settings.c	79.24%	8 Missing and 14 partials ⚠️
lib/ptk/src/linux/fbapp.c	0.00%	15 Missing ⚠️
src/setting_field.c	80.55%	2 Missing and 5 partials ⚠️
src/lcui_rendering.c	83.33%	3 Missing and 3 partials ⚠️

Additional details and impacted files

@@             Coverage Diff             @@
##           develop     #330      +/-   ##
===========================================
+ Coverage    62.99%   63.70%   +0.71%     
===========================================
  Files          195      199       +4     
  Lines        18573    19112     +539     
  Branches      2481     2598     +117     
===========================================
+ Hits         11700    12176     +476     
+ Misses        5950     5946       -4     
- Partials       923      990      +67     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.