yrby 0.5.0 → 0.6.1

data/ext/yrby/target/debug/build/serde-58ea0ee887cc2602/out/private.rs

@@ -0,0 +1,6 @@
+#[doc(hidden)]
+pub mod __private228 {
+    #[doc(hidden)]
+    pub use crate::private::*;
+}
+use serde_core::__private228 as serde_core_private;

data/ext/yrby/target/debug/build/serde_core-41f407c21c1f205e/out/private.rs

@@ -0,0 +1,5 @@
+#[doc(hidden)]
+pub mod __private228 {
+    #[doc(hidden)]
+    pub use crate::private::*;
+}

data/ext/yrby/target/debug/build/thiserror-0f1416a82ff26f22/out/private.rs

@@ -0,0 +1,5 @@
+#[doc(hidden)]
+pub mod __private18 {
+    #[doc(hidden)]
+    pub use crate::private::*;
+}

data/lib/generators/yrby/install/install_generator.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+require "generators/yrby/tables/tables_generator"
+
+module Yrby
+  module Generators
+    # `bin/rails generate yrby:install` — a DocumentChannel speaking the
+    # y-websocket protocol over the gem's document storage, plus the storage
+    # migration (via yrby:tables). The models ship in the gem; only the
+    # migration lands in the app.
+    class InstallGenerator < ::Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+
+      def create_channel
+        template "document_channel.rb", "app/channels/document_channel.rb"
+      end
+
+      def create_tables
+        invoke "yrby:tables"
+      end
+
+      def show_next_steps
+        say <<~NEXT
+
+          Next steps:
+
+            1. Authorize document access: implement `authorized?` in
+               app/channels/document_channel.rb (it denies everyone until you do).
+            2. bin/rails db:migrate
+            3. Install the yrby-client npm package and connect an editor:
+
+                 import { ActionCableProvider } from "yrby-client"
+                 const provider = new ActionCableProvider(doc, consumer,
+                   "DocumentChannel", { id: documentId })
+                 provider.connect()
+
+          The README's Editors section links working integrations for
+          Tiptap, Lexxy, Rhino Editor, and CodeMirror.
+        NEXT
+      end
+    end
+  end
+end

data/lib/generators/yrby/install/templates/document_channel.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+# Collaborative documents over Action Cable: one channel speaking the
+# y-websocket protocol (sync plus presence). Storage is Y::Document +
+# Y::DocumentUpdate; a document is created on its first change and its
+# history goes with it when it is destroyed. Point on_load/on_change
+# elsewhere to swap storage.
+class DocumentChannel < ApplicationCable::Channel
+  include Y::ActionCable
+
+  # Rebuild a document from durable storage (nil means a brand-new document).
+  on_load { |key| Y::Document.load_state(key) }
+
+  # Record each CRDT delta durably. Runs before the change is acknowledged
+  # or broadcast; if this raises, the change is neither acked nor relayed,
+  # and yrby-client retries it.
+  on_change { |key, update| Y::Document.append(key, update) }
+
+  def subscribed
+    return reject unless authorized?(params[:id])
+
+    sync_subscribed(params[:id])
+  end
+
+  def receive(data) = sync_receive(data, params[:id])
+
+  private
+
+  # Everyone is denied until you fill this in. Wire it to your app's auth:
+  # identify current_user on the cable connection, then check they may read
+  # and write this document. Don't lean on on_change raising for access
+  # control — that path exists for store failures.
+  def authorized?(_document_key)
+    false
+  end
+end

data/lib/generators/yrby/tables/tables_generator.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+require "rails/generators/active_record"
+
+module Yrby
+  module Generators
+    # `bin/rails generate yrby:tables` — the migration for the gem-owned
+    # document models (Y::Document + Y::DocumentUpdate). Invoked by
+    # yrby:install, and by other gems building on the same storage.
+    #
+    # Template notes (kept here, not in the emitted migration): state is
+    # 4.gigabytes - 1 (longblob on MySQL — a compacted snapshot is the whole
+    # document; a 16 MB cap would break compaction) and payload is
+    # 16.megabytes - 1 (one update can carry a big paste or a client's
+    # accumulated offline edits — the 64 KB default blob is too small).
+    # The partial unique index's WHERE only keeps
+    # key-only rows out of the index: uniqueness holds without it, since
+    # unique indexes treat NULLs as distinct on every supported database,
+    # and MySQL drops the predicate harmlessly. y_document_updates indexes
+    # (document_id, pending) instead of bare document_id: the prefix
+    # serves the tail and foreign-key lookups, and the pair serves the
+    # clean-row count every append runs.
+    class TablesGenerator < ::Rails::Generators::Base
+      include ActiveRecord::Generators::Migration
+
+      source_root File.expand_path("templates", __dir__)
+
+      def create_migration_file
+        migration_template "create_y_tables.rb",
+                           File.join(db_migrate_path, "create_y_tables.rb")
+      end
+
+      private
+
+      def migration_version
+        "[#{ActiveRecord::VERSION::MAJOR}.#{ActiveRecord::VERSION::MINOR}]"
+      end
+    end
+  end
+end

data/lib/generators/yrby/tables/templates/create_y_tables.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+class CreateYTables < ActiveRecord::Migration<%= migration_version %>
+  def change
+    create_table :y_documents do |t|
+      t.string :key, null: false, index: { unique: true }
+      t.references :record, polymorphic: true, null: true, index: false
+      t.string :name
+      t.binary :state, limit: 4.gigabytes - 1
+      t.timestamps
+      t.index %i[record_type record_id name], unique: true,
+              where: "record_type IS NOT NULL",
+              name: "index_y_documents_on_record_and_name"
+    end
+
+    create_table :y_document_updates do |t|
+      t.references :document, null: false, foreign_key: { to_table: :y_documents }, index: false
+      t.binary :payload, null: false, limit: 16.megabytes - 1
+      t.boolean :pending, null: false, default: false
+      t.datetime :created_at, null: false
+      t.index %i[document_id pending]
+    end
+  end
+end

data/lib/y/lexxy.rb

@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+
+module Y
+  # The Lexxy renderer: Y::Lexical (core Lexical) plus the Lexxy-specific
+  # schema, applied beneath the app's rules — an app rule for one of these
+  # types simply replaces it. This is the byte-parity class: the fixture
+  # tests hold `Y::Lexxy.new(doc).to_html` identical to a live editor's own
+  # serialized value.
+  #
+  # The schema doubles as the reference for augmenting a renderer: simple
+  # nodes are declarative hashes, nodes with logic are plain methods mapped
+  # in NODES.
+  class Lexxy < Lexical
+    # A cursor-placement placeholder; empty ones export to nothing.
+    def self.provisional_paragraph(node)
+      node.content.empty? ? "" : "<p>#{node.content}</p>"
+    end
+
+    # Adjacent previewable images; the class carries the image count
+    # (ActionText's convention).
+    def self.gallery(node)
+      %(<div class="attachment-gallery attachment-gallery--#{node.child_types.length}">#{node.content}</div>)
+    end
+
+    # Lexxy wraps tables in a styled figure.
+    def self.table(node)
+      %(<figure class="lexxy-content__table-wrapper"><table><tbody>#{node.content}</tbody></table></figure>)
+    end
+
+    # Class + background match Lexxy's own header-cell export.
+    def self.table_cell(node)
+      header = node.attrs["__headerState"].is_a?(Numeric) && node.attrs["__headerState"].positive?
+      return "<td>#{node.content}</td>" unless header
+
+      style = %(style="background-color: rgb(242, 243, 245);")
+      %(<th class="lexxy-content__table-cell--header" #{style}>#{node.content}</th>)
+    end
+
+    # Attribute order follows Lexxy's export — checked items put aria-checked
+    # before value; items holding a nested list append the
+    # lexxy-nested-listitem class after value.
+    def self.list_item(node)
+      out = +"<li"
+      checked = node.attrs["__checked"]
+      out << %( aria-checked="#{checked}") unless checked.nil?
+      out << %( value="#{node.attrs["__value"] || 1}")
+      out << %( class="lexxy-nested-listitem") if node.child_types.include?("list")
+      "#{out}>#{node.content}</li>"
+    end
+
+    # An upload, in the exact shape ActionText round-trips: attribute order
+    # and presence mirror Lexxy's exportDOM (nulls omitted, `previewable`
+    # only when true, `presentation="gallery"` always).
+    def self.upload(node)
+      tag = attachment_tag(node)
+      out = "<#{tag}"
+      out << attachment_attr(node, "sgid", "sgid")
+      out << %( previewable="true") if node.attrs["previewable"] == true
+      [%w[url src], %w[alt altText], %w[caption caption],
+       %w[content-type contentType], %w[filename fileName],
+       %w[filesize fileSize], %w[width width], %w[height height]]
+        .each { |html_name, stored| out << attachment_attr(node, html_name, stored) }
+      %(#{out} presentation="gallery"></#{tag}>)
+    end
+
+    # A content attachment (mention, embed): `content` carries the escaped
+    # inner HTML; `plainText` is not exported.
+    def self.mention(node)
+      tag = attachment_tag(node)
+      out = "<#{tag}"
+      out << attachment_attr(node, "sgid", "sgid")
+      out << attachment_attr(node, "content", "innerHtml")
+      out << attachment_attr(node, "content-type", "contentType")
+      "#{out}></#{tag}>"
+    end
+
+    # Lexxy's attachment tag is configurable (`Lexxy.configure`'s
+    # attachmentTagName, paired with ActionText::Attachment.tag_name on the
+    # Rails side), and each attachment node stores the tag it was created
+    # with. Emit the stored tag. The value is stored document data, not
+    # markup, so anything that doesn't look like a tag name falls back to
+    # ActionText's default.
+    def self.attachment_tag(node)
+      tag = node.attrs["tagName"].to_s
+      tag.match?(/\A[a-zA-Z][a-zA-Z0-9-]*\z/) ? tag : "action-text-attachment"
+    end
+
+    # An in-flight upload placeholder. Only the uploader's browser can
+    # complete it, so it is never finished content -- materialized output
+    # (Action Text bodies, search text) must not carry it.
+    def self.pending_upload(_node)
+      ""
+    end
+
+    # A stored nil (unset) is skipped; a stored empty string still emits.
+    def self.attachment_attr(node, html_name, stored)
+      return "" if node.attrs[stored].nil?
+
+      %( #{html_name}="#{RenderRules.escape_attr(node.attrs[stored])}")
+    end
+
+    NODES = {
+      # Lexxy's replacement for Lexical's CodeNode.
+      "early_escape_code" => { tag: "pre", attrs: { "data-language" => :language } },
+      "horizontal_divider" => { tag: "hr", void: true },
+      "provisonal_paragraph" => method(:provisional_paragraph), # (sic: Lexxy's spelling)
+      "image_gallery" => method(:gallery),
+      "table" => { contains: :blocks, render: method(:table) },
+      "wrapped_table_node" => { contains: :blocks, render: method(:table) },
+      "tablecell" => { contains: :blocks, render: method(:table_cell) },
+      "listitem" => { contains: :blocks, render: method(:list_item) },
+      "action_text_attachment" => method(:upload),
+      "action_text_attachment_upload" => method(:pending_upload),
+      "custom_action_text_attachment" => method(:mention)
+    }.freeze
+
+    def initialize(doc, nodes: {}, &)
+      super(doc, nodes: NODES.merge(nodes.transform_keys(&:to_s)), &)
+    end
+  end
+end

data/lib/y/rendering.rb

@@ -0,0 +1,282 @@
+# frozen_string_literal: true
+
+require "json"
+
+module Y
+  # Custom render rules for Y::Lexical and Y::ProseMirror.
+  #
+  # Both renderers accept a `nodes:` hash mapping a node type (Lexical's
+  # `__type`, ProseMirror's node name) to a rule; Y::ProseMirror also accepts
+  # `marks:`. A rule is consulted before the built-in schema, so it can add a
+  # custom node or override a built-in one.
+  #
+  # The usual way in is the block form — one `rules.node` call per type,
+  # keyword options for markup-as-data, a Ruby block for logic (see Builder
+  # below). `contains:` says what's inside the node: :inline (formatted
+  # text, the default), :blocks (child block nodes), or :none (a leaf). The
+  # nodes:/marks: keywords take the same rules as plain hashes, for shipping
+  # rule sets as data.
+  #
+  # Two kinds of rule:
+  #
+  # - Declarative (keyword options / a Hash): markup as data, rendered
+  #   natively at full speed.
+  #     Y::ProseMirror.new(doc) do |rules|
+  #       rules.node "callout", tag: "aside",
+  #                             attrs: { "class" => ["callout callout--", :kind] },
+  #                             contains: :blocks
+  #     end
+  #   `tag` is the element; `attrs` values are templates — a String literal,
+  #   a Symbol referencing one of the node's stored attributes, or an Array
+  #   mixing both (an attribute that resolves empty is omitted); `text` is a
+  #   template for literal text content; `void: true` emits no closing tag;
+  #   `contains` declares what lives inside the node and renders there:
+  #   :inline (default) for formatted text, :blocks for child block nodes
+  #   (a container), :none for a leaf.
+  #
+  # - Callback (a block; in the hash form, a callable or `render:` plus
+  #   `contains`):
+  #     Y::Lexical.new(doc) do |rules|
+  #       rules.node "video_embed" do |node|
+  #         %(<video src="#{ERB::Util.html_escape(node.attrs["src"])}"></video>)
+  #       end
+  #     end
+  #   The block runs after the document read has finished (never while the
+  #   document is locked) and receives a RenderRules::Node with the node's
+  #   type, stored attributes, children already rendered to HTML, and
+  #   child_types (its element/block children by type). Its return value is
+  #   spliced in verbatim — it is trusted HTML, so escape any attribute
+  #   values you interpolate.
+  #
+  # Mark rules (ProseMirror only) are declarative: `tag` plus `attrs`
+  # templates whose Symbol refs resolve against the mark's own attributes. A
+  # custom mark wraps outside every built-in mark; several custom marks nest
+  # alphabetically. A rule for a built-in mark's stored name replaces its
+  # wrap (the markup changes, the semantics don't — an overridden code mark
+  # still excludes the other formatting).
+  module RenderRules
+    # What a callback receives. `attrs` keys are as stored (Lexical's own
+    # props keep their "__" prefix); `content` is the node's children,
+    # already rendered to an HTML string; `child_types` lists the node's
+    # element/block children by type, in document order — the structural
+    # facts attrs and content can't answer (a gallery's image count, whether
+    # a list item holds a nested list).
+    Node = Data.define(:type, :attrs, :content, :child_types)
+
+    module_function
+
+    # Compile the user-facing config into [rules_json, callbacks]. Structural
+    # validation happens in the native parser, which raises ArgumentError.
+    def compile(nodes, marks)
+      callbacks = {}
+      spec = {}
+      unless nodes.empty?
+        spec["nodes"] = nodes.to_h do |type, rule|
+          [type.to_s, compile_node(type.to_s, rule, callbacks)]
+        end
+      end
+      unless marks.empty?
+        spec["marks"] = marks.to_h do |name, rule|
+          [name.to_s, compile_mark(name.to_s, rule)]
+        end
+      end
+      [JSON.generate(spec), callbacks]
+    end
+
+    def compile_node(type, rule, callbacks)
+      if rule.respond_to?(:call)
+        callbacks[type] = rule
+        return { "callback" => true }
+      end
+      raise ArgumentError, "rule for #{type.inspect} must be a Hash or a callable" unless rule.is_a?(Hash)
+
+      if rule[:render]
+        callbacks[type] = rule[:render]
+        compiled = { "callback" => true }
+        compiled["content"] = rule[:contains].to_s if rule[:contains]
+        return compiled
+      end
+      compile_declarative_node(rule)
+    end
+
+    def compile_declarative_node(rule)
+      compiled = {}
+      compiled["tag"] = rule[:tag].to_s if rule[:tag]
+      compiled["void"] = true if rule[:void]
+      compiled["attrs"] = compile_attrs(rule[:attrs]) if rule[:attrs]
+      compiled["text"] = compile_parts(rule[:text]) if rule[:text]
+      compiled["content"] = rule[:contains].to_s if rule[:contains]
+      compiled
+    end
+
+    def compile_mark(name, rule)
+      raise ArgumentError, "mark rule for #{name.inspect} must be a Hash" unless rule.is_a?(Hash)
+
+      compiled = {}
+      compiled["tag"] = rule[:tag].to_s if rule[:tag]
+      compiled["attrs"] = compile_attrs(rule[:attrs]) if rule[:attrs]
+      compiled
+    end
+
+    def compile_attrs(attrs)
+      attrs.map { |name, template| [name.to_s, compile_parts(template)] }
+    end
+
+    # A template: String literal, Symbol attribute reference, or an Array of
+    # both.
+    def compile_parts(template)
+      Array(template).map do |part|
+        case part
+        when Symbol then { "ref" => part.to_s }
+        else { "lit" => part.to_s }
+        end
+      end
+    end
+
+    # The escaping the native renderers use, for blocks that build markup
+    # from stored values. Text content escapes `&`, `<`, `>` (quotes stay
+    # literal, matching the browser serializer); attribute values also
+    # escape `"`. Prefer these over ERB::Util.html_escape when byte parity
+    # with editor output matters — html_escape also rewrites apostrophes.
+    def escape_text(value)
+      value.to_s.gsub("&", "&amp;").gsub("<", "&lt;").gsub(">", "&gt;")
+    end
+
+    def escape_attr(value)
+      escape_text(value).gsub('"', "&quot;")
+    end
+
+    # Yielded by Y::Lexical.new / Y::ProseMirror.new: register rules one
+    # call per node type. Keyword options are the markup-as-data; a block is
+    # the logic; both together say what a callback node contains and how to
+    # render it:
+    #
+    #   Y::ProseMirror.new(doc) do |rules|
+    #     rules.node "callout", tag: "aside", contains: :blocks
+    #     rules.node "video" do |node|
+    #       %(<video src="#{RenderRules.escape_attr(node.attrs["src"])}"></video>)
+    #     end
+    #     rules.node "columns", contains: :blocks do |node|
+    #       %(<div class="cols--#{node.child_types.length}">#{node.content}</div>)
+    #     end
+    #     rules.mark "comment", tag: "span", attrs: { "data-comment-id" => :id }
+    #   end
+    #
+    # It compiles to the same rule hashes the nodes:/marks: keywords take, so
+    # both forms mean the same thing; the keywords remain the data form for
+    # shipping rule sets (Y::Lexxy::NODES is one).
+    class Builder
+      attr_reader :nodes, :marks
+
+      def initialize(marks_allowed:)
+        @nodes = {}
+        @marks = {}
+        @marks_allowed = marks_allowed
+      end
+
+      def node(type, **options, &block)
+        @nodes[type.to_s] =
+          if block && options.empty?
+            block
+          elsif block
+            options.merge(render: block)
+          else
+            options
+          end
+      end
+
+      def mark(name, **options)
+        raise ArgumentError, "marks are ProseMirror-only" unless @marks_allowed
+
+        @marks[name.to_s] = options
+      end
+    end
+
+    # Resolve callback segments depth-first, so a callback's `node.content`
+    # is finished HTML even when callback nodes nest.
+    def splice(segments, callbacks)
+      segments.map do |segment|
+        next segment if segment.is_a?(String)
+
+        type, attrs_json, content, child_types = segment
+        node = Node.new(type: type, attrs: JSON.parse(attrs_json),
+                        content: splice(content, callbacks),
+                        child_types: child_types)
+        callbacks.fetch(type).call(node).to_s
+      end.join
+    end
+  end
+
+  # Y::Lexical and Y::ProseMirror are plain Ruby facades over the native
+  # renderers (Y::NativeLexical / Y::NativeProseMirror, private constants):
+  # they compile the rules config, hold the callbacks, and splice deferred
+  # segments after a render. The native handle does everything else.
+  class Lexical
+    # `Y::Lexical.new(doc, nodes: { "type" => rule })` — see Y::RenderRules
+    # for the rule forms. This is core Lexical only: paragraphs, headings,
+    # quotes, code, lists, tables, links, text formatting. Editor-specific
+    # nodes arrive as rules — Y::Lexxy subclasses this with the Lexxy schema;
+    # a different Lexical editor brings its own rule set the same way.
+    def initialize(doc, nodes: {})
+      builder = RenderRules::Builder.new(marks_allowed: false)
+      yield builder if block_given?
+      nodes = nodes.transform_keys(&:to_s).merge(builder.nodes)
+      rules_json, @render_callbacks = RenderRules.compile(nodes, {})
+      @native = NativeLexical.new(doc, rules_json)
+    end
+
+    def to_html(root = nil)
+      result = root.nil? ? @native.to_html : @native.to_html(root)
+      return result unless result.is_a?(Array)
+
+      RenderRules.splice(result, @render_callbacks)
+    end
+
+    # What node types this document actually contains — the discovery aid
+    # for writing rules. Facts per type: "count", "attrs" (names as stored),
+    # "children" (child node types), "text" (whether it holds text runs),
+    # and "handled" ("builtin", "rule", or nil — nil marks the types you
+    # still need a rule for). Children plus text is how you pick contains:.
+    def node_types(root = nil)
+      json = root.nil? ? @native.node_types : @native.node_types(root)
+      json && JSON.parse(json)
+    end
+  end
+
+  class ProseMirror
+    # `Y::ProseMirror.new(doc, nodes: {...}, marks: {...})` — see
+    # Y::RenderRules for the rule forms. This is core ProseMirror only:
+    # prosemirror-schema-basic plus the prosemirror-tables family, and the
+    # full mark set (marks are native — see `rules.mark` for overrides).
+    # Editor-specific nodes arrive as rules — Y::Tiptap subclasses this with
+    # Tiptap's extension nodes; a different ProseMirror editor brings its
+    # own rule set the same way.
+    def initialize(doc, nodes: {}, marks: {})
+      builder = RenderRules::Builder.new(marks_allowed: true)
+      yield builder if block_given?
+      nodes = nodes.transform_keys(&:to_s).merge(builder.nodes)
+      marks = marks.transform_keys(&:to_s).merge(builder.marks)
+      rules_json, @render_callbacks = RenderRules.compile(nodes, marks)
+      @native = NativeProseMirror.new(doc, rules_json)
+    end
+
+    def to_html(root = nil)
+      result = root.nil? ? @native.to_html : @native.to_html(root)
+      return result unless result.is_a?(Array)
+
+      RenderRules.splice(result, @render_callbacks)
+    end
+
+    # What node types this document actually contains — the discovery aid
+    # for writing rules. Facts per type: "count", "attrs" (names as stored),
+    # "children" (child node types), "text" (whether it holds text runs),
+    # and "handled" ("builtin", "rule", or nil — nil marks the types you
+    # still need a rule for). Children plus text is how you pick contains:.
+    def node_types(root = nil)
+      json = root.nil? ? @native.node_types : @native.node_types(root)
+      json && JSON.parse(json)
+    end
+  end
+
+  private_constant :NativeLexical, :NativeProseMirror
+end

data/lib/y/tiptap.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module Y
+  # The Tiptap renderer: Y::ProseMirror (core ProseMirror — schema-basic plus
+  # tables) plus Tiptap's extension nodes, applied beneath the app's rules —
+  # an app rule for one of these types simply replaces it. This is the
+  # byte-parity class: the fixture tests hold `Y::Tiptap.new(doc).to_html`
+  # identical to a live editor's own `getHTML()`.
+  #
+  # Tiptap's marks (underline, highlight, sub/superscript, textStyle) render
+  # natively in the base class — mark serialization is text-run machinery
+  # the rule system can't express.
+  class Tiptap < ProseMirror
+    # Tiptap's TaskItem markup: the data-checked flag (false when unset), a
+    # label wrapping the checkbox, and the item body in a div.
+    def self.task_item(node)
+      checked = node.attrs["checked"] == true
+      out = %(<li data-checked="#{checked}" data-type="taskItem">)
+      out << %(<label><input type="checkbox")
+      out << %( checked="checked") if checked
+      out << "><span></span></label><div>"
+      "#{out}#{node.content}</div></li>"
+    end
+
+    # Tiptap's Mention extension (no app-configured HTMLAttributes): data
+    # attributes when present, the suggestion char, and @label (falling back
+    # to @id) as the text.
+    def self.mention(node)
+      char = node.attrs["mentionSuggestionChar"] || "@"
+      out = +%(<span data-type="mention")
+      %w[id label].each do |key|
+        next if node.attrs[key].nil?
+
+        out << %( data-#{key}="#{RenderRules.escape_attr(node.attrs[key])}")
+      end
+      out << %( data-mention-suggestion-char="#{RenderRules.escape_attr(char)}">)
+      out << RenderRules.escape_text(char)
+      out << RenderRules.escape_text(node.attrs["label"] || node.attrs["id"] || "")
+      "#{out}</span>"
+    end
+
+    # The details family follows tiptap-php's renderHTML (the Tiptap
+    # extension is Pro-only, so there's no free getHTML() to capture
+    # against).
+    def self.details(node)
+      open = node.attrs["open"] == true ? %( open="open") : ""
+      "<details#{open}>#{node.content}</details>"
+    end
+
+    NODES = {
+      "taskList" => { tag: "ul", attrs: { "data-type" => "taskList" }, contains: :blocks },
+      "taskItem" => { contains: :blocks, render: method(:task_item) },
+      "mention" => method(:mention),
+      "details" => { contains: :blocks, render: method(:details) },
+      "detailsSummary" => { tag: "summary" },
+      "detailsContent" => { tag: "div", attrs: { "data-type" => "detailsContent" }, contains: :blocks }
+    }.freeze
+
+    def initialize(doc, nodes: {}, marks: {}, &)
+      super(doc, nodes: NODES.merge(nodes.transform_keys(&:to_s)), marks: marks, &)
+    end
+  end
+end

data/lib/y/version.rb

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

data/lib/y.rb

@@ -12,6 +12,10 @@ rescue LoadError
   require_relative "y/yrby"
 end
 
+require_relative "y/rendering"
+require_relative "y/lexxy"
+require_relative "y/tiptap"
+
 module Y
   # Doc, Error, and the protocol module functions are defined in the Rust
   # extension. The ActionCable integration (Y::ActionCable::Sync) lives in the