fix(ui): remove openPropsTokenSheet from theme toggle adoptedStyles + finalize plan

Theme toggle: remove openPropsTokenSheet from static styles to work around
Safari's adoptedStyleSheets bug. Token CSS is already injected as page-level
<style> by vite.config.ts — custom properties cascade through shadow DOM
naturally. The component retains only its own component-specific sheet.

Plan update: add architecture review (4 rendering paths, VNode vs VDOM),
redundancy report (double signal binding, signal→DOM duplication, adoptedSheet
duplication), problems-encountered table, and long-term Safari theme solutions.

Verification:
- deno task test: 894 passed, 0 failed
- e2e chromium: 7/7 theme, 25/25 all
- e2e webkit: 6/7 theme (surface colors test — known Safari bug)
- autoflow:push: 5/5 PASS

Author: DevBot

docs/release/v0.41.0-alpha1-plan.md

@@ -215,3 +215,76 @@ After the initial cleanup, 6 CI gates failed on the remote build:
       inside the panel div. `www/app/islands/open-search.tsx`.
 - [x] E2E verified across Chromium (25/25), Firefox (23/25), WebKit (23/28,
       2 CSS color assertion failures, 1 SPA locale switch timeout — all cosmetic).
+
+### v0.41.0-alpha1 - Framework Architecture Review
+
+Comprehensive review of the rendering pipeline and signal-to-DOM binding:
+
+**Rendering paths — 4 exist, all necessary:**
+
+| Path                   | Mechanism                                                                  | Purpose                                     |
+| ---------------------- | -------------------------------------------------------------------------- | ------------------------------------------- |
+| A. Fine-grained effect | `effect(() => el.setAttribute())`                                          | Signal prop → DOM attr update, no re-render |
+| B. Signal → TextNode   | `effect(() => textNode.textContent = sig.value)`                           | JSX signal children expression              |
+| C. Full re-render      | `render()` → `while(root.firstChild) root.removeChild()` → `renderToDom()` | Initial mount + `this.update()`             |
+| D. DSD hydration       | `querySelectorAll('[data-signal]')` → `effect()`                           | SSR → client signal binding                 |
+
+**Framework confirms user understanding:** VNode is an intermediate representation
+(5 frozen fields: `tag`, `props`, `children`, `key`, `ref`), NOT a virtual DOM.
+No diff algorithm, no reconciliation, no keyed child matching. Signal changes drive
+DOM updates directly via `effect()` callbacks — no VNode involvement.
+
+**Identified redundancies:**
+
+- **Double signal binding** — `class={this.#signal}` + `data-signal-attr` on the same
+  element cause two subscription paths that collide: signal change triggers full
+  `render()` which replaces the DOM element, while `data-signal-attr` tries to update
+  the attribute in-place. Result: `onClick` handler lost on re-render.
+  Fix in `open-search.tsx`: use static `class='overlay'` + only `data-signal-attr`.
+- **Signal→DOM binding logic duplicated** — Path A (`applyProps` + `effect` in
+  `jsx-render-dom.ts`) and Path D (`hydrateSignals` in `open-element-hydration.ts`)
+  both bind signals to DOM but from different starting points (VNode vs SSR markers).
+  Could be unified by making Path D call `renderToDom` instead of manual `effect()`.
+- **`adoptedStyleSheets` for global tokens** — `openPropsTokenSheet` and
+  `daisyClassSheet` are adopted into every component's shadow root, but the same
+  CSS is already injected as page-level `<style>` by `vite.config.ts`. The
+  duplicate adoption causes Safari's adoptedStyleSheets bug (`:host([data-theme])`
+  does not recompute when `data-theme` attribute changes).
+
+### v0.41.0-alpha1 - Progress on AdoptedStyleSheets Safari Bug
+
+Safari/WebKit bug: `adoptedStyleSheets` containing `:host([data-theme])` selectors
+do not recompute when the host element's `data-theme` attribute changes via JS.
+This affects themed colors (`--bg-canvas`, `--surface-*` etc.) inside shadow DOM.
+
+Attempted workarounds (all failed for the surface colors test):
+
+- JS style.setProperty() on documentElement — Safari still uses stale adoptedSheet values
+- Forcing style recalculation via offsetHeight read — no effect
+- Re-assigning `adoptedStyleSheets = [...sheets]` — does not trigger recompute
+
+**Current fix applied:**
+
+- [x] `open-theme-toggle`: removed `openPropsTokenSheet` from `static styles`.
+      The token CSS custom properties are already injected as page-level `<style>`
+      by `vite.config.ts` and cascade through shadow DOM naturally. The component
+      only adopts its own component-specific sheet.
+
+**Long-term solutions (tracked for future):**
+
+| Solution                                                            | Effort               | Effect                                                                            |
+| ------------------------------------------------------------------- | -------------------- | --------------------------------------------------------------------------------- |
+| Remove token sheets from all component `static styles`              | Medium               | All components inherit theme tokens from page-level CSS, bypassing the Safari bug |
+| Switch affected components to `renderMode = 'light'`                | Small per component  | No adoptedStyleSheets at all, but loses style encapsulation                       |
+| Use CSS `light-dark()` function instead of `[data-theme]` selectors | Large (CSS refactor) | Modern standard, works in all browsers, eliminates the selector dependency        |
+| Unify signal binding Paths A and D (make D call `renderToDom`)      | Medium               | Reduces code duplication, simplifies maintenance                                  |
+
+### v0.41.0-alpha1 - Problems Encountered and Resolved
+
+| Problem                                               | Root Cause                                                                            | Resolution                                                   | Commit     |
+| ----------------------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------ | ---------- |
+| Search overlay stuck open on backdrop click           | `class={#signal}` + `data-signal-attr` double binding → full re-render → onClick lost | Static `class='overlay'` + `data-signal-attr` only           | `2482699b` |
+| Search input click closes overlay in Firefox          | Shadow DOM event retargeting, `e.target !== e.currentTarget`                          | `composedPath()` traversal                                   | `a4b69863` |
+| Client bundle contains `Deno.readDirSync`             | `manifest.ts` top-level execution of `buildManifest()`                                | Proxy + lazy init                                            | `0f7e44d6` |
+| CI 6 gates fail (version anchors, PWA, arch contract) | Rebase + v0.41.0 cleanup fallout                                                      | Updated version refs across 14 files, updated arch contracts | `5f169d76` |
+| `sanitize-html` + `flexsearch` missing from deno.json | Rebase introduced deps not declared                                                   | Added to imports maps                                        | `92215208` |

packages/ui/src/open-theme-toggle.tsx

@@ -20,7 +20,6 @@
 
 import { OpenElement } from '@openelement/element';
 import { StyleSheet, type StyleSheetLike } from '@openelement/core/style-sheet';
-import { openPropsTokenSheet } from './open-props-tokens.js';
 import { signal } from '@openelement/signal';
 export const tagName = 'open-theme-toggle';
 
@@ -72,7 +71,12 @@ sheet.replaceSync(`
 `);
 
 export class OpenThemeToggle extends OpenElement {
-  static override styles = [openPropsTokenSheet, sheet];
+  // ponytail: Safari does not recompute adoptedStyleSheets when
+  // :host([data-theme]) changes. The token sheets (openPropsTokenSheet,
+  // daisyClassSheet) are already injected as page-level <style> by
+  // vite.config.ts — CSS custom properties cascade from :root naturally.
+  // Only adopt the component-specific sheet.
+  static override styles = [sheet];
   static override delegatesFocus = true;
   static override observedAttributes = ['theme'];