Skip to main content

Web Device surface · ARC 2.0.0-beta.28

`comments-surface` surface

Web Device surface `comments-surface`: purpose, boundaries, author entry, evidence, and sample honesty.

Web Device surface — not an AUP primitive (surface); not an AUP widget (wm-surface / same-named widgets); not a theme layout component.

Package: providers/runtime/web-device/surfaces/comments-surface/ (manifest.json + render.js).

Purpose

Comment thread for the AFS path this page renders. Server output is a skeleton; the thread hydrates on the interactive path.

Boundaries

  • Surface packages are mounted by boards/routes/layout shells — they are not Markdown directives.
  • Same type name as a widget does not merge layers; this page is the surface contract only.
  • Do not document multiple surfaces on this page.

Author entry

surface mount / AUP

Common author-facing props (from manifest): target, title, composer, reactions, collect, requireAuth, emptyText, loginPromptText, composerText, errorText, retryText, messages

Surfaces

As implemented by this package (document shell, layout list, interactive site, etc. — see notes).

Public status

experimental

Fallback

Login empty state / empty thread prompts.

Sample

No docs-safe live sample on this site yet. Use the evidence paths as source-only reference. Experimental units must not be described as released product capability.

Evidence

ItemPath
Surface packageproviders/runtime/web-device/surfaces/comments-surface/
Manifest…/comments-surface/manifest.json
Renderer…/comments-surface/render.js
Internal matrixdocs/aup/capability-matrix.md §4 (internal, non-routed)
Matrix row conceptsurface · comments-surface

Notes

Same type name as the AUP widget comments-surface, but this page documents the Web Device surface package. Auth/identity prerequisites apply. Experimental.