@north-light/crouter 0.3.196 → 0.3.198

package/dist/pages/elements/text.d.ts

@@ -4,11 +4,17 @@
  *
  * The three shapes in the catalog are all this one element:
  *
- *  - a **draft** the user edits in place — `editable`, pre-filled;
- *  - **read** text the user leaves anchored comments on, review-style — select a range and
- *    the comment affordance appears at the selection;
+ *  - a **draft** the user edits in place — pre-filled and editable by default;
+ *  - **read** text the user leaves anchored comments on, review-style — set `editable: false`,
+ *    then select a range and the comment affordance appears at the selection;
  *  - an **empty input** — `editable` with no starting text, which opens already editing.
  *
+ * `singleLine` is the fourth shape and the one that is not prose: one compact form field for a
+ * subject line, a name, a URL. It is always editing, so it drops the edit toggle; it has no
+ * paragraphs to anchor a range against, so it drops the comment affordance and shows only the
+ * comments a saved answer already carried. Enter is a form field's Enter — it types nothing,
+ * and the pager's `⌘`/`Ctrl` + `Enter` still submits.
+ *
  * Text is always commentable; that is not a capability switch, and edit and comment coexist.
  * Reading is the resting state, because that is where anchored commenting lives; the edit
  * toggle swaps the block for a plain textarea. Comments survive the switch, but a range