Repository navigation
[Website] Add captured mail viewer - #4000
Merged
mho22 merged 13 commits intoAug 13, 2026
Merged
Conversation
bgrgicak
marked this pull request as draft
July 10, 2026 11:31
bgrgicak
force-pushed
the
bgrgicak/playground-email-tab
branch
from
July 16, 2026 06:48
152c660 to
bbd5256
Compare
bgrgicak
commented
Jul 16, 2026
bgrgicak
commented
Jul 16, 2026
bgrgicak
force-pushed
the
bgrgicak/playground-email-tab
branch
from
July 17, 2026 12:51
8e0d1a0 to
f7f91a8
Compare
bgrgicak
force-pushed
the
bgrgicak/playground-email-tab
branch
from
July 17, 2026 13:14
f7f91a8 to
9af482a
Compare
… into bgrgicak/playground-email-tab # Conflicts: # packages/playground/website/src/components/dock/dock.tsx
bgrgicak
force-pushed
the
bgrgicak/playground-email-tab
branch
from
July 24, 2026 20:24
d9c07e9 to
64275d2
Compare
bgrgicak
commented
Jul 24, 2026
Comment on lines
+60
to
+65
| const attachmentsHtml = renderToStaticMarkup( | ||
| <MailAttachments | ||
| attachments={mail.attachments} | ||
| resources={attachmentResources} | ||
| /> | ||
| ); |
Collaborator
Author
There was a problem hiding this comment.
For the UI, I wanted attachments to be placed after the email content so it can grow vertically.
For this we needed the email content and attachment to be displayed with their full height, otherwise we would have two vertical scroll bars, one for the email content and another for attachments.
First I tried dynamically changing the height of the iframe with JavaScript, but that felt wrong, so I ended up moving attachments to the iframe and ensure we have one iframe this way.
bgrgicak
marked this pull request as ready for review
July 24, 2026 20:37
mho22
self-requested a review
August 13, 2026 14:45
mho22
approved these changes
Aug 13, 2026
mho22
added a commit
that referenced
this pull request
Aug 13, 2026
## Summary Forwards captured `sendmail` messages through the Playground client and stores parsed messages in each site's website state for the inbox UI planned in #4000 as part of #3994. ## Rationale Email capture currently stops inside the PHP worker. Website components need structured messages they can consume. This PR adds that plumbing only; it does not add an inbox UI or deliver mail to the internet. ## Implementation details - Forwards `sendmail.spawned` from each PHP instance while avoiding duplicate forwarding listeners on reused instances. - Re-brands the event at the remote API boundary so its `stdin` stream crosses both Comlink hops, then parses messages with `postal-mime`. - Processes messages sequentially and prepends them to `clientInfo.emails`, preserving newest-first event order. Parse failures do not block later messages. - Prevents aborted sites from storing parsed messages and cancels queued streams as they are reached. - Initializes the runtime client state with `emails` and excludes parsed email objects from Redux serializability checks. Capture starts after `startPlaygroundWeb()` completes, so mail sent during initial boot or Blueprint execution is not retained. Messages are held only in memory and are discarded when the client restarts, is removed, or the page reloads. Each source message is limited to 20 MiB, but aggregate retention remains unbounded until the inbox UI adds an eviction policy. ## Testing Instructions - CI --------- Co-authored-by: mho22 <yannick@capsules.codes>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds an Email panel to the Playground Site Manager for viewing messages captured from the active site, including message and attachment previews.
Motivation for the change, related issues
Builds on #4103 and #3996 to make captured
sendmailmessages available in the Site Manager UI. Related issue: #3994.Implementation details
clientInfo.emailsarray and selects the newest message by default.cid:images and attachments to temporary Blob URLs, with image, video, and audio previews and downloads. URLs are revoked when no longer needed.@wordpress/componentsfor the message list, empty state, and metadata. Attachment cards use isolated styles in a declarative shadow root.Testing Instructions
npm run dev.