```

docs(chzzk): update documentation to support iframe chat URL and add event reference

- Add `https://chzzk.naver.com/iframe/live/*/chat` URL to manifest row and related docs
- Set version to 2 and all frames flag in manifest-row-matrix.md
- Document iframe route and viewer count polling in popout-chat-only-sources.md
- Update supported-sites-lookup.md to include both live and iframe patterns
- Add CHZZK platform card in event-reference.html with message, donation, and viewer_update events
- Update sites.js instructions to include iframe URL
```

[auto-enhanced]

Author: steveseguin

docs/agents/08-platform-sources/manifest-row-matrix.md

@@ -44,7 +44,7 @@ For the inverse lookup from public site card to manifest row/source file, use `p
 | 17 | `sources/pumpfun.js` | top-level source | 1 | - | `https://pump.fun/coin/*` | Pump.fun | - |
 | 18 | `sources/onlinechurch.js` | top-level source | 1 | - | `https://*.online.church/*` | Online Church | - |
 | 19 | `sources/beamstream.js` | top-level source | 1 | - | `https://beamstream.gg/*/chat` | Beamstream | - |
-| 20 | `sources/chzzk.js` | top-level source | 1 | - | `https://chzzk.naver.com/live/*/chat` | Chzzk.naver.com | - |
+| 20 | `sources/chzzk.js` | top-level source | 2 | all frames | `https://chzzk.naver.com/live/*/chat`, `https://chzzk.naver.com/iframe/live/*/chat` | Chzzk.naver.com | - |
 | 21 | `sources/parti.js` | top-level source | 1 | - | `https://parti.com/*` | Parti | - |
 | 22 | `sources/wavevideo.js` | top-level source | 1 | - | `https://wave.video/*` | Wave Video | - |
 | 23 | `sources/webinargeek.js` | top-level source | 2 | - | `https://*.webinargeek.com/webinar/*` | WebinarGeek | - |

docs/agents/08-platform-sources/popout-chat-only-sources.md

@@ -42,7 +42,7 @@ That source is a chat-only/popout capture. Open the exact supported chat URL, ke
 | --- | --- | --- | --- | --- |
 | Beamstream | `https://beamstream.gg/*/chat` | Rows with `[property="sender.name"]`, `[property="body"]`, `[property="sender.avatar"]` | Can attach `contentimg` from media rows and `sourceImg` from `[property="service"]`; respects `settings.ignorealternatives` | Capture is tied to the `/chat` URL; source-service icon behavior needs live validation. |
 | BoltPlus | `https://boltplus.tv/chatpopout/*` or `https://boltplus.tv/chatpopout?*` | `.chat-user-name`, `MuiAvatar` image, Draft-style `[data-text="true"]` text | Can attach a Giphy image as `contentimg` | DOM traversal depends on Material UI wrapper structure. |
-| Chzzk | `https://chzzk.naver.com/live/*/chat` | Generated Chzzk live-chat item, name, text, badges | Donation amount parsing; 10-second startup backlog suppression; duplicate cache; anti-throttle helpers | Donation currency/unit parsing includes current page text; live validation is needed for exact payload text. |
+| Chzzk | `https://chzzk.naver.com/live/*/chat`, `https://chzzk.naver.com/iframe/live/*/chat` | Generated Chzzk live-chat item, name, text, badges/emotes | Donation amount parsing; viewer count polling when enabled; 10-second startup backlog suppression; duplicate cache; anti-throttle helpers | The iframe chat route is supported for embedded/current popout flows; donation currency/unit parsing includes current page text. |
 | FloatPlane | `https://*.floatplane.com/popout/livechat` | `.chat-message-list` / `.LiveChatMessage`, `.chat-username`, `.chat-text` | Captures name color and text content | Public setup says keep the main window open; no tip/rich-event path in inspected source. |
 | GoodGame.ru | `https://goodgame.ru/*/chat*`, `https://www.goodgame.ru/*/chat*` | `.chat-section` message blocks, `.user .nick`, `.message` | Text badges from `.icon[tooltip]`; avatar fallback selectors; sends through direct runtime or wrapped background fallback | Skips old rows on connection; public setup requires chat URL. |
 | Mixcloud Live | `https://www.mixcloud.com/live/*/chat/` | Live chat rows with `data-testid="chatline"` or older `.mixcloud-live-chat-row-link` selectors | Extracts username from profile link; subscription rows can populate `hasDonation`; dedupes repeated JSON payloads | Selector paths support multiple layouts and need live validation. |
@@ -76,7 +76,7 @@ That source is a chat-only/popout capture. Open the exact supported chat URL, ke
 ## Do Not Promise
 
 - Send-back support for this group without current source-control validation.
-- Viewer counts except where explicitly documented for Parti and VK Video, and still only when the relevant settings and page data are available.
+- Viewer counts except where explicitly documented for Chzzk, Parti, and VK Video, and still only when the relevant settings and page data are available.
 - Donation/tip support except where the inspected source parses it: Chzzk, Parti, RokFin, Mixcloud subscription rows, and similar source-specific paths.
 - Normal watch/profile page capture when the public setup requires popout or chat-only URLs.
 - Current support for `vkplay.js` as a manifest-loaded parser; current chat-only manifest rows use `vkvideo.js`.

docs/agents/08-platform-sources/supported-sites-lookup.md

@@ -81,7 +81,7 @@ It is listed as a [setup type] source. Start by [setup instruction]. If that doe
 | Piczel.tv | Use `https://piczel.tv/chat/*`. |
 | Nimo.TV | Use `https://www.nimo.tv/popout/chat/xxxx`. |
 | FloatPlane | Use `https://*.floatplane.com/popout/livechat`; keep the main window open. |
-| Chzzk.naver.com | Use `https://chzzk.naver.com/live/*/chat`. |
+| Chzzk.naver.com | Use `https://chzzk.naver.com/live/*/chat` or `https://chzzk.naver.com/iframe/live/*/chat`. |
 | Fansly | Use `https://fansly.com/chatroom/*`. |
 | Favorited | Use `https://studio.favorited.com/popout/chat`. |
 | Rutube | Use `https://rutube.ru/live/chat/*/`. |

docs/event-reference.html

@@ -200,6 +200,13 @@ <h2>Quick Feature Availability</h2>
                             <td>&mdash;</td>
                             <td>Viewer count plus chat names, colors, badges, replies, and links</td>
                         </tr>
+                        <tr>
+                            <td><strong>CHZZK</strong></td>
+                            <td>&mdash;</td>
+                            <td>&mdash;</td>
+                            <td>Visible cheese donation rows</td>
+                            <td>Chat rows, badge images, emotes, and viewer count polls</td>
+                        </tr>
                         <tr>
                             <td><strong>FLEX TV</strong></td>
                             <td>&mdash;</td>
@@ -1565,6 +1572,41 @@ <h3>Parti - Profile / Popout Chat Capture</h3>
                     </table>
                 </article>
 
+                <article class="platform-card" id="chzzk">
+                    <h3>CHZZK - Popout Chat Capture</h3>
+                    <p class="source-note">Implementation: <code>sources/chzzk.js</code></p>
+                    <ul class="requirements">
+                        <li>Supports <code>https://chzzk.naver.com/live/*/chat</code> and <code>https://chzzk.naver.com/iframe/live/*/chat</code>.</li>
+                        <li>Viewer counts use CHZZK's live-status polling endpoint when viewer-count capture or hype mode is enabled.</li>
+                    </ul>
+                    <table class="event-table">
+                        <thead>
+                            <tr>
+                                <th>Event</th>
+                                <th>When it Fires</th>
+                                <th>Payload Notes</th>
+                            </tr>
+                        </thead>
+                        <tbody>
+                            <tr>
+                                <td><code>message</code></td>
+                                <td>Visible CHZZK chat rows appear in the popout chat stream.</td>
+                                <td>Standard chat payload with <code>type: "chzzk"</code>, <code>nameColor</code>, badge image URLs in <code>chatbadges</code>, and rendered emotes in <code>chatmessage</code> unless text-only mode is enabled.</td>
+                            </tr>
+                            <tr>
+                                <td class="donation-event"><code>donation</code></td>
+                                <td>Visible CHZZK cheese donation rows appear in chat.</td>
+                                <td><code>hasDonation</code> carries the displayed cheese amount. These rows do not set <code>data.event</code>.</td>
+                            </tr>
+                            <tr>
+                                <td class="status-event"><code>viewer_update</code></td>
+                                <td>The live-status poll returns a viewer count.</td>
+                                <td><code>meta</code> is the integer viewer count.</td>
+                            </tr>
+                        </tbody>
+                    </table>
+                </article>
+
                 <article class="platform-card" id="rumble-dom">
                     <h3>Rumble - Standard DOM Capture</h3>
                     <p class="source-note">Implementation: <code>sources/rumble.js</code></p>

docs/js/sites.js

@@ -683,7 +683,7 @@ document.addEventListener('DOMContentLoaded', function() {
             instructions: `
                 <ul>
                     <li>Pop out the chat</li>
-                    <li>URL: https://chzzk.naver.com/live/*/chat</li>
+                    <li>URL: https://chzzk.naver.com/live/*/chat or https://chzzk.naver.com/iframe/live/*/chat</li>
                 </ul>
             `
         },