Docs papercuts from alpha.6 feedback: rcx arity, form in imports, sheet selectors, props destructuring warning

[mkotulac-markot]

Problem

Four small, individually shippable docs gaps surfaced during the alpha.6 end-to-end build feedback. Filing as an omnibus because each is a 1–5-line fix and they share a reviewer.

1. form missing from the LLM reference's primary imports example

form is present in the full import line in the LLM reference card, but absent from the condensed "start here" imports block. A reader scanning to confirm "do forms exist" has to scan twice.

Fix: add form (and label if similarly omitted) to the primary imports example.

2. rcx() arity is under-demonstrated

The docs show rcx(static, () => dynamic). The reviewer guessed that rcx(() => a, () => b) also works and used it — if that's supported, it's worth showing; if it's the canonical shape, even more so.

Fix: add one example each for the common arities (static+getter, getter+getter) with a note if there are limits.

3. Advanced selectors in sheet() not in examples

&::after, & > span, &:checked::after, &:hover span — the reviewer wrote these assuming standard CSS-in-JS semantics and they worked. If the parser supports the full nested-selector grammar, flaunt it; if there are limits, call them out.

Fix: expand the sheet() example in the styling docs to cover pseudo-elements, child selectors, and state-pseudo + pseudo-element stacking. One example is enough.

4. component((props) => ...) destructuring footgun warning is too quiet

This is the classic Solid-style footgun: destructuring props at setup time loses the live reactive reference for any values computed later. The docs show props.x inside the body (correct) but don't explicitly warn against const { x } = props. For an LLM-first framework, this deserves a louder callout because it's exactly the kind of well-intentioned refactor an assistant will perform.

Fix: add a "Don't destructure props" call-out box to core-concepts/components with a worked wrong/right example.

Acceptance criteria

• LLM reference card: form in primary imports example.
• rcx() docs page: both common arities shown; explicit note on what's supported.
• sheet() docs page: one example using nested pseudo-element/child/state selectors.
• core-concepts/components: loud "Don't destructure props" warning with wrong/right example.
• Each of the four items checked off in this issue before close.

Context

Source: dev/FRAMEWORK_FEEDBACK_CLAUDE.md ("Minor papercuts" section). Mostly whisqjs/whisq.dev work; the LLM reference is cross-repo.

[mkotulac-markot]

Docs-side coverage of the four papercuts in this issue is already split across three whisq.dev issues:

• Update README — whisq.dev is live #1 form in primary imports → whisqjs/whisq.dev#82 (/api/imports/ reference page)
• fix: pin hono to >=4.12.14 (Dependabot alert #1) #2 rcx() arity → whisqjs/whisq.dev#84 (LLM-reference polish bundle)
• chore: add CODEOWNERS and PR template #3 sheet() nested selectors → whisqjs/whisq.dev#81 (expand nested selectors)
• chore: add dependabot.yml (weekly updates, target develop) #4 props destructuring footgun → best landing spot is whisqjs/whisq.dev#83 (/common-mistakes/ symptom→why→fix page)

Close this as duplicate of the above when all four docs-side issues ship.

[mkotulac-markot]

Framework-repo side of this issue is effectively done as of alpha.8:

• ✅ form is present in the primary imports example in both packages/core/docs/access-shapes.md worked examples and packages/create-whisq/src/templates/full-app/CLAUDE.md. Any scaffolded app inherits the full import list.
• rcx() arity docs — lives on whisq.dev (/api/rcx/); out of scope here.
• sheet() nested selector examples — lives on whisq.dev; out of scope here.
• "Don't destructure props" warning — docs ask for the whisq.dev /core-concepts/components/ page.

Keeping the issue open tracks the whisq.dev-side work. Not actionable as a /full-feature target in this repo.

[mkotulac-markot]

Status audit against current whisqjs/whisq.dev main branch — 3 of 4 ACs look complete from this side:

• ✅ LLM ref form in primary imports. src/content/docs/ai/_llm-reference/minimum.txt:7 shows form, label, both present.
• ✅ rcx() both common arities. api/rcx.mdx covers "Static base + reactive toggle" (rcx("btn", () => loading.value && "btn-loading")) and "All reactive" (rcx(() => \theme-${theme.value}`, () => `size-${size.value}`)`).
• ✅ sheet() nested selectors. api/sheet.mdx shows &:hover, &::before, &::after, &::placeholder, &:hover:not(:disabled), & > li, & > li + li, plus a "Single level of nesting" limit note.
• ❌ core-concepts/components "Don't destructure props" callout. Current page uses props.initial / props.value / props.label correctly throughout, but there's no explicit anti-pattern box for const { x } = props. This is the only remaining item.

If the docs-repo author/agent can verify items 1–3 on their side and tick the boxes, the scope collapses to "add the destructuring callout to core-concepts/components.mdx" — a one-callout-box PR.