Scroll Area

Base Scroll Area 建模一个 logical scrolling domain，而不是包装 Web DOM scrollbar。Viewport 拥有 surface，并通过特权 capability 接入 host scrolling；Root 与 composed controls 只作为 layout/projection parts。

Canonical family 包含：

• Root 1..1：只拥有 anatomy 与 JSON-only family scope，不拥有 offset、geometry、focus、event 或 default size；
• Viewport 1..1：唯一 logical scroll-surface owner；
• Scrollbar 0..2：horizontal/vertical composed-control route；
• Thumb 0..2：Scrollbar 内的 feedback-only hit subregion。

Viewport expose normalized axes、position、visible ratio、direction availability、scrolling state 与 resolved projection。Raw DOM node、pixel、widget、physics 与 input recognizer 仍由 host 负责。

system 与 composed 是同一 protocol 的投射策略。默认值由 Host Adapter 和 design-language preference 共同解析；它们不是两个 Base Prototype。composed mode 中，host 把 normalized facts 映射为 Thumb geometry，并通过现有 scroll engine 路由 movement。Thumb 不拥有独立 offset state、focus target、scrollbar role 或 Drag and Drop 语义。

Scroll domain 为 append-only surface 提供独立 opt-in 的 endFollow policy。声明自有 privileged asScrollSurface() 的 composition 可以配置 { mode: 'while-at-end', axis: 'vertical' }，观察每轴 atEnd 以及 endFollow.state、endFollow.requestStatus，并让 accessible jump control 发送 { kind: 'to-end', axis: 'vertical' }。

Host 只在 lease active 时跟随 layout growth；reader 离开末端后 pause，rapid append 会被 coalesce，自然到达末端或 semantic request 会恢复 follow。该能力不移动 focus、不接管 Live Region，也不强制 smooth motion。Raw offset、extent、target 与 pixel threshold 始终留在 host-local boundary。

Base Scroll Area Viewport 默认保持该 policy 为 off。Message label、unread count、history-prepend visual anchoring 与 virtualized collection 仍分别属于 application 或其他 capability。

稳定版 0.2.0 package 导出了 @proto.ui/prototypes-base/scroll-area。与本组另外六个 family 不同，当前 CLI registry 没有 base-scroll-area component facade；它提供的是完整的 brutalist-scroll-area projection。Base library author 可以直接消费 public subpath，而面向 App 的 generated usage 当前从风格化投射进入。

T-BASE-SCROLL-AREA-0001、T-SCROLL-END-FOLLOW-0001 及相关 Scroll/Move tests 把 host boundary 映射到 focused module、real-browser 与 cross-adapter Web conformance。本页 Preview 通过三个 Web Adapter 渲染同一个 Base logical family；由于 Base Viewport 不 opt in，end-follow 使用独立 source-bundled Chromium journey。

Root、Viewport、Scrollbar 与 Thumb entities 当前都是 draft。现有证据覆盖 system/composed projection、normalized facts/requests、host cleanup、composed Thumb movement 与独立 opt-in end-follow lease。Track-page press、完整 keyboard scrollbar semantics、RTL/writing-mode normalization、velocity、visual-anchor preservation、virtualization 与通用 Drag and Drop 仍不在 guarantee 内。

• P-BASE-SCROLL-AREA
• Parts：Viewport、Scrollbar、Thumb
• Scroll Area source
• Scroll Area evidence
• End-follow contract 与 evidence
• 风格化投射：Brutalist Scroll Area