Commit Graph
289 Commits
Author SHA1 Message Date
Erwan Leboucher 3808c39083 fix: drop cef resize workaround (#1599)
<!-- Please read
https://github.com/SableClient/Sable/blob/dev/CONTRIBUTING.md before
submitting your pull request -->

### Description

<!-- Please include a summary of the change. Please also include
relevant motivation and context. List any dependencies that are required
for this change. -->

Fixes #

Fix CEF hanging on resize

#### Type of change

- [x] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] This change requires a documentation update

### Checklist:

- [ ] My code follows the style guidelines of this project
- [ ] I have performed a self-review of my own code
- [ ] I have commented my code, particularly in hard-to-understand areas
- [ ] I have made corresponding changes to the documentation
- [ ] My changes generate no new warnings

### AI disclosure:

- [ ] Partially AI assisted (clarify which code was AI assisted and
briefly explain what it does).
- [ ] Fully AI generated (explain what all the generated code does in
moderate detail).
<!-- Write any explanation required here, but do not generate the
explanation using AI!! You must prove you understand what the code in
this PR does. -->
2026-08-03 18:10:41 +00:00
lunar-seal 19d101df5e fix: drop cef resize workaround 2026-08-03 19:20:28 +02:00
Erwan Leboucher fc0bad50e2 fix(media): restore cached range responses 2026-08-01 14:45:25 +02:00
7w1 bdb4a9d48c fix(cef): don't default deny location permission on cef (#1546)
<!-- Please read
https://github.com/SableClient/Sable/blob/dev/CONTRIBUTING.md before
submitting your pull request -->

### Description

<!-- Please include a summary of the change. Please also include
relevant motivation and context. List any dependencies that are required
for this change. -->

Location permissions were default denied.
Make sable prompt for location permissions on CEF.

Fixes #

#### Type of change

- [x] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] This change requires a documentation update

### Checklist:

- [x] My code follows the style guidelines of this project
- [x] I have performed a self-review of my own code
- [ ] I have commented my code, particularly in hard-to-understand areas
- [ ] I have made corresponding changes to the documentation
- [x] My changes generate no new warnings

### AI disclosure:

- [ ] Partially AI assisted (clarify which code was AI assisted and
briefly explain what it does).
- [ ] Fully AI generated (explain what all the generated code does in
moderate detail).
<!-- Write any explanation required here, but do not generate the
explanation using AI!! You must prove you understand what the code in
this PR does. -->
2026-07-31 20:02:55 +00:00
lunar-seal f5cc97d014 fix: ask user for location permission on cef 2026-07-31 19:02:25 +02:00
Erwan Leboucher 377cbf4ce7 fix: keep calls alive in background on iOS and Android 2026-07-31 13:30:42 +02:00
7w1 47c4f9a6be fix: retry tauri media after token refresh (#1498)
<!-- Please read
https://github.com/SableClient/Sable/blob/dev/CONTRIBUTING.md before
submitting your pull request -->

### Description

- Prevents refreshed OIDC tokens from being overwritten in Tauri.
- Makes image and video Retry issue a fresh native media request.
- Avoids caching native media errors.

Fixes #

#### Type of change

- [x] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] This change requires a documentation update

### Checklist:

- [x] My code follows the style guidelines of this project
- [x] I have performed a self-review of my own code
- [x] I have commented my code, particularly in hard-to-understand areas
- [ ] I have made corresponding changes to the documentation
- [ ] My changes generate no new warnings

### AI disclosure:

- [ ] Partially AI assisted (clarify which code was AI assisted and
briefly explain what it does).
- [ ] Fully AI generated (explain what all the generated code does in
moderate detail).
<!-- Write any explanation required here, but do not generate the
explanation using AI!! You must prove you understand what the code in
this PR does. -->
2026-07-31 04:30:36 +00:00
7w1 04b55102a1 fix(mobile): recover sync after resume (#1497)
<!-- Please read
https://github.com/SableClient/Sable/blob/dev/CONTRIBUTING.md before
submitting your pull request -->

### Description

Recover Matrix sync promptly after app resume with a verified retry
nudge, and use Tauri’s built-in resume event.

#### Type of change

- [x] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] This change requires a documentation update

### Checklist:

- [x] My code follows the style guidelines of this project
- [x] I have performed a self-review of my own code
- [x] I have commented my code, particularly in hard-to-understand areas
- [ ] I have made corresponding changes to the documentation
- [ ] My changes generate no new warnings

### AI disclosure:

- [ ] Partially AI assisted (clarify which code was AI assisted and
briefly explain what it does).
- [ ] Fully AI generated (explain what all the generated code does in
moderate detail).
<!-- Write any explanation required here, but do not generate the
explanation using AI!! You must prove you understand what the code in
this PR does. -->
2026-07-30 20:11:30 +00:00
Erwan Leboucher e10ee62bb1 fix: satisfy media retry checks 2026-07-30 10:11:32 +02:00
Erwan Leboucher 9195f0fe2a fix: retry tauri media after token refresh 2026-07-30 10:02:12 +02:00
Erwan Leboucher 1b89b92915 fix(mobile): recover sync after resume 2026-07-30 09:57:53 +02:00
Erwan Leboucher 09b1430dcb feat(diagnostics): add capture workflow 2026-07-30 08:34:15 +02:00
Erwan Leboucher d9eb43e4fa feat(mobile): export diagnostics 2026-07-29 22:06:25 -05:00
7w1 a21daf4242 fix(mobile): keep calls active in background (#1474)
<!-- Please read
https://github.com/SableClient/Sable/blob/dev/CONTRIBUTING.md before
submitting your pull request -->

### Description

<!-- Please include a summary of the change. Please also include
relevant motivation and context. List any dependencies that are required
for this change. -->

tested on ios and android, not native fully but works at least

#### Type of change

- [x] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] This change requires a documentation update

### Checklist:

- [x] My code follows the style guidelines of this project
- [x] I have performed a self-review of my own code
- [x] I have commented my code, particularly in hard-to-understand areas
- [ ] I have made corresponding changes to the documentation
- [ ] My changes generate no new warnings

### AI disclosure:

- [ ] Partially AI assisted (clarify which code was AI assisted and
briefly explain what it does).
- [ ] Fully AI generated (explain what all the generated code does in
moderate detail).
<!-- Write any explanation required here, but do not generate the
explanation using AI!! You must prove you understand what the code in
this PR does. -->
2026-07-30 02:26:20 +00:00
7w1 9597f1f98b fix: preserve notification and audio routing 2026-07-29 21:24:37 -05:00
7w1 e198c04794 fix(mobile): save downloaded media (#1475)
<!-- Please read
https://github.com/SableClient/Sable/blob/dev/CONTRIBUTING.md before
submitting your pull request -->

### Description

tested on android sadly not on ios

Fixes #

#### Type of change

- [x] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] This change requires a documentation update

### Checklist:

- [x] My code follows the style guidelines of this project
- [x] I have performed a self-review of my own code
- [x] I have commented my code, particularly in hard-to-understand areas
- [ ] I have made corresponding changes to the documentation
- [x] My changes generate no new warnings

### AI disclosure:

- [ ] Partially AI assisted (clarify which code was AI assisted and
briefly explain what it does).
- [ ] Fully AI generated (explain what all the generated code does in
moderate detail).
<!-- Write any explanation required here, but do not generate the
explanation using AI!! You must prove you understand what the code in
this PR does. -->
2026-07-30 02:07:17 +00:00
7w1 ba5a5a607c fix: harden mobile push delivery (#1488)
<!-- Please read
https://github.com/SableClient/Sable/blob/dev/CONTRIBUTING.md before
submitting your pull request -->

### Description

improve reliability of notifications

#### Type of change

- [ ] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] This change requires a documentation update

### Checklist:

- [ ] My code follows the style guidelines of this project
- [ ] I have performed a self-review of my own code
- [ ] I have commented my code, particularly in hard-to-understand areas
- [ ] I have made corresponding changes to the documentation
- [ ] My changes generate no new warnings

### AI disclosure:

- [ ] Partially AI assisted (clarify which code was AI assisted and
briefly explain what it does).
- [ ] Fully AI generated (explain what all the generated code does in
moderate detail).
<!-- Write any explanation required here, but do not generate the
explanation using AI!! You must prove you understand what the code in
this PR does. -->
2026-07-29 21:28:34 +00:00
7w1 40f0e5cb21 fix(cef): add GPU diagnostic override (#1490)
<!-- Please read
https://github.com/SableClient/Sable/blob/dev/CONTRIBUTING.md before
submitting your pull request -->

### Description

<!-- Please include a summary of the change. Please also include
relevant motivation and context. List any dependencies that are required
for this change. -->
test for https://github.com/SableClient/Sable/issues/1442

#### Type of change

- [ ] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] This change requires a documentation update

### Checklist:

- [ ] My code follows the style guidelines of this project
- [ ] I have performed a self-review of my own code
- [ ] I have commented my code, particularly in hard-to-understand areas
- [ ] I have made corresponding changes to the documentation
- [ ] My changes generate no new warnings

### AI disclosure:

- [ ] Partially AI assisted (clarify which code was AI assisted and
briefly explain what it does).
- [ ] Fully AI generated (explain what all the generated code does in
moderate detail).
<!-- Write any explanation required here, but do not generate the
explanation using AI!! You must prove you understand what the code in
this PR does. -->
2026-07-29 21:16:25 +00:00
Erwan Leboucher 4f98e182e3 fix(cef): add GPU diagnostic override 2026-07-29 20:44:16 +02:00
Erwan Leboucher 6acfb4ad52 fix: harden mobile push delivery 2026-07-29 20:01:24 +02:00
Erwan Leboucher 08b80e20af Merge branch 'dev' into fix/mobile-media-downloads 2026-07-29 19:27:24 +02:00
Erwan Leboucher a8a634634f fix(mobile): improve image saves and touch handling 2026-07-29 18:22:54 +02:00
Erwan Leboucher 922e62df65 fix(mobile): keep calls active in background 2026-07-29 16:02:22 +02:00
Andrew Attali eab77a9dcd fix(macos): make native and custom titlebar consistent 2026-07-29 12:11:54 +02:00
Erwan Leboucher 025839605f fix(mobile): save downloaded media 2026-07-29 11:14:25 +02:00
7w1 1db23fe224 fix math formatting (#1469)
<!-- Please read
https://github.com/SableClient/Sable/blob/dev/CONTRIBUTING.md before
submitting your pull request -->

### Description

<!-- Please include a summary of the change. Please also include
relevant motivation and context. List any dependencies that are required
for this change. -->

Allows tauri: css files, which fixes the math and maybe other stuff.

#### Type of change

- [ ] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] This change requires a documentation update

### Checklist:

- [ ] My code follows the style guidelines of this project
- [ ] I have performed a self-review of my own code
- [ ] I have commented my code, particularly in hard-to-understand areas
- [ ] I have made corresponding changes to the documentation
- [ ] My changes generate no new warnings

### AI disclosure:

- [ ] Partially AI assisted (clarify which code was AI assisted and
briefly explain what it does).
- [ ] Fully AI generated (explain what all the generated code does in
moderate detail).
<!-- Write any explanation required here, but do not generate the
explanation using AI!! You must prove you understand what the code in
this PR does. -->
2026-07-28 17:40:23 -05:00
7w1 e270798692 fix math formatting 2026-07-28 17:14:21 -05:00
7w1 7c2d2ffbed fix: recover media auth after token refresh (#1450)
<!-- Please read
https://github.com/SableClient/Sable/blob/dev/CONTRIBUTING.md before
submitting your pull request -->

### Description

<!-- Please include a summary of the change. Please also include
relevant motivation and context. List any dependencies that are required
for this change. -->

Fixes #

#### Type of change

- [x] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] This change requires a documentation update

### Checklist:

- [x] My code follows the style guidelines of this project
- [ ] I have performed a self-review of my own code
- [ ] I have commented my code, particularly in hard-to-understand areas
- [ ] I have made corresponding changes to the documentation
- [ ] My changes generate no new warnings

### AI disclosure:

- [ ] Partially AI assisted (clarify which code was AI assisted and
briefly explain what it does).
- [ ] Fully AI generated (explain what all the generated code does in
moderate detail).
<!-- Write any explanation required here, but do not generate the
explanation using AI!! You must prove you understand what the code in
this PR does. -->
2026-07-28 19:20:20 +00:00
hazre de32aafe96 fix: remove Nightly suffix from SABLE_PRODUCT_NAME
Signed-off-by: hazre <[email protected]>
2026-07-28 17:54:26 +02:00
Erwan Leboucher 8f04652088 fix(mobile): save downloaded media 2026-07-28 17:11:53 +02:00
Erwan Leboucher cc2d8b1bfb fix: recover media auth after token refresh 2026-07-28 14:16:41 +02:00
7w1 92c7822f69 feat(diagnostics): add sanitized log export (#1421)
<!-- Please read
https://github.com/SableClient/Sable/blob/dev/CONTRIBUTING.md before
submitting your pull request -->

### Description

<!-- Please include a summary of the change. Please also include
relevant motivation and context. List any dependencies that are required
for this change. -->

Fixes #

#### Type of change

- [ ] Bug fix (non-breaking change which fixes an issue)
- [x] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] This change requires a documentation update

### Checklist:

- [x] My code follows the style guidelines of this project
- [x] I have performed a self-review of my own code
- [x] I have commented my code, particularly in hard-to-understand areas
- [ ] I have made corresponding changes to the documentation
- [x] My changes generate no new warnings

### AI disclosure:

- [ ] Partially AI assisted (clarify which code was AI assisted and
briefly explain what it does).
- [ ] Fully AI generated (explain what all the generated code does in
moderate detail).
<!-- Write any explanation required here, but do not generate the
explanation using AI!! You must prove you understand what the code in
this PR does. -->
2026-07-28 03:30:12 +00:00
7w1 1677c28826 fix(android/ios): keep calls active in background (#1420)
<!-- Please read
https://github.com/SableClient/Sable/blob/dev/CONTRIBUTING.md before
submitting your pull request -->

### Description

<!-- Please include a summary of the change. Please also include
relevant motivation and context. List any dependencies that are required
for this change. -->

Fixes #

#### Type of change

- [x] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] This change requires a documentation update

### Checklist:

- [x] My code follows the style guidelines of this project
- [x] I have performed a self-review of my own code
- [x] I have commented my code, particularly in hard-to-understand areas
- [x] I have made corresponding changes to the documentation
- [ ] My changes generate no new warnings

### AI disclosure:

- [ ] Partially AI assisted (clarify which code was AI assisted and
briefly explain what it does).
- [ ] Fully AI generated (explain what all the generated code does in
moderate detail).
<!-- Write any explanation required here, but do not generate the
explanation using AI!! You must prove you understand what the code in
this PR does. -->
2026-07-28 02:54:01 +00:00
Erwan Leboucher 5699dba70d feat(diagnostics): add sanitized log export 2026-07-27 23:34:03 +02:00
7w1 8c85dca2e9 feat(cef): cef 150, native permission prompt (#1412)
<!-- Please read
https://github.com/SableClient/Sable/blob/dev/CONTRIBUTING.md before
submitting your pull request -->

### Description

<!-- Please include a summary of the change. Please also include
relevant motivation and context. List any dependencies that are required
for this change. -->

1. **CEF 148 -> 150.2.1** - switches from
byeongsu-hong/tauri-runtime-cef to SableClient/tauri-runtime-cef fork

3. **Native permission prompt** - replaces auto-allow with a GTK dialog
for mic/camera/screen-share access.

#### Type of change

- [x] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] This change requires a documentation update

### Checklist:

- [x] My code follows the style guidelines of this project
- [ ] I have performed a self-review of my own code
- [ ] I have commented my code, particularly in hard-to-understand areas
- [ ] I have made corresponding changes to the documentation
- [ ] My changes generate no new warnings

### AI disclosure:

- [ ] Partially AI assisted (clarify which code was AI assisted and
briefly explain what it does).
- [ ] Fully AI generated (explain what all the generated code does in
moderate detail).
<!-- Write any explanation required here, but do not generate the
explanation using AI!! You must prove you understand what the code in
this PR does. -->
2026-07-27 20:19:00 +00:00
7w1 d11d5618f3 fix(sync): recover faster from network switches and flaky connections (#1399)
<!-- Please read
https://github.com/SableClient/Sable/blob/dev/CONTRIBUTING.md before
submitting your pull request -->

### Description

<!-- Please include a summary of the change. Please also include
relevant motivation and context. List any dependencies that are required
for this change. -->

Fixes #

#### Type of change

- [x] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] This change requires a documentation update

### Checklist:

- [x] My code follows the style guidelines of this project
- [ ] I have performed a self-review of my own code
- [ ] I have commented my code, particularly in hard-to-understand areas
- [ ] I have made corresponding changes to the documentation
- [ ] My changes generate no new warnings

### AI disclosure:

- [ ] Partially AI assisted (clarify which code was AI assisted and
briefly explain what it does).
- [ ] Fully AI generated (explain what all the generated code does in
moderate detail).
<!-- Write any explanation required here, but do not generate the
explanation using AI!! You must prove you understand what the code in
this PR does. -->
2026-07-27 20:01:26 +00:00
Erwan Leboucher 58206b983f fix(media): serve media in full instead of honoring Range requests 2026-07-27 21:14:58 +02:00
Erwan Leboucher 5118926254 fix(ios): keep calls active in background 2026-07-27 16:47:34 +02:00
Erwan Leboucher 5e447ccb44 fix(android): keep calls active in background 2026-07-27 15:32:39 +02:00
Erwan Leboucher 039bf5e7e1 chore: switch to SableClient/tauri-runtime-cef fork with cef 150 2026-07-27 11:32:43 +02:00
Erwan Leboucher 258273a9aa feat(cef): native GTK permission prompt for media access 2026-07-27 10:31:41 +02:00
Erwan Leboucher 35c984576b perf(cef): enable renderer backgrounding purge and cap Skia cache 2026-07-27 10:31:40 +02:00
Erwan Leboucher c075b06cb6 perf(cef): enable renderer backgrounding purge and cap Skia cache 2026-07-26 23:32:29 +02:00
Erwan Leboucher 7664a94d79 fix(sync): recover faster from network switches and flaky connections 2026-07-26 22:49:45 +02:00
hazre 0e72405875 feat: unify product name and build flavor across builds
Signed-off-by: hazre <[email protected]>
2026-07-26 13:32:41 -05:00
7w1 207252b522 fix(tauri): harden CSP, scope media CORS, block loopback redirects, allow --no-updater builds (#1378)
<!-- Please read
https://github.com/SableClient/Sable/blob/dev/CONTRIBUTING.md before
submitting your pull request -->

### Description

Tighten the webview CSP (unsafe-eval → wasm-unsafe-eval, explicit
worker/font/frame-src, object-src none), scope sable-media's CORS grant
to the app's own origins, stop loopback_fetch following redirects
off-loopback, and let self-builders opt out of the updater with
--no-updater.

Fixes #

#### Type of change

- [x] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] This change requires a documentation update

### Checklist:

- [x] My code follows the style guidelines of this project
- [x] I have performed a self-review of my own code
- [x] I have commented my code, particularly in hard-to-understand areas
- [ ] I have made corresponding changes to the documentation
- [ ] My changes generate no new warnings

### AI disclosure:

- [ ] Partially AI assisted (clarify which code was AI assisted and
briefly explain what it does).
- [ ] Fully AI generated (explain what all the generated code does in
moderate detail).
<!-- Write any explanation required here, but do not generate the
explanation using AI!! You must prove you understand what the code in
this PR does. -->
2026-07-26 09:47:15 -05:00
Erwan Leboucher 20799e3c16 fix(tauri): stop snap overlay leaving Meta held and re-asking for unthumbnailable media 2026-07-26 16:00:13 +02:00
Erwan Leboucher 3d82cda286 fix(tauri): harden CSP, scope media CORS, block loopback redirects, allow --no-updater builds 2026-07-26 15:47:58 +02:00
7w1 0d5bafd72a fix(notifications): stop in-app sounds leaking into the media layer (#1353)
<!-- Please read
https://github.com/SableClient/Sable/blob/dev/CONTRIBUTING.md before
submitting your pull request -->

### Description

fixes sounds going to the media layer on ios or web, so dnd will work

#### Type of change

- [x] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] This change requires a documentation update

### Checklist:

- [x] My code follows the style guidelines of this project
- [x] I have performed a self-review of my own code
- [x] I have commented my code, particularly in hard-to-understand areas
- [x] I have made corresponding changes to the documentation
- [x] My changes generate no new warnings

### AI disclosure:

- [ ] Partially AI assisted (clarify which code was AI assisted and
briefly explain what it does).
- [ ] Fully AI generated (explain what all the generated code does in
moderate detail).
<!-- Write any explanation required here, but do not generate the
explanation using AI!! You must prove you understand what the code in
this PR does. -->
2026-07-25 16:13:39 -05:00
7w1 41ce21f828 chore(tauri): make the devtools plugin opt-in behind a cargo feature (#1333)
### Description

`tauri-plugin-devtools` retains every metadata record for the session
(`devtools-core`'s `Aggregator::all_metadata` is never trimmed, by
design, so late-connecting clients get the full history). With
`tauri-plugin-log` feeding it, a heapprofd capture showed 310 MB
retained in 45 seconds; on Android the app reached ~1 GB within a minute
and was OOM-killed repeatedly.

It is now behind a `devtools` cargo feature, off by default. Build with
`--features devtools` to get the inspector back. `tauri-plugin-log`
still initialises either way, so logcat output is unchanged.

Fixes #

#### Type of change

- [x] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] This change requires a documentation update

### Checklist:

- [x] My code follows the style guidelines of this project
- [x] I have performed a self-review of my own code
- [x] I have commented my code, particularly in hard-to-understand areas
- [x] I have made corresponding changes to the documentation
- [x] My changes generate no new warnings

### AI disclosure:

- [ ] Partially AI assisted (clarify which code was AI assisted and
briefly explain what it does).
- [ ] Fully AI generated (explain what all the generated code does in
moderate detail).
<!-- Write any explanation required here, but do not generate the
explanation using AI!! You must prove you understand what the code in
this PR does. -->
2026-07-25 15:51:39 -05:00