3
0
mirror of https://github.com/larvit/adf-codec.git synced 2026-11-20 07:05:44 +01:00

Write emoji, status, date and URL card as HTML elements, not the carry

This commit is contained in:
2026-11-04 13:36:50 +01:00
committed by Lillem4n
parent 7ca6114f5d
commit 7c17447a87
14 changed files with 236 additions and 24 deletions
+13
View File
@@ -35,11 +35,21 @@ block's `data-*` attributes stand on its `<pre>`.
| ADF | HTML |
| --- | --- |
| `date` | `<time class="adf-date" datetime="2025-08-25" data-timestamp="1756080000000">2025-08-25</time>`, the day in UTC; its other attributes after the class, as below |
| `em`, `strong`, `code` | `<em>`, `<strong>`, `<code>` around the text |
| `emoji` | `<span class="adf-emoji" data-id="1f389" data-short-name=":tada:">🎉</span>`, its `text` the content |
| `hardBreak` | `<br>` |
| `inlineCard`, holding a `url` | `<a class="adf-inline-card" href="https://example.com/spec">https://example.com/spec</a>` |
| `link`, holding `href` and an optional `title` | `<a href="…" title="…">` around the text |
| `status` | `<span class="adf-status" data-color="yellow">In review</span>`, its `text` the content |
| `text` | its text, escaped |
A `date`, `emoji`, `inlineCard` or `status` writes each other attribute its type holds as a
`data-*` attribute, named and sorted as on a block, `data-local-id` among them. It rides the carry
where it holds a mark, `content`, a key or value its type does not hold, or an empty `attrs`; where
it has no text to show (an emoji or status with no `text`, a date whose `timestamp` names no day, a
card with no `url`); and where a card holds `data`. A `mention` rides the carry.
A text node's marks nest in the order its `marks` array lists them, the first outermost:
`<strong><em>manual</em></strong>`. Each text node writes its own elements, so two text nodes a link
marks are two `<a>` elements.
@@ -138,6 +148,9 @@ that node in either spelling: an edit there would be lost, so it is `unmappable-
- Any other HTML is `unmappable-html`: another element, attribute or escape, attributes in another
order, a block on the line of another, a carriage return not followed by a line feed, or
non-empty HTML not ending in a line feed.
- An emoji, status, date or card element reads back as its node only when it shows what `adfToHtml`
writes for it: the text is not empty, a date's `datetime` and text are the day its `data-timestamp`
names, and a card's `href` and text are one URL. Another shape is `unmappable-html`.
- A `data-*` attribute that its element does not take, such as `data-level` on `<h1>`, or that holds
a value outside its attribute's kind or not written as compact JSON, is `unsupported-node-shape`.
- A carry element's `data-adf` holding invalid JSON is `unmappable-html`. JSON that is no ADF node,