Skip to content

docs(BottomSheet): AST-094 names FR18's caller-sized exception; a comment names the pen - #10023

Merged
cixzhang merged 1 commit into
meta:mainfrom
vjeux:uikit/c17-sheet-fr18-notes
Nov 5, 2026
Merged

cixzhang merged 1 commit into
meta:mainfrom
vjeux:uikit/c17-sheet-fr18-notes

Conversation

@vjeux

@vjeux vjeux commented Nov 5, 2026

Copy link
Copy Markdown
Contributor

Reader impact

AST-094's BottomSheet line said that every finger's pull past the tallest detent stretches the sheet over a reserve deep enough for the whole stretch. It left out component:BottomSheet FR18's exception, so a reader of AST-094 alone expects that reserve on every sheet. A source comment also named only the mouse for the resisted stretch that a pen gets too.

No behavior change.

Source of truth

  • component:BottomSheet FR18: "A sheet the caller sizes or styles keeps 48 px below the screen, and its stretch stops there."
  • useSheetGestures.ts: a pull that is not a touch, a mouse's or a pen's, stretches past fully open by raw * OVERSCROLL_RESISTANCE, capped at OVERSCROLL_MAX.

Correction

  • AST-094's BottomSheet line adds "unless the caller sizes or styles it (component:BottomSheet FR18)" after the reserve. The rest of the line is unchanged, and its paragraph is re-wrapped.
  • The OVERSCROLL_RESISTANCE comment reads "A mouse's or a pen's stretch past fully open".
  • A [docs] Changeset covers the comment, as the repository's other comment-only changes do.

Evidence

Both are non-blocking notes from the automated review of #8109, which merged with them as follow-ups.

Writing rubric results

  • R1 narration: none; the added clause states what the sheet does.
  • R2 research in the record: none.
  • R3 evidence naming a change: none.
  • R4 rejected alternatives over one line or outside a decision: none.
  • R5 pull request or issue references remaining: none in the record.
  • R6 ruled open questions still listing options: none.

Scope

  • This PR changes documentation only, or names every necessary generated artifact.
  • Runtime, API, visual, and policy changes were removed or split.
  • Public text and artifacts contain no internal Meta context.

Testing

Local, at ea87f86 on main bb7702c: pnpm check:knowledge, Prettier and git diff --check on the three files, pnpm lint on the source file (no errors), the Changeset coverage check, and pnpm review:pre (0 findings).

…ment names the pen

AST-094's BottomSheet line said that every finger's pull past the tallest
detent stretches the sheet over a reserve deep enough for the whole stretch.
A sheet the caller sizes or styles keeps 48 px below the screen instead, and
its stretch stops there (`component:BottomSheet` FR18). The line now says so.

The comment on OVERSCROLL_RESISTANCE named only the mouse. A pen's stretch
past fully open uses the same resisted fraction, and the comment now names
it. A [docs] Changeset covers the comment.
@vercel

vercel Bot commented Nov 5, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
astryx Ready Ready Preview Nov 5, 2026 1:09am UTC

Request Review

@meta-cla meta-cla Bot added the CLA Signed This label is managed by the Meta Open Source bot. label Nov 5, 2026
@github-actions github-actions Bot added the needs:spec-owner-review Current knowledge records await owner approval label Nov 5, 2026
@astracat-bot

astracat-bot Bot commented Nov 5, 2026 •

Copy link
Copy Markdown
Contributor

AI review status for this pull request.

Review status Updated
🟢 Reviewed (for maintainers only) Nov 5, 2026, 1:26 AM UTC

@github-actions

github-actions Bot commented Nov 5, 2026 •

Copy link
Copy Markdown
Contributor

PR Analysis Report

🔎 Preview · ea87f86

Storybook · Sandbox · built from this PR's head

Modified components

Component Size LoC Visual · A11y · RTL
BottomSheet 56.3 kB (0) · 7.5 kB CSS (0) — ✓ · ✓ · —
BottomSheetSwitcher 17.4 kB (0) · 3.4 kB CSS (0) — ✓ · ✓ · —
ContextMenu 81.8 kB (0) · 16.0 kB CSS (0) — — · — · —
22 more components
Component Size LoC Visual · A11y · RTL
DateInput 154.9 kB (0) · 15.5 kB CSS (0) — — · — · —
DateTimeInput 177.0 kB (0) · 17.2 kB CSS (0) — — · — · —
DropdownMenu 77.3 kB (0) · 16.1 kB CSS (0) — — · — · —
Markdown 152.3 kB (0) · 18.9 kB CSS (0) — — · — · —
MoreMenu 77.6 kB (0) · 16.1 kB CSS (0) — — · — · —
MultiSelector 79.5 kB (0) · 15.5 kB CSS (0) — — · — · —
Pagination 92.4 kB (0) · 16.5 kB CSS (0) — — · — · —
Popover 55.1 kB (0) · 12.8 kB CSS (0) — — · — · —
PowerSearch 249.5 kB (0) · 22.3 kB CSS (0) — — · — · —
Selector 82.3 kB (0) · 16.1 kB CSS (0) — — · — · —
Table 91.2 kB (0) · 16.7 kB CSS (0) — — · — · —
TableCell 83.0 kB (0) · 16.5 kB CSS (0) — — · — · —
TableHeaderCell 82.6 kB (0) · 16.2 kB CSS (0) — — · — · —
TimeInput 140.4 kB (0) · 14.5 kB CSS (0) — — · — · —
Tokenizer 73.8 kB (0) · 17.1 kB CSS (0) — — · — · —
lab/ChatEmojiPicker 68.9 kB (0) · 773 B CSS (0) — — · — · —
lab/ChatReactionBar 69.4 kB (0) · 1.1 kB CSS (0) — — · — · —
lab/CommentComposer 108.6 kB (0) · 1.9 kB CSS (0) — — · — · —
lab/Comments 271.3 kB (0) · 2.5 kB CSS (0) — — · — · —
lab/CommentThread 266.2 kB (0) · 2.4 kB CSS (0) — — · — · —
lab/TourStep 61.1 kB (0) · 590 B CSS (0) — — · — · —
richtext/RichTextEditorToolbar 232.9 kB (0) · 454 B CSS (0) — — · — · —

Package size: @astryxdesign/core 6.49 MB packed (−2 B); no new dependencies.

API changes: none in this pull request

Committed API report behind this build: cli 9 rows, core 3 rows; run pnpm api:report.

Touched components checked; add ci:run-visual, ci:run-a11y or ci:run-rtl to run the full suites.


Generated by PR Enrichment workflow | View full report

@cixzhang

cixzhang commented Nov 5, 2026

Copy link
Copy Markdown
Contributor

/approve-spec ea87f86

@github-actions github-actions Bot removed the needs:spec-owner-review Current knowledge records await owner approval label Nov 5, 2026

@astracat-bot astracat-bot Bot left a comment •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved pending CI: the required checks are still running on this head.

The AST-094 BottomSheet line now names component:BottomSheet FR18's exception for a sheet the caller sizes or styles, and the OVERSCROLL_RESISTANCE comment names the pen, which the non-touch branch already serves. Both match the current records, and nothing a consumer imports or renders changes.

[Automated review]

@vjeux
vjeux marked this pull request as ready for review November 5, 2026 01:17
@cixzhang cixzhang added the ci:run A maintainer lets this outside contributor's pull request run CI (AST-030 FR17) label Nov 5, 2026
@cixzhang
cixzhang marked this pull request as draft November 5, 2026 01:19
@cixzhang
cixzhang marked this pull request as ready for review November 5, 2026 01:19
@cixzhang
cixzhang merged commit 5f81c3f into meta:main Nov 5, 2026
161 of 166 checks passed
@vjeux
vjeux deleted the uikit/c17-sheet-fr18-notes branch November 5, 2026 04:55

This branch was successfully deployed

1 active deployment
Preview — ea87f864 Deployed Nov 5, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ci:run A maintainer lets this outside contributor's pull request run CI (AST-030 FR17) CLA Signed This label is managed by the Meta Open Source bot.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants