yrby 0.4.0-x86_64-linux → 0.5.0-x86_64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dbd0d24e57ba7484ef5a9853585483169aa6a9ca04df5edba0c7b5145daa20ae
-  data.tar.gz: 4e87999fa4474abc9c42b6281d92f52cdead13b9fb5e367a594c392b3eb52f93
+  metadata.gz: 231867b33dd1e931ddd90b1b8c6dc2ba1b57d2959038bf4bc5e3cf0c18e1974f
+  data.tar.gz: 28a227ff609a340c2ec9e52eac3ff5fa0a8853969fbf2aa0b1d3a93d9274f4ef
 SHA512:
-  metadata.gz: a538834a7854a3eed5bfa1e8d06b0ff85b03862b480e921f79caf43e8cc16b5437c9c5588b128170da8269c5f871409246b1fed8f3457420c2643e73b6a27422
-  data.tar.gz: 46f53542bfc7b2305ebdf20326c4546b875185494a9c13686b99d8858ac84b19ba27eea5e8eaf4a28680238d701e6f4c2737f66266129ad7dce9a630056c9d63
+  metadata.gz: f1410e692049f9c97a34cda63c174bbd9cf3a72061c1a43db121e1e15b72b9120663129e1bea81c188d65d9255df161b7b19c4c9b3f055960d93faf0baf68ee5
+  data.tar.gz: b1057a860265ce47641c11560a5c2eee9ce10acb676c161847484fb8247621288be44899cc95f86c2ccd49bbd8d5699858935e19a62791feff83c8e21eed91f6

data/CHANGELOG.md

@@ -6,6 +6,24 @@ 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

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"
@@ -177,8 +188,13 @@ guarantees keep serving safe:
 
 ### Rendering to HTML
 
-`Y::ProseMirror` renders a ProseMirror or Tiptap document to HTML on the
-server, with no Node process or headless editor:
+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)
@@ -187,8 +203,7 @@ 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. So you can render, search, or
-email a collaborative document without running a browser. It follows
+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`.
@@ -197,8 +212,29 @@ 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. A root that isn't ProseMirror — a Lexical document, say — returns
-`nil`.
+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)
 

data/lib/y/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Y
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: yrby
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: x86_64-linux
 authors:
 - JP Camara
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-07-08 00:00:00.000000000 Z
+date: 2026-07-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest