docs(ui-settings): describe the settings domain base and its shell

`SettingsRoot` and the `sidebar.settings` occupancy moved to ui-settings-general,
but both READMEs still read as if ui-settings were the shell. ui-settings now
documents what it actually is — the `ctx.settingsScope` transport plus the slot
type declarations, with the bind ownership, refresh triggers, write revision
handling, and decode refusal a preference row must know — and records the
loopback-only and single-field write gaps in place of two limitations that no
longer exist. ui-settings-general documents the shell it now renders. The stale
module JSDoc on both halves follows.
This commit is contained in:
imccyu
2026-08-11 15:53:34 +08:00
parent 364f7c7076
commit 32378d27b4
9 changed files with 35 additions and 26 deletions
@@ -2,5 +2,5 @@
# side as of the last confirmed-consistent state. Both languages carry equal authority;
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write packages/client/ui-settings-general/README.md
README.md: 93bb2b04982a0e7bc8a248c1127428aec509773f
README.zh.md: 5cf5da2f92a0b5a1f53f3306665c3c84381a0e85
README.md: 0cdffdfaad20784535a7ed010ad4b71d63a0a2c1
README.zh.md: 0b72b3db96b335f0c288758b3f7a8b56441ee88c