Skip to content

Navigation Menu

Sign in
Sign up

docs: define bidirectionality design intent - #6047

Draft
nynexman4464 wants to merge 1 commit into
main from
nynexman4464/docs/bidirectionality-contract
Draft

docs: define bidirectionality design intent #6047
nynexman4464 wants to merge 1 commit into
main from
nynexman4464/docs/bidirectionality-contract

Conversation

@nynexman4464

@nynexman4464 nynexman4464 commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

Problem

Astryx has RTL implementation guidance and browser audits, but no current human-owned record defining what correct bidirectional behavior means. Reviewers can see whether pixels changed without having one authority for what should mirror, what should remain physical, and how interaction meaning should change.

Changes

Add a draft design:bidirectionality record covering:

  • semantic mirroring rather than mechanical reflection;
  • content direction versus layout direction;
  • exactly-once treatment of directional artwork;
  • physical and direction-neutral exceptions;
  • keyboard, drag, scroll, overlay, and responsive behavior;
  • mixed-direction text and browser dir semantics;
  • pointer/touch targets staying aligned with visible controls and preserving their owning component's target-size requirement.

The touch-target requirement incorporates the review lesson from #5177: proving center alignment alone is not enough. Target size remains owned by AST-020 and the applicable component/composition contracts.

This stays separate from audit mechanics and the component-audit rubric. The design record says what people should experience; evidence architecture says what proves it; component contracts adopt the relevant requirements.

This PR is intentionally draft and remains non-authoritative until design-owner approval. Its architecture references must be promoted before, or together with, this record.

Test plan

vercel Bot commented Sep 4, 2026
edited
Loading

Copy link
Copy Markdown

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

Project Deployment Actions Updated
astryx Ready Ready Preview Sep 4, 2026 8:28pm UTC

Request Review

@meta-cla meta-cla Bot added the CLA Signed This label is managed by the Meta Open Source bot. label Sep 4, 2026

cixzhang commented Sep 5, 2026

Copy link
Copy Markdown
Contributor

/approve-spec e406a84

@cixzhang cixzhang 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.

Thanks for consolidating the shared bidirectionality design intent. Approved at exact head e406a8402eb4b94e719b3ccea91bb4038c23f3c2.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@cixzhang cixzhang cixzhang approved these changes
@imdreamrunner imdreamrunner Awaiting requested review from imdreamrunner imdreamrunner will be requested when the pull request is marked ready for review imdreamrunner is a code owner
@josephfarina josephfarina Awaiting requested review from josephfarina josephfarina will be requested when the pull request is marked ready for review josephfarina is a code owner

Assignees

No one assigned

Labels

CLA Signed This label is managed by the Meta Open Source bot.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

AltStyle によって変換されたページ (->オリジナル) /