`editor` primitive

editor is an AUP cross-device primitive, not a Web Device layout component and not a Web-only widget. It is one of the 18 names in AUP_PRIMITIVES and appears in every target's DeviceCaps.primitives map as native, webview, partial, or unsupported.

Contract

When to use

Code or long-form edit surfaces on targets that implement editor.

When not to use

Do not claim collaborative editing, LSP, multiplayer, or write-back from a docs page.

Sample contract

Document sample (local textarea)

Document registers an editor renderer. The sample below is an unbound control: typing changes only the browser textarea. Markdown attributes are strings — do not assume readOnly=true from MD attributes sets boolean true the way AUP JSON does. Prefer AUP JSON/DSL when you need a strict read-only prop.

Source:

::editor{id="docs-prim-editor" language="json" label="Example snippet" value="{ \"ok\": true }"}

Rendered:

::editor{id="docs-prim-editor" language="json" label="Example snippet" value="{ "ok": true }"}

AUP JSON shape (interactive / when you need boolean readOnly):

{
  "id": "snippet",
  "type": "editor",
  "props": {
    "label": "Example",
    "language": "json",
    "readOnly": true,
    "value": "{ \"ok\": true }\n"
  }
}

Failure and limits

Verification evidence

Evidence anchors

Nearby pages