@north-light/crouter 0.3.191 → 0.3.193

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

@@ -0,0 +1,25 @@
+/**
+ * `<crtr-text>` — the universal primitive: prose the agent puts in front of the user, which
+ * the user can rewrite, annotate, or both.
+ *
+ * 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;
+ *  - an **empty input** — `editable` with no starting text, which opens already editing.
+ *
+ * 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
+ * anchor written before an edit can end up pointing at moved text — which is why every range
+ * carries the `quote` it was written against.
+ *
+ * `edited` means *differs*, not *was touched*: returning the text to what the agent wrote
+ * un-sets the flag.
+ *
+ * Ported from the reviewed interaction kit (`apps/gateway/components/agent-ui/agent-text.tsx`
+ * and `comment-affordance.tsx` @ `3705fe9e2`), framework-free and styled only through the
+ * bundle's `--crtr-*` tokens.
+ */
+export {};