From 53c725d3b2e2994ba4f037b54d3b365aa141add0 Mon Sep 17 00:00:00 2001
From: robonen <robonenandrew@gmail.com>
Date: Mon, 8 Jun 2026 21:02:30 +0700
Subject: [PATCH 1/2] docs(editor): richer playground (drag, multiplayer, live
 output) + drop contenteditable outline
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Reworks the editor playground into a tabbed showcase:
- Rich text & blocks: drag-to-reorder handles, bubble/slash menus, and a live output panel (block/word counts, selection readout, document JSON).
- Multiplayer: two CRDT replicas synced over an in-memory channel with remote cursors, an in-sync indicator, and a Connected/Offline toggle that demonstrates divergence → convergence.
Also removes the focus outline on the contenteditable (outline: none on the editable surface).
---
 vue/editor/docs/01-playground.vue | 372 ++++++++++++++++++++----------
 1 file changed, 253 insertions(+), 119 deletions(-)

diff --git a/vue/editor/docs/01-playground.vue b/vue/editor/docs/01-playground.vue
index 8272aed..6943eea 100644
--- a/vue/editor/docs/01-playground.vue
+++ b/vue/editor/docs/01-playground.vue
@@ -1,16 +1,19 @@
 <!-- title: Playground -->
 <!-- order: 1 -->
 <script setup lang="ts">
-import { computed, onBeforeUnmount, ref } from 'vue';
-import type { Inline, InlineNode, Node } from '../src';
+import { computed, onBeforeUnmount, ref, watch } from 'vue';
+import type { EditorDocument, Inline, InlineNode, Node, RemoteCursor } from '../src';
 import {
+  bindCrdt,
   createDefaultRegistry,
   createDoc,
   createEditor,
   createEditorState,
+  createNativeProvider,
   createNode,
   EditorBubbleMenu,
   EditorContent,
+  EditorRemoteCursors,
   EditorRoot,
   EditorSlashMenu,
   isBlockActive,
@@ -20,7 +23,7 @@ import {
   toggleMark,
 } from '../src';
 
-// ── Tiny content helpers (same shape as the playground's lib) ────────────────
+// ── Content helpers ──────────────────────────────────────────────────────────
 function t(text: string, ...markTypes: string[]): InlineNode {
   return { text, marks: markTypes.map(type => ({ type })) };
 }
@@ -37,11 +40,29 @@ const numbered = (text: string): Node => createNode('numbered-list', { attrs: {
 const todo = (text: string, checked = false): Node => createNode('todo-list', { attrs: { checked, indent: 0 }, content: [t(text)] });
 const divider = (): Node => createNode('divider');
 
-// The editor controller is pure model/state (no DOM) — safe to build during SSR;
-// only EditorRoot below touches the DOM, and it's wrapped in <ClientOnly>.
+/** Visible text of a document (for word count / convergence check). */
+function docText(doc: EditorDocument): string {
+  return doc.content
+    .map((block) => {
+      const c = block.content as unknown;
+      return Array.isArray(c) ? c.map(run => (run && typeof run === 'object' && 'text' in run ? String((run as InlineNode).text) : '')).join('') : '';
+    })
+    .join('\n');
+}
+
+// ── Tabs ───────────────────────────────────────────────────────────────────
+const tabs = [
+  { id: 'editor', label: 'Rich text & blocks' },
+  { id: 'collab', label: 'Multiplayer' },
+] as const;
+const tab = ref<'editor' | 'collab'>('editor');
+
+const registry = createDefaultRegistry();
+
+// ── Tab 1: the rich editor (drag-to-reorder + live output) ───────────────────
 const editor = createEditor({
   state: createEditorState({
-    registry: createDefaultRegistry(),
+    registry,
     doc: createDoc([
       heading(1, 'Try the editor'),
       p([
@@ -49,7 +70,7 @@ const editor = createEditor({
         t('bold', 'bold'), t(', '), t('italic', 'italic'), t(', '), t('code', 'code'),
         t(' and '), t('highlight', 'highlight'), t('.'),
       ]),
-      p('Select any text to reveal the bubble menu, or type “/” on an empty line to insert a block.'),
+      p('Hover a block and drag the ⠿ handle on its left to reorder. Select text for the bubble menu, or type “/” on an empty line for the block menu.'),
       heading(2, 'Blocks'),
       bullet('Bulleted lists'),
       numbered('Numbered lists'),
@@ -63,7 +84,6 @@ const editor = createEditor({
   }),
 });
 
-// Re-derive toolbar active-states on every transaction.
 const rev = ref(0);
 const bump = (): void => void (rev.value += 1);
 editor.on('transaction', bump);
@@ -78,6 +98,82 @@ const h2Active = computed(() => (rev.value, isBlockActive(editor.state, 'heading
 const quoteActive = computed(() => (rev.value, isBlockActive(editor.state, 'blockquote')));
 const canUndo = computed(() => (rev.value, editor.canUndo()));
 const canRedo = computed(() => (rev.value, editor.canRedo()));
+
+// Live output
+const showJson = ref(false);
+const blockCount = computed(() => (rev.value, editor.state.doc.content.length));
+const wordCount = computed(() => (rev.value, docText(editor.state.doc).trim().split(/\s+/).filter(Boolean).length));
+const sid = (id: string): string => id.slice(0, 4);
+const selectionSummary = computed(() => {
+  void rev.value;
+  const s = editor.state.selection;
+  if (s.kind === 'text')
+    return `text · ${sid(s.anchor.blockId)}:${s.anchor.offset} → ${sid(s.focus.blockId)}:${s.focus.offset}`;
+  return `node · ${s.ids.length} block${s.ids.length === 1 ? '' : 's'}`;
+});
+const docJson = computed(() => (rev.value, JSON.stringify(editor.state.doc, null, 2)));
+
+// ── Tab 2: two CRDT replicas, synced in memory (multiplayer) ─────────────────
+const seed = createDoc([
+  heading(1, 'Shared document'),
+  p('Edit in either pane — each is its own @robonen/crdt replica. Concurrent edits converge and you see the other cursor.'),
+  p(''),
+]);
+
+const editorA = createEditor({ state: createEditorState({ registry, doc: seed }) });
+const providerA = createNativeProvider({ schema: registry.schema, doc: editorA.state.doc, user: { name: 'Alice', color: '#2563eb' } });
+
+const editorB = createEditor({ state: createEditorState({ registry }) });
+const providerB = createNativeProvider({ schema: registry.schema, user: { name: 'Bob', color: '#db2777' } });
+
+const bindingA = bindCrdt(editorA, providerA);
+const bindingB = bindCrdt(editorB, providerB);
+providerB.applyUpdate(providerA.encodeDelta());
+
+// In-memory transport with a "Connected" switch: while offline, ops queue and
+// the docs diverge; reconnecting flushes them and they converge.
+const connected = ref(true);
+let queueAB: Uint8Array[] = [];
+let queueBA: Uint8Array[] = [];
+
+const offOpsA = providerA.onLocalOps((bytes) => {
+  if (connected.value) providerB.applyUpdate(bytes);
+  else queueAB.push(bytes);
+});
+const offOpsB = providerB.onLocalOps((bytes) => {
+  if (connected.value) providerA.applyUpdate(bytes);
+  else queueBA.push(bytes);
+});
+
+watch(connected, (on) => {
+  if (!on) return;
+  for (const b of queueAB) providerB.applyUpdate(b);
+  for (const b of queueBA) providerA.applyUpdate(b);
+  queueAB = [];
+  queueBA = [];
+});
+
+const cursorsA = ref<RemoteCursor[]>([]);
+const cursorsB = ref<RemoteCursor[]>([]);
+const offCurA = providerA.onAwareness(c => (cursorsA.value = c));
+const offCurB = providerB.onAwareness(c => (cursorsB.value = c));
+const offAwA = providerA.onLocalAwareness(bytes => connected.value && providerB.applyAwareness(bytes));
+const offAwB = providerB.onLocalAwareness(bytes => connected.value && providerA.applyAwareness(bytes));
+
+const collabRev = ref(0);
+const bumpCollab = (): void => void (collabRev.value += 1);
+editorA.on('transaction', bumpCollab);
+editorB.on('transaction', bumpCollab);
+
+const inSync = computed(() => (collabRev.value, docText(editorA.state.doc) === docText(editorB.state.doc)));
+
+onBeforeUnmount(() => {
+  for (const off of [offOpsA, offOpsB, offCurA, offCurB, offAwA, offAwB]) off();
+  editorA.off('transaction', bumpCollab);
+  editorB.off('transaction', bumpCollab);
+  bindingA.detach();
+  bindingB.detach();
+});
 </script>
 
 <template>
@@ -85,21 +181,30 @@ const canRedo = computed(() => (rev.value, editor.canRedo()));
     <div class="prose-docs">
       <h1>Playground</h1>
       <p>
-        A live <code>@robonen/editor</code> instance built with the default registry. Everything
-        below is the real editor — the same headless controller, single-contenteditable view, and
-        CRDT-backed model documented in the API reference.
-      </p>
-      <h2>Try it</h2>
-      <p>
-        Edit the document directly. <strong>Select text</strong> to format it with the bubble menu,
-        or type <kbd>/</kbd> on an empty line to open the block menu. <kbd>Enter</kbd> splits a block,
-        <kbd>Backspace</kbd> at the start merges into the previous one, and
-        <kbd>⌘/Ctrl</kbd>+<kbd>Z</kbd> undoes.
+        Live <code>@robonen/editor</code> instances built with the default registry — the real
+        headless controller, single-contenteditable view, and CRDT-backed model from the API
+        reference. Switch tabs to explore the capabilities.
       </p>
     </div>
 
+    <!-- Tabs -->
+    <div class="ed-tabs" role="tablist">
+      <button
+        v-for="tb in tabs"
+        :key="tb.id"
+        type="button"
+        role="tab"
+        :aria-selected="tab === tb.id"
+        :class="['ed-tab', { 'ed-tab-active': tab === tb.id }]"
+        @click="tab = tb.id"
+      >
+        {{ tb.label }}
+      </button>
+    </div>
+
     <ClientOnly>
-      <div class="editor-demo">
+      <!-- ── Rich text & blocks ───────────────────────────────────────────── -->
+      <div v-show="tab === 'editor'" class="editor-demo">
         <div class="editor-demo-toolbar">
           <button type="button" title="Bold" :data-active="boldActive || undefined" @mousedown.prevent="editor.command(toggleMark('bold'))"><b>B</b></button>
           <button type="button" title="Italic" :data-active="italicActive || undefined" @mousedown.prevent="editor.command(toggleMark('italic'))"><i>I</i></button>
@@ -114,15 +219,65 @@ const canRedo = computed(() => (rev.value, editor.canRedo()));
           <button type="button" title="Undo" :disabled="!canUndo" @mousedown.prevent="editor.undo()">↺</button>
           <button type="button" title="Redo" :disabled="!canRedo" @mousedown.prevent="editor.redo()">↻</button>
         </div>
-        <EditorRoot :editor="editor" class="editor-demo-root">
+
+        <EditorRoot :editor="editor" draggable class="editor-demo-root">
           <EditorContent />
           <EditorBubbleMenu />
           <EditorSlashMenu />
         </EditorRoot>
+
+        <!-- Live output -->
+        <div class="ed-output">
+          <div class="ed-stats">
+            <span><b>{{ blockCount }}</b> blocks</span>
+            <span><b>{{ wordCount }}</b> words</span>
+            <span class="ed-sel">selection: <code>{{ selectionSummary }}</code></span>
+            <button type="button" class="ed-json-toggle" @click="showJson = !showJson">
+              {{ showJson ? 'Hide' : 'Show' }} document JSON
+            </button>
+          </div>
+          <pre v-if="showJson" class="ed-json">{{ docJson }}</pre>
+        </div>
+      </div>
+
+      <!-- ── Multiplayer ──────────────────────────────────────────────────── -->
+      <div v-show="tab === 'collab'" class="editor-demo">
+        <div class="ed-collab-bar">
+          <span class="ed-peer"><span class="ed-dot" style="background:#2563eb" />Alice</span>
+          <span class="ed-peer"><span class="ed-dot" style="background:#db2777" />Bob</span>
+          <span class="ed-spacer" />
+          <span :class="['ed-sync', inSync ? 'ed-sync-ok' : 'ed-sync-pending']">
+            {{ inSync ? 'in sync' : 'diverged' }}
+          </span>
+          <button type="button" :class="['ed-conn', connected ? 'ed-conn-on' : 'ed-conn-off']" @click="connected = !connected">
+            {{ connected ? 'Connected' : 'Offline' }}
+          </button>
+        </div>
+
+        <div class="ed-collab-grid">
+          <EditorRoot :editor="editorA" draggable class="editor-demo-root collab">
+            <EditorContent />
+            <EditorRemoteCursors :cursors="cursorsA" />
+            <EditorBubbleMenu />
+            <EditorSlashMenu />
+          </EditorRoot>
+          <EditorRoot :editor="editorB" draggable class="editor-demo-root collab">
+            <EditorContent />
+            <EditorRemoteCursors :cursors="cursorsB" />
+            <EditorBubbleMenu />
+            <EditorSlashMenu />
+          </EditorRoot>
+        </div>
+
+        <p class="ed-hint">
+          Each pane is a separate CRDT replica synced over an in-memory channel. Toggle
+          <b>Offline</b>, edit both sides so they diverge, then reconnect — the replicas
+          converge automatically (no Yjs).
+        </p>
       </div>
 
       <template #fallback>
-        <div class="flex min-h-60 items-center justify-center gap-2 rounded-xl border border-(--border) bg-(--bg-subtle) text-sm text-(--fg-subtle)">
+        <div class="flex min-h-72 items-center justify-center gap-2 rounded-xl border border-(--border) bg-(--bg-subtle) text-sm text-(--fg-subtle)">
           <svg class="animate-spin" xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
             <path d="M21 12a9 9 0 1 1-6.219-8.56" />
           </svg>
@@ -135,31 +290,32 @@ const canRedo = computed(() => (rev.value, editor.canRedo()));
       <h2>How it's wired</h2>
       <p>
         The editor is created from a registry and a document, then rendered with a single
-        <code>EditorRoot</code> over one contenteditable host — the toolbar above just dispatches
-        the same commands you'd call programmatically.
+        <code>EditorRoot</code>. Multiplayer is just two editors, each bound to its own CRDT
+        replica with <code>bindCrdt</code>, exchanging ops over any transport.
       </p>
     </div>
     <DocsCode
       lang="ts"
       :code="`import {
-  EditorRoot, EditorContent, EditorBubbleMenu, EditorSlashMenu,
+  EditorRoot, EditorContent, EditorRemoteCursors,
   createDefaultRegistry, createDoc, createEditor, createEditorState,
-  toggleMark, toggleBlockType,
+  createNativeProvider, bindCrdt,
 } from '@robonen/editor';
 
-const editor = createEditor({
-  state: createEditorState({ registry: createDefaultRegistry(), doc: createDoc(blocks) }),
-});
+const registry = createDefaultRegistry();
+const editor = createEditor({ state: createEditorState({ registry, doc: createDoc(blocks) }) });
 
-// Commands are plain values you run on the editor:
-editor.command(toggleMark('bold'));
-editor.command(toggleBlockType('heading', { level: 1 }));`"
+// Collaboration: bind the editor to a CRDT replica and pipe ops to peers.
+const provider = createNativeProvider({ schema: registry.schema, user: { name: 'Alice' } });
+bindCrdt(editor, provider);
+provider.onLocalOps(bytes => socket.send(bytes));   // any transport
+socket.onmessage = bytes => provider.applyUpdate(bytes);`"
     />
 
     <div class="prose-docs">
       <p>
         See <NuxtLink to="/editor/create-editor">createEditor</NuxtLink>,
-        <NuxtLink to="/editor/create-default-registry">createDefaultRegistry</NuxtLink> and
+        <NuxtLink to="/editor/bind-crdt">bindCrdt</NuxtLink> and
         <NuxtLink to="/editor/toggle-mark">toggleMark</NuxtLink> in the API reference for the full surface.
       </p>
     </div>
@@ -167,59 +323,34 @@ editor.command(toggleBlockType('heading', { level: 1 }));`"
 </template>
 
 <style>
-/* Unscoped on purpose: the editor renders its own DOM (and teleports the menus
-   to <body>), so scoped styles can't reach them. All selectors are namespaced
-   under `.editor-demo*` / the editor's own menu classes to avoid leaking. */
+/* Unscoped on purpose: the editor renders its own DOM (and teleports menus to
+   <body>), so scoped styles can't reach them. Selectors are namespaced under
+   `.editor-demo*`, `.ed-*` and the editor's own classes to avoid leaking. */
 .editor-demo { counter-reset: editor-demo-ol; }
 
-.editor-demo-toolbar {
-  display: flex;
-  flex-wrap: wrap;
-  gap: 4px;
-  align-items: center;
-  padding: 6px;
-  border: 1px solid var(--border);
-  border-bottom: 0;
-  border-radius: 12px 12px 0 0;
-  background: var(--bg-subtle);
-}
-.editor-demo-toolbar button {
-  display: inline-flex;
-  align-items: center;
-  justify-content: center;
-  min-width: 32px;
-  height: 30px;
-  padding: 0 9px;
-  border: 1px solid var(--border);
-  background: var(--bg-elevated);
-  color: var(--fg);
-  border-radius: 7px;
-  cursor: pointer;
-  font-size: 13px;
-  line-height: 1;
-  transition: background 0.12s, border-color 0.12s;
-}
+/* tabs */
+.ed-tabs { display: flex; gap: 4px; margin-bottom: 0.75rem; }
+.ed-tab { padding: 6px 12px; border: 1px solid var(--border); background: var(--bg-elevated); color: var(--fg-muted); border-radius: 8px; cursor: pointer; font-size: 13px; font-weight: 500; transition: background 0.12s, color 0.12s, border-color 0.12s; }
+.ed-tab:hover { background: var(--bg-inset); color: var(--fg); }
+.ed-tab-active { background: var(--accent); color: var(--accent-fg); border-color: transparent; }
+
+/* toolbar */
+.editor-demo-toolbar { display: flex; flex-wrap: wrap; gap: 4px; align-items: center; padding: 6px; border: 1px solid var(--border); border-bottom: 0; border-radius: 12px 12px 0 0; background: var(--bg-subtle); }
+.editor-demo-toolbar button { display: inline-flex; align-items: center; justify-content: center; min-width: 32px; height: 30px; padding: 0 9px; border: 1px solid var(--border); background: var(--bg-elevated); color: var(--fg); border-radius: 7px; cursor: pointer; font-size: 13px; line-height: 1; transition: background 0.12s, border-color 0.12s; }
 .editor-demo-toolbar button code { font-family: var(--font-mono, ui-monospace, monospace); font-size: 12px; }
 .editor-demo-toolbar button:hover { border-color: var(--border-strong); background: var(--bg-inset); }
 .editor-demo-toolbar button:disabled { opacity: 0.4; cursor: not-allowed; }
 .editor-demo-toolbar button[data-active] { background: var(--accent); color: var(--accent-fg); border-color: transparent; }
 .editor-demo-toolbar .sep { width: 1px; height: 18px; background: var(--border); margin: 0 4px; }
 
-.editor-demo-root {
-  border: 1px solid var(--border);
-  border-radius: 0 0 12px 12px;
-  padding: 1rem 1.25rem;
-  min-height: 260px;
-  background: var(--bg);
-  color: var(--fg);
-  outline: none;
-}
+/* editable surface */
+.editor-demo-root { border: 1px solid var(--border); border-radius: 0 0 12px 12px; padding: 1rem 1.25rem 1rem 2rem; min-height: 280px; background: var(--bg); color: var(--fg); }
+.editor-demo-root, .editor-demo-root [data-editor-content] { outline: none; }
 .editor-demo-root:focus-within { border-color: var(--accent); }
 
+.editor-demo-root [data-block-id] { position: relative; }
 .editor-demo-root [data-block-content] { outline: none; margin: 0.45em 0; line-height: 1.7; }
-.editor-demo-root h1[data-block-content],
-.editor-demo-root h2[data-block-content],
-.editor-demo-root h3[data-block-content] { margin: 0.7em 0 0.3em; line-height: 1.3; font-weight: 700; letter-spacing: -0.01em; }
+.editor-demo-root h1[data-block-content], .editor-demo-root h2[data-block-content], .editor-demo-root h3[data-block-content] { margin: 0.7em 0 0.3em; line-height: 1.3; font-weight: 700; letter-spacing: -0.01em; }
 .editor-demo-root h1[data-block-content] { font-size: 1.6rem; }
 .editor-demo-root h2[data-block-content] { font-size: 1.3rem; }
 .editor-demo-root h3[data-block-content] { font-size: 1.1rem; }
@@ -229,29 +360,13 @@ editor.command(toggleBlockType('heading', { level: 1 }));`"
 .editor-demo-root [data-block-content] strong { font-weight: 700; }
 .editor-demo-root [data-block-content] em { font-style: italic; }
 .editor-demo-root [data-block-content] u { text-decoration: underline; }
-.editor-demo-root [data-block-content] s,
-.editor-demo-root [data-block-content] del { text-decoration: line-through; }
+.editor-demo-root [data-block-content] s, .editor-demo-root [data-block-content] del { text-decoration: line-through; }
 .editor-demo-root [data-block-content] mark { background: rgba(245, 200, 66, 0.4); color: inherit; border-radius: 2px; padding: 0 0.1em; }
-.editor-demo-root [data-block-content] code {
-  background: var(--bg-inset);
-  border: 1px solid var(--border);
-  padding: 0.05em 0.35em;
-  border-radius: 4px;
-  font-family: var(--font-mono, ui-monospace, monospace);
-  font-size: 0.9em;
-}
+.editor-demo-root [data-block-content] code { background: var(--bg-inset); border: 1px solid var(--border); padding: 0.05em 0.35em; border-radius: 4px; font-family: var(--font-mono, ui-monospace, monospace); font-size: 0.9em; }
 .editor-demo-root [data-block-content] a { color: var(--accent-text); text-decoration: underline; cursor: pointer; }
 
 .editor-demo-root blockquote[data-block-content] { border-left: 3px solid var(--border-strong); padding-left: 1rem; color: var(--fg-muted); font-style: italic; }
-.editor-demo-root pre[data-block-content] {
-  background: var(--bg-inset);
-  border: 1px solid var(--border);
-  border-radius: 8px;
-  padding: 0.75rem 1rem;
-  font-family: var(--font-mono, ui-monospace, monospace);
-  font-size: 0.85rem;
-  white-space: pre-wrap;
-}
+.editor-demo-root pre[data-block-content] { background: var(--bg-inset); border: 1px solid var(--border); border-radius: 8px; padding: 0.75rem 1rem; font-family: var(--font-mono, ui-monospace, monospace); font-size: 0.85rem; white-space: pre-wrap; }
 
 /* callouts */
 .editor-demo-root [data-callout] { position: relative; border-radius: 8px; margin: 0.5em 0; padding: 0.6rem 0.8rem 0.6rem 2.4rem; border: 1px solid var(--border); background: var(--bg-subtle); }
@@ -260,7 +375,7 @@ editor.command(toggleBlockType('heading', { level: 1 }));`"
 .editor-demo-root [data-callout='warn']::before { content: '⚠️'; }
 .editor-demo-root [data-callout='success']::before { content: '✅'; }
 
-/* lists (flat with marker in the gutter) */
+/* lists */
 .editor-demo-root [data-list] { position: relative; padding-left: 1.6em; }
 .editor-demo-root [data-list]::before { position: absolute; left: 0.35em; color: var(--fg-muted); }
 .editor-demo-root [data-list='bullet']::before { content: '•'; }
@@ -272,37 +387,56 @@ editor.command(toggleBlockType('heading', { level: 1 }));`"
 
 .editor-demo-root [data-editor-divider] { border: 0; border-top: 2px solid var(--border); margin: 1em 0; }
 
-/* selection highlight */
+/* selection */
 .editor-demo-root ::selection { background: var(--accent-subtle); }
-.editor-demo-root [data-block-content][data-selected],
-.editor-demo-root [data-block-id][data-selected] { background: var(--accent-subtle); border-radius: 4px; }
+.editor-demo-root [data-block-content][data-selected], .editor-demo-root [data-block-id][data-selected] { background: var(--accent-subtle); border-radius: 4px; }
 
-/* floating menus (teleported to <body>) — editor-namespaced classes */
-.editor-bubble-menu {
-  display: flex;
-  gap: 2px;
-  background: var(--bg-elevated);
-  border: 1px solid var(--border-strong);
-  border-radius: 8px;
-  padding: 4px;
-  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.18);
-  z-index: 60;
-}
+/* drag-to-reorder handle */
+.editor-demo-root .editor-drag-handle { position: absolute; left: -1.4em; top: 0.2em; cursor: grab; color: var(--fg-subtle); user-select: none; opacity: 0; transition: opacity 0.1s; line-height: 1.4; }
+.editor-demo-root [data-block-id]:hover > .editor-drag-handle { opacity: 1; }
+.editor-demo-root .editor-drag-handle:hover { color: var(--fg-muted); }
+.editor-demo-root .editor-drag-handle:active { cursor: grabbing; }
+
+/* output panel */
+.ed-output { margin-top: 0.75rem; }
+.ed-stats { display: flex; flex-wrap: wrap; align-items: center; gap: 0.5rem 1rem; font-size: 13px; color: var(--fg-muted); }
+.ed-stats b { color: var(--fg); font-variant-numeric: tabular-nums; }
+.ed-stats code { font-family: var(--font-mono, ui-monospace, monospace); font-size: 12px; color: var(--accent-text); }
+.ed-sel { min-width: 0; }
+.ed-json-toggle { margin-left: auto; border: 1px solid var(--border); background: var(--bg-elevated); color: var(--fg-muted); border-radius: 7px; padding: 4px 10px; font-size: 12px; cursor: pointer; transition: background 0.12s, color 0.12s; }
+.ed-json-toggle:hover { background: var(--bg-inset); color: var(--fg); }
+.ed-json { margin-top: 0.6rem; max-height: 320px; overflow: auto; background: var(--bg-inset); border: 1px solid var(--border); border-radius: 10px; padding: 0.9rem 1rem; font-family: var(--font-mono, ui-monospace, monospace); font-size: 12px; line-height: 1.6; color: var(--fg-muted); white-space: pre; }
+
+/* multiplayer */
+.ed-collab-bar { display: flex; align-items: center; gap: 0.75rem; flex-wrap: wrap; margin-bottom: 0.6rem; font-size: 13px; }
+.ed-peer { display: inline-flex; align-items: center; gap: 6px; color: var(--fg-muted); font-weight: 500; }
+.ed-dot { width: 9px; height: 9px; border-radius: 50%; display: inline-block; }
+.ed-spacer { flex: 1; }
+.ed-sync { font-size: 12px; font-weight: 600; border-radius: 999px; padding: 2px 10px; }
+.ed-sync-ok { color: var(--accent-text); background: var(--accent-subtle); }
+.ed-sync-pending { color: #b45309; background: rgba(245, 158, 11, 0.15); }
+.ed-conn { border: 1px solid var(--border); border-radius: 8px; padding: 4px 12px; font-size: 12px; font-weight: 600; cursor: pointer; transition: background 0.12s, color 0.12s, border-color 0.12s; }
+.ed-conn-on { background: var(--accent); color: var(--accent-fg); border-color: transparent; }
+.ed-conn-off { background: var(--bg-elevated); color: var(--fg-muted); }
+.ed-collab-grid { display: grid; grid-template-columns: 1fr; gap: 0.75rem; }
+@media (min-width: 720px) { .ed-collab-grid { grid-template-columns: 1fr 1fr; } }
+.ed-collab-grid .editor-demo-root { border-radius: 12px; min-height: 200px; }
+.editor-demo-root.collab { position: relative; }
+.ed-hint { margin-top: 0.6rem; font-size: 13px; color: var(--fg-subtle); }
+
+/* remote cursors (component sets --cursor-color per peer) */
+.editor-remote-cursors { position: absolute; inset: 0; pointer-events: none; overflow: visible; z-index: 4; }
+.editor-remote-selection { position: absolute; background: var(--cursor-color); opacity: 0.22; border-radius: 2px; }
+.editor-remote-caret { position: absolute; width: 2px; background: var(--cursor-color); }
+.editor-remote-caret-label { position: absolute; top: -1.05em; left: -1px; font-size: 10px; line-height: 1; white-space: nowrap; color: #fff; background: var(--cursor-color); padding: 1px 4px; border-radius: 3px 3px 3px 0; }
+
+/* floating menus (teleported to <body>) */
+.editor-bubble-menu { display: flex; gap: 2px; background: var(--bg-elevated); border: 1px solid var(--border-strong); border-radius: 8px; padding: 4px; box-shadow: 0 8px 24px rgba(0, 0, 0, 0.18); z-index: 60; }
 .editor-bubble-menu button { min-width: 30px; height: 28px; padding: 0 8px; border: 0; background: transparent; color: var(--fg-muted); border-radius: 5px; cursor: pointer; font-size: 13px; text-transform: capitalize; }
 .editor-bubble-menu button:hover { background: var(--bg-inset); color: var(--fg); }
 .editor-bubble-menu button[data-active] { background: var(--accent); color: var(--accent-fg); }
 
-.editor-slash-menu {
-  background: var(--bg-elevated);
-  border: 1px solid var(--border);
-  border-radius: 10px;
-  padding: 4px;
-  box-shadow: 0 12px 32px rgba(0, 0, 0, 0.16);
-  width: 240px;
-  max-height: 300px;
-  overflow: auto;
-  z-index: 60;
-}
+.editor-slash-menu { background: var(--bg-elevated); border: 1px solid var(--border); border-radius: 10px; padding: 4px; box-shadow: 0 12px 32px rgba(0, 0, 0, 0.16); width: 240px; max-height: 300px; overflow: auto; z-index: 60; }
 .editor-slash-menu button { display: flex; justify-content: space-between; align-items: baseline; width: 100%; text-align: left; border: 0; background: transparent; padding: 7px 10px; border-radius: 7px; cursor: pointer; font-size: 14px; color: var(--fg); }
 .editor-slash-menu button[data-highlighted] { background: var(--bg-inset); }
 .editor-slash-menu .slash-group { font-size: 11px; color: var(--fg-subtle); text-transform: capitalize; }

From 6de7c72fb3965677b46c5a4cf067133038e53ef2 Mon Sep 17 00:00:00 2001
From: robonen <robonenandrew@gmail.com>
Date: Mon, 8 Jun 2026 21:11:53 +0700
Subject: [PATCH 2/2] fix(docs): shorten TMPDIR on macOS so the dev server's
 vite-node socket fits
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Nuxt's dev vite-node IPC uses a unix socket under $TMPDIR. macOS's default /var/folders/… tmp dir pushes the path to ~110 chars, past the ~104-char sun_path limit, so every request 500s with 'connect EINVAL'. Point $TMPDIR at /tmp on darwin (guarded; other platforms untouched) before the builder generates the socket path.
---
 docs/nuxt.config.ts | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/nuxt.config.ts b/docs/nuxt.config.ts
index 9223646..79a3ea3 100644
--- a/docs/nuxt.config.ts
+++ b/docs/nuxt.config.ts
@@ -1,5 +1,13 @@
+import { tmpdir } from 'node:os';
 import tailwindcss from '@tailwindcss/vite';
 
+// macOS dev fix: Nuxt's vite-node IPC uses a unix socket under $TMPDIR, and the
+// default macOS temp dir (/var/folders/…) pushes the socket path past the
+// ~104-char sun_path limit → `connect EINVAL` on every request. Point $TMPDIR
+// at a short directory so `nuxt dev` works. Other platforms are unaffected.
+if (process.platform === 'darwin' && tmpdir().length > 30)
+  process.env.TMPDIR = '/tmp';
+
 export default defineNuxtConfig({
   future: {
     compatibilityVersion: 4,