playbook_ui_docs 16.5.0.pre.alpha.RTEPOC15708 → 16.5.0.pre.alpha.RTEPOC15745

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: daff262ba133222972d6f4a3d191b66ffbb68f8f7035c49b4bb393828fda24e9
-  data.tar.gz: da983e08af6c23c5151eaf5187ff7dd464b564622257b1166c91991e220d4109
+  metadata.gz: b680606f9f3ed780d8f6cfca6a6c4ef57267d1dc8e4b18b923e67a5c1f86d8ad
+  data.tar.gz: 98a92b7126b1bfa2b04316b6836e7f17bf2a9c3d282c79879eb57700446edc06
 SHA512:
-  metadata.gz: 4d4744a5e9e088fd7faa1259777de7b6878a6e2e23a1baa1387e44c09d6449bf2be5eb0aa217b7fc2885aed2062c4921033c284e69b23208182c166c7b77eae4
-  data.tar.gz: 5abeb66df5a5feb0df207bc7628e422418e1d7c9b5fb89abc41cf869863f40a9666c647b8644dd706dc5910a98df06922714d80fa52cde4d1bf852d914b8c671
+  metadata.gz: f1d1fbf9a14177f5bcb5c8cde50cd367c5513e5edee903099209d12e67db35c32316dafc704efb02f77b22077d9210cf2c33f543a8eeb4b7f4bba56a8fe6f05b
+  data.tar.gz: 05ca9daf1d853329382dfcd528dd58168c4f955fbc41079407e5497a53ec2d62cab2a583a1c4b608257d355d78c911fc0e9b6aca8f9f245f4f0489f313026fca

data/app/pb_kits/playbook/pb_rich_text_editor/docs/_rich_text_editor_rails_default.md

@@ -1 +1,12 @@
-TipTap (vanilla JS) — the Playbook **Rails** rich text editor. No React; same editor core as the React TipTap variant. Content is synced to a hidden input for Rails form submission. Use `pb_rails("rich_text_editor", props: { input_options: { id: "...", name: "..." }, value: "..." })`.
+The Rails rich text editor is a TipTap surface with no React. The UI (toolbar, block-style menu, formatting actions) is rendered with Playbook Rails kits (`pb_rails`). The editor document is a vanilla TipTap `Editor` instance; HTML is synced to a hidden `<input>` so standard Rails forms can submit the value.
+
+### How TipTap is loaded (Rails)
+
+- The kit ships an `importmap` in the ERB template that maps `@tiptap/*` and ProseMirror packages to ES module URLs on a CDN (see `rich_text_editor.html.erb`). A small `type="module"` script `import()`s `@tiptap/core`, `@tiptap/starter-kit`, `@tiptap/extension-link`, and related modules at runtime.
+- You do not need to add TipTap to your app’s npm dependencies or Gemfile for this kit to work out of the box—the browser loads those modules from the CDN when the page runs.
+- Your app must support import maps and ES modules in the browser (modern browsers; ensure CSP allows the CDN if you lock scripts down).
+
+### Relation to the React implementation
+
+- Same core: both use TipTap v2 on top of ProseMirror; styling lives in Playbook SCSS (`_tiptap_styles.scss`) so the editor chrome lines up between platforms.
+- Different shell: Rails uses ERB + Playbook Rails components + inline module script. React uses `RichTextEditor` / `_tiptap_editor.tsx` and TipTap wired through the bundled Playbook React package—see Advanced Default for that stack and when you need TipTap installed in your JavaScript bundle.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: playbook_ui_docs
 version: !ruby/object:Gem::Version
-  version: 16.5.0.pre.alpha.RTEPOC15708
+  version: 16.5.0.pre.alpha.RTEPOC15745
 platform: ruby
 authors:
 - Power UX
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-13 00:00:00.000000000 Z
+date: 2026-04-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: playbook_ui