solidjs / solid / 36628003965

76%

main: 89%

push

github

docs: design fit (§10), live-mutation seed (§9.6), examples grid plan (#3711)

* docs: design fit (§10), live-mutation seed (§9.6), and the examples grid plan

Recorded from the fit conversation after the Stage 7 gate, parked while
#3704 was in review; lands now that it has merged. Nothing here touches
code.

Principles §9.6 seeds Stage 9 — mutations through a live connection:
three homes for a rejection in the live quadrant (client, a bounded
sibling's single-flight response, server memory) and which one the
design recommends. §10 answers where server components fit: three
axes (content weight, origin of change, client-owned position density),
five quadrants with each example placed, where a rejection lives per
shape, the advice as rules of thumb, and the candidates to evaluate
against the map with the evidence each needs.

`documentation/plans/examples-grid-plan.md` turns that into the example
set as a whole: one idiomatic app per grid coordinate, the bar every
example meets, per-example dispositions (hackernews' Toggle becomes an
attribute slot; todos-server reshaped; chat rebuilt and board added as
the two flagships; room retired), the verification items that gate the
reshapes, and the order — revised today to least work first, one
example per PR, exact code reviewed before it is written. todos-server's
target is decided: Q5.

Co-authored-by: Claude via Cursor <noreply@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: examples plan — authoring layout, binding slots, and the gaps ahead

Records where the first example review (hackernews) landed before any
example code moves.

Authoring layout, every example with a server side: one screen is one
file, the server component a function-level "use server" inside its
query, so its name is the server function's name; a route file exports
only what the router reads; src/server/ holds server-only modules behind
the vite plugin's server-only marker, imported by namespace. Checked
against t... (continued)

625 of 912 branches covered (68.53%)

Branch coverage included in aggregate %.

936 of 1186 relevant lines covered (78.92%)

27.21 hits per line