docs: rc.10 diagnostics, attribution and Performance Tracks surface

[ryansolid]

Brings the diagnostics, attribution, and Performance Tracks coverage in line with solid-js 2.0.0-rc.10 (solid next c3adc2836) and @solidjs/vite-plugin next f9c4f63.

What rc.10 changed

• One records channel: the runtime's "render", "boundary", "invocation", "call", "frame", "recovery" records and the attribution engine's rerun, hold, interaction, navigation, … records all arrive on OBSERVE.records.subscribe(type, (event, live) => …); the engine no longer has its own hooks object (feat(signals)!: one records channel — engine records on OBSERVE.records, attribution.history(type), HoldEvent.silent/.long solid#3644, fix(web): performance-tracks labels start at the nearest component solid#3645).
• Observability surface prune: InvocationChannel, AttributionHooks, OriginRef, TraceSlot gone; ownerPath() and guideUrl() moved onto OBSERVE / DEV (feat!: consolidate diagnostic codes; sourceNames follows dev in both compilers solid#3646).
• Diagnostic code consolidation: WIDE_WRITE → HUGE_FAN_OUT (data.write), SERVER_FN_ERROR_SANITIZED/SSR_ERROR_SANITIZED → SERVER_ERROR_SANITIZED (data.source), SSR_BOUNDARY_WATERFALL split from ASYNC_WATERFALL; new codes GRAPH_GROWTH, WASTED_RECOMPUTE, STACKED_HOLDS, OPTIMISTIC_REVERTED, and the rest (refactor!: prune observability surface — OBSERVE.ownerPath, DEV.guideUrl, drop install/aliases/unused options solid#3649).
• Lean posture and the values option: attribution.enable() returns a release, holds combine, RerunEvent is only built while something listens, values: "full" | "labels" | "none" (feat(web,signals)!: "render" record + AttributionOptions.values; Server-Timing as record projections solid#3650).
• Performance Tracks: @solidjs/web/performance-tracks with nearest-component labels and server spans; scrub/group removed (docs(signals): lean posture landed — contract answers, engine-cost cap 14 → 4 solid#3654).
• Source names: compilers' componentNames → sourceNames, default on in dev; the vite plugin resolves solid.sourceNames per kind and runs the transformSourceNames pass for primitives (feat: source names for the dev and observe postures solid-vite-plugin#371).

Generator changes

• scripts/extract-solid-ref.mjs: new @solidjs/web/performance-tracks entry point and (2)solid-web/(7)performance-tracks route; disposition map updated (fold RenderEvent/RecoveryEvent and friends into OBSERVE, the new attribution event types into attribution, GraphSize into graphSize, PerformanceTracksOptions into enablePerformanceTracks; drop the removed InvocationChannel/AttributionHooks/AttributionRecords/AttributionRecordType/OriginRef/TraceSlot entries; hide serializeStream and ssrElementAttribute); OBSERVE and attribution summaries rewritten around the records channel; Learn links for graphSize and enablePerformanceTracks.
• scripts/check-examples.mjs: @solidjs/web/performance-tracks entry point so its examples type-check.

Regenerated reference pages

• reference/solid-js/advanced/diagnostics-dev-hooks/{observe,dev,attribution}.mdx
• reference/solid-web/request-response/get-trace-context.mdx (TraceSlot section removed)
• New reference/solid-web/performance-tracks/enable-performance-tracks.mdx, linked from the @solidjs/web index.

Guides

• Debugging reactivity: rc.10 code groups (HUGE_FAN_OUT at fanOut, the cost and responsiveness lists, a server-rendering line), attribution.enable() as a hold with a release, history(type) in place of holds(), the records channel, enablePerformanceTracks().
• Performance: WIDE_WRITE → HUGE_FAN_OUT; new "See the records on the Performance panel" section (tracks, labels, Server-Timing metrics, options, values).
• Observability: componentNames → sourceNames, "render" and "recovery" records, engine records on the same channel, the values table, data.error on the sanitized-error codes.
• Observability adapters: OBSERVE.records.subscribe for engine records, silent/long on holds, SSR_BOUNDARY_WATERFALL and SERVER_ERROR_SANITIZED with data.source, the listener subject argument and OBSERVE.ownerPath(subject).

Vite plugin options page

• New observe, diagnostics, and solid.sourceNames sections (the three kinds, which compiler handles each, the four-row resolution table, false as a dev opt-out), and dev notes it decides the sourceNames default. diagnostics: false, which the debugging guide references, is confirmed against src/index.ts.

Doc bugs fixed

• The feedback tables have no late column. FeedbackSource (packages/signals/src/core/attribution-feedback.ts) records holds, heldMs, acknowledgedBy, latestOnly, silent, long; the sentence now says that.
• FLUSH_IN_ACTION is not a DiagnosticCode; flush() throws it in development (scheduler.ts:1600). Removed from the codes list in favor of the real FLUSH_IN_EFFECT_CALLBACK, with a note that it is a thrown error and a link to the section that covers it.
• Size caps in the observability guide updated from scripts/size/.size-limit.js: CSR prod 16.04 KB, observe 17.83 KB, observe + attribution 31.98 KB.

Checks

• pnpm check:lint ✔
• pnpm check:types ✔
• node scripts/lint-tone.mjs — 0 errors (1 pre-existing generated warning in action.mdx)
• node scripts/check-examples.mjs — 552 blocks, 1 pre-existing error (see below)
• pnpm build ✔ (97 reference files, 196 llms documents)
• Prettier on the hand-edited guides and options page.

Not in this PR

• sync:ref against rc.10 also rewrites 15 unrelated reference pages that have drifted from the source since the last regeneration. Those were reverted here to keep the diff on topic; a follow-up pnpm sync:ref commit should land them.
• scripts/check-examples.mjs fails on (6)migration/(3)from-solid-router.mdx:224 (noScroll prop on <a>), which predates this branch.

Co-Authored-By: Claude via Cursor cursoragent@cursor.com

[bolt-new-by-stackblitz]

Run & review this pull request in StackBlitz Codeflow.

[netlify]

✅ Deploy Preview for solid-docs-v2 ready!

Name	Link
🔨 Latest commit	f252988
🔍 Latest deploy log	https://app.netlify.com/projects/solid-docs-v2/deploys/6ab8cc6f4b46000008dc6fa1
😎 Deploy Preview	https://deploy-preview-1642--solid-docs-v2.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
🤖 Make changes	Run an agent on this branch

---

To edit notification comments on pull requests, go to your Netlify project configuration.