yrby 0.3.1 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: addc2f9c08a109299b6c3db7cbf977b9b39194b7d784424b55876e8357897b29
-  data.tar.gz: 586d689d080396b5e3c9cf528f49dfbccd5dca831e6e64bbaf6de35216f74143
+  metadata.gz: 3c53c83185ba046ddbcb6b232953af9aa2f52f883120aff8bb2fed8867f247df
+  data.tar.gz: 6a09a5541cca754d6ff838feb82838ce881d8fea144fed692031f7c957c9850b
 SHA512:
-  metadata.gz: 3412853b540745a3a1db1134104c7cda42330d952b9d6eb08d8c20512069eae93f762aa77204cb6ecc3961da0c117df6bb66ef4b2aad5b0b81b05beedf3253b7
-  data.tar.gz: 6d65ed5a61f737cd904800747c40e74d7b57fb0f64f77b12128533a0cfbf4c86058e13d2b2a33d9d005a7bfd015c31683fb25054236dbb3f28639f867d9a3a69
+  metadata.gz: d44fb5bb2a723b6a0dcf7ac6fd3bc248bd58f1401fe2e62009a214148f4a7b1ef1586d0d25585b39d291667eff04d6c66e911c7cdb5dec4968a0f3192b70a85c
+  data.tar.gz: 74da78ebc395e44cbdc9f32dcc51a239b7ea312de24f5ac64ec47db41bc784b47a53425afc83b948d36c9bf1b11922a3f9f3aa6615dcbac72a77759abe046ccc

data/CHANGELOG.md

@@ -6,6 +6,41 @@ to follow [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-07-08
+
+### Added
+
+- **`Y::Lexical` — render Lexical/Lexxy documents to HTML.**
+  `Y::Lexical.new(doc).to_html` turns a Lexxy document into HTML on the server,
+  with no Node process or headless editor. The output is identical to the HTML
+  a `lexxy-editor` submits to Rails; the tests check it byte-for-byte against a
+  document captured from a real editor. It covers the whole Lexxy 0.9.x node
+  set: headings, every text format, links, bullet/numbered/check/nested lists,
+  quotes, code blocks, horizontal rules, tables with header cells, image galleries, and
+  ActionText attachments. Unknown nodes fall back to a plain paragraph, and a
+  root that isn't Lexical (a ProseMirror document, say) returns `nil`. This is
+  what `tiptap-php` does for ProseMirror JSON, applied to the Yjs structure.
+- `read_xml` now pulls text out of attachments too: a mention's text goes
+  inline, and an upload adds its caption, alt text, or filename. Before, both
+  were dropped.
+
+## [0.4.0] - 2026-07-07
+
+### Added
+
+- **`Y::ProseMirror` — render ProseMirror/Tiptap documents to HTML.**
+  `Y::ProseMirror.new(doc).to_html` turns a Tiptap document into HTML on the
+  server, with no Node process or headless editor. The output matches Tiptap's
+  own `getHTML()`; the tests check it byte-for-byte against a document captured
+  from a real editor. It follows `ueberdosis/tiptap-php` and reads both name
+  styles editors use — Tiptap's `bulletList`/`bold` and prosemirror-schema-basic's
+  `bullet_list`/`strong`. Covers paragraphs, headings, blockquotes,
+  bullet/ordered/task lists, code blocks, links, images, mentions, details,
+  hard breaks, horizontal rules, tables, text styles (color, font family), and
+  every text mark. A table renders as semantic `<table><tbody>` without the
+  editor's column-width styling. A root that isn't ProseMirror (a Lexical
+  document, say) returns `nil`.
+
 ## [0.3.1] - 2026-07-01
 
 Fixes from a full source review.

data/README.md

@@ -157,6 +157,17 @@ doc.handle_sync_message(data)     # => [msg_type, sync_type, response]; answers
                                   #    SyncStep2 (never serves pending structs)
 ```
 
+### Reading document contents
+
+Reconstruct a document server-side — search, exports, emails, SSR — with no
+Node process:
+
+```ruby
+doc.read_text("prosemirror")  # => plain text of a Y.Text root, or nil
+doc.read_xml("root")          # => text of an XML root, one block per line
+doc.read_map("state")         # => a Y.Map root as a JSON string; JSON.parse it
+```
+
 ### Pending structs and gap-free state
 
 If a doc applies an update whose causally-prior update is missing (a "gappy"
@@ -175,6 +186,56 @@ guarantees keep serving safe:
   keeps its pending), while `encode_state_as_update` stays lossless so you can
   still preserve the raw pending bytes for recovery.
 
+### Rendering to HTML
+
+Two schema-pinned renderers turn a collaborative document into HTML on the
+server, with no Node process or headless editor: `Y::ProseMirror` for
+ProseMirror/Tiptap documents and `Y::Lexical` for
+[Lexxy](https://github.com/basecamp/lexxy) (Lexical) documents. Each returns
+`nil` for a root that belongs to the other schema.
+
+#### `Y::ProseMirror`
+
+```ruby
+prosemirror = Y::ProseMirror.new(doc)
+prosemirror.to_html            # the "default" fragment (Tiptap's default root)
+prosemirror.to_html("content") # or another XML root
+```
+
+The output matches Tiptap's own `getHTML()`, checked byte-for-byte in the tests
+against a document captured from a real editor. It follows
+[`tiptap-php`](https://github.com/ueberdosis/tiptap-php) and reads both name
+styles editors use — Tiptap's `bulletList`/`bold` and prosemirror-schema-basic's
+`bullet_list`/`strong`.
+
+It covers paragraphs, headings, blockquotes, bullet/ordered/task lists, code
+blocks, links, images, mentions, details, hard breaks, horizontal rules,
+tables, text styles (color, font family), and every text mark. A table renders
+as semantic `<table><tbody>`, without the column-width styling Tiptap's editor
+view adds.
+
+#### `Y::Lexical`
+
+```ruby
+lexical = Y::Lexical.new(doc)
+lexical.to_html            # the "root" fragment (Lexical's default root name)
+lexical.to_html("notepad") # or another XML root
+```
+
+The HTML is identical to what a `lexxy-editor` submits to Rails (its `value`).
+The tests check this byte-for-byte against a document captured from a real
+editor.
+
+It handles the whole Lexxy 0.9.x node set: paragraphs, headings, every text
+format and their combinations, links, the four list types and nesting,
+blockquotes, code blocks, tabs and soft breaks, horizontal rules, tables with
+header cells, image galleries, and ActionText attachments (uploads and
+mentions both emit `<action-text-attachment>` elements that ActionText can
+re-render).
+
+In both renderers an unknown node keeps its content — text falls back to a
+plain paragraph rather than disappearing.
+
 ### Protocol codec (module functions)
 
 Classifying and unwrapping wire frames is stateless, so it's exposed as
@@ -242,21 +303,6 @@ servers:
   causal dependencies are already in the store (checked against `on_load`); a
   causally-incomplete update triggers a resync instead, so the log always
   rebuilds cleanly.
-- **An unhealable gap is dropped, not resynced forever.** A resync heals a gap
-  whose missing dependency is still in flight. But a *permanently*-orphaned update
-  (its dependency is gone for good) stays gappy through every resync, and a client
-  retransmitting it would loop endlessly (server resyncs → client resends →
-  repeat). After `gap_strike_limit` rejections of the same update on one
-  connection (default 3, minimum 2), the channel settles it with
-  `{ "ack" => id, "dropped" => true }` and drops it instead of resyncing again —
-  breaking the loop while never dropping a *healable* gap (those heal within a
-  resync or two, and healing frees the strike). The `dropped` flag lets the
-  client surface the loss (`yrby-client` reports it via `onError`) instead of
-  silently showing synced. Set `gap_strike_limit nil` to disable. Works on both
-  transports: plain ActionCable keeps strikes on the channel instance; under
-  AnyCable (fresh instance per RPC command) they persist through
-  anycable-rails' `state_attr_accessor` (istate), declared automatically when
-  anycable-rails is loaded.
 - **`on_change` is at-least-once, and the durable guarantee is that replaying the
   log reconstructs the document.** Every update triggers `on_change` before it's acked or
   broadcast (record-before-distribute). If exactly-once updates matter for you, **you