跳到主要內容

ARC 2.0.0-beta.28 · AUP Web-only widget

comments-surface

AUP Web-only widget `comments-surface`: purpose, boundaries, surfaces, fallback, and evidence.

AUP Web-only widget — not a cross-device primitive; not a Web Device layout component.

The name is registered in AUP_WIDGETS (packages/aup/src/aup-types.ts). It can be accepted by structure verification and implemented by a Web runtime (or native target where noted). It is not one of the 18 cross-device AUP_PRIMITIVES, does not enter DeviceCaps.primitives via fillPrimitives, and is not a Web Device theme/site layout component (for example content-card or page-breadcrumb).

Purpose

Platform comment thread surface (compose, list, reactions, pagination). AUP wrapper wires props and events; host-agnostic bundle implements the browser DOM.

Boundaries

  • Do not document this type as a portable primitive.
  • Do not mix it with Web Device layout-component reference pages under widgets/.
  • A parser-accepted name is not a portability or product-readiness claim.

Author entry

AUP type: "comments-surface" or Web Device site-level mount when .web/comments enables comments (site-server path). Front matter can suppress per item.

Surfaces

Interactive site / AUP session. Requires identity/auth configuration when requireAuth is set.

Fallback

Site comments flag off → not mounted. No shared degradation chain.

Evidence

SourcePath
Registrationpackages/aup/src/aup-types.ts
AUP renderer wrapperproviders/runtime/ui/src/web-page/renderers/comments-surface.ts
Bundleproviders/runtime/ui/src/web-page/surfaces/comments-surface-bundle.ts
Web Device runtimeproviders/runtime/web-device/src/comments-surface-runtime.ts; site-server.ts comments mount
Showcaseblocklets/showcase/.aup/pages/comments.json

Paths are relative to the Arc repository checkout used for this documentation baseline.

Sample

Internal / experimental for public samples. Registration and renderers exist in the interactive Web runtime (and sometimes Web Device widget packages), but this site does not ship a docs-safe live sample. Do not infer product readiness from the type name alone.

Related