Repository navigation
docs: mark the WebGL renderer experimental, take its switch off the demo, 0.24.2 - #64
Merged
Merged
Conversation
On a real phone the renderer makes the sheet's text jump at the start and the end of every drag, and a visitor who flips the switch sees that first. The switch now shows up only when the link carries `webgl=1`, for testing on devices, and says it is experimental. The link carries the renderer flags only while they are on, so an ordinary permalink does not bring the switch back. The feature card says experimental too.
The guide opens with a notice and lists the known issues: text that shifts when it moves into the texture and back, screen-reader-only text in the texture, a bend that reads as jitter, and Safari hiding the renderer's name. The README tables, llms.txt and a Context7 rule mark the entry experimental so assistants stop suggesting it, and the stability page leaves /webgl out of what 1.0 freezes.
From the Visual baselines (linux) workflow run on this branch; only the seven hero snapshots, which print the version.
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Bundle size report (gzip, threshold 5%)
|
Surdeddd
temporarily deployed
to
github-pages
November 15, 2026 10:46 — with
GitHub Actions
Inactive
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this changes
The WebGL renderer (
@surdeddd/bottom-sheet/webgl) is marked experimental in the documentation, and its switch comes off the demo's workbench. No code in the package changes. Released as 0.24.2 so the README on npm carries the notice.docs/webgl.mdopens with an "Experimental" notice and gains a Known issues section.llms.txt: the/webglrow and the topics link say experimental.llms.txttells assistants not to add the renderer unless asked, andcontext7.jsongets the same rule.docs/api-stability.md:/webglis the exception to what can be relied on, and it is not frozen by 1.0.#webgl=1, labelled experimental. The permalink writes the renderer flags only while they are on, so an ordinary link does not bring the switch back. The F.12 card says experimental.Why
Tried on a real phone, the renderer makes the sheet's content jump. Reproduced on the live demo in WebKit with a GPU:
letter-spacingandtext-transformdo not match the browser exactly. This is how the content lift works, not a one-line bug.Removing
/webglwould break anyone who imported it after 0.24.1 came out yesterday. Marking it experimental keeps them working, stops the docs and AI assistants from recommending it, and takes it off the demo, where every visitor saw the jump first. Whether it is fixed or removed is left for before 1.0.Verification
npx tsc --noEmit— cleannpx vitest run— 100 files, 1040 passed, 2 skipped (permalink test now checks that a switched-off renderer leaves no trace in the link)npx playwright test—demo-rendererinmobile-chrome,mobile-safari,firefox: 49 passed, 2 skipped (two new tests: the switch is hidden on the plain page, the link brings it back labelled experimental).a11y,sheet,adapters,demo-rendererin Chromium and WebKit: 73 passed, 7 skipped. Visual: 21 of 21 after regenerating the hero baselinesnpm run size— not affected, no code undersrc/changednpm run docs:check— 39 files OKChecklist
src/ordemo/docs/andCHANGELOG.md— no API change; the notice is in bothsrc/styles/bottom-sheet.css? — noVisual baselines (linux)follow as one more commit