# Bugs

Working bug log for `@dolphinspired/solid-stage`, filed as we hit them in real consumers
(osrs-engine-study is the first — it exercises the library in ways the playground
doesn't: real WebGL canvas under the dock model, store-backed fields mounting
mid-update, etc.).

One bug per file. Name: `kebab-case-symptom.md`. Write enough that a cold reader
(future you, or an agent) can pick it up and solve it without re-deriving context.

## Suggested shape

- **Title** — one-line symptom (the `# H1`).
- **Status** — `open` / `investigating` / `fixed (consumer workaround)` / `fixed` /
  `wontfix`. Note if a consumer already worked around it.
- **Severity** — crash / wrong behaviour / cosmetic, and whether it's degraded vs hard-fail.
- **Component** — the `packages/solid-stage/src/...` file(s) involved.
- **Found by / Affects** — which consumer + which version.
- **Symptom** — what the user sees (paste the error/stack).
- **Reproduction** — minimal shape or steps; note the environment that matters
  (real canvas? store-backed? headless?).
- **What's ruled out** — eliminations save the next person time.
- **Root cause** — confirmed, or hypotheses ranked.
- **Suggested fix** — in the library; plus any consumer workaround.
- **Repro harness / diagnostic** — a script, or a console snippet + decision tree.

When fixed, flip Status to `fixed`, link the commit/PR, and keep the file (it's the
regression-test rationale). Move to an `archive/` subdir only if this list gets noisy.