noteloom 0.2.0 → 0.3.0

package/dist/style.css

@@ -116,6 +116,20 @@
   outline: none;
 }
 
+/* A run with marks.commentIds set (see src/comments/commentMarks.js) --
+   presence/absence only, no per-comment value to vary the color by.
+   cursor: pointer hints that it opens CommentPopover on click. */
+.be-comment-highlight {
+  background: rgba(234, 179, 8, 0.2);
+  border-bottom: 2px solid rgba(234, 179, 8, 0.6);
+  cursor: pointer;
+}
+
+/* Echoes a hover from the panel/popover back onto the actual text -- see useHoveredComment. */
+.be-comment-highlight-active {
+  background: rgba(234, 179, 8, 0.4);
+}
+
 /* --- basic leaf blocks --- */
 
 .be-paragraph {
@@ -1703,6 +1717,67 @@ tr.be-table-row:hover .be-table-delete-row {
   color: var(--noteloom-danger);
 }
 
+/* --- template picker (see TemplatePicker.jsx) --- */
+
+.be-template-picker {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+
+.be-template-picker-empty {
+  color: var(--noteloom-text-faint);
+  font-size: 0.88rem;
+}
+
+.be-template-card {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+  padding: 10px 12px;
+  border: 1px solid var(--noteloom-border);
+  border-radius: var(--noteloom-radius-md);
+  background: var(--noteloom-bg);
+}
+
+.be-template-card-body {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  min-width: 0;
+}
+
+.be-template-card-name {
+  font-weight: 600;
+  font-size: 0.92rem;
+  color: var(--noteloom-text);
+}
+
+.be-template-card-description {
+  font-size: 0.82rem;
+  color: var(--noteloom-text-muted);
+}
+
+.be-template-card-select {
+  flex: none;
+  border: 1px solid var(--noteloom-border);
+  background: var(--noteloom-bg-subtle);
+  color: var(--noteloom-text);
+  border-radius: var(--noteloom-radius-sm);
+  padding: 5px 12px;
+  font-size: 0.85rem;
+  font-weight: 500;
+  cursor: pointer;
+}
+
+.be-template-card-select:hover {
+  background: var(--noteloom-bg-hover);
+}
+
 /* --- mobile action bar (pinned above the on-screen keyboard) --- */
 
 .be-mobile-action-bar {
@@ -2375,6 +2450,323 @@ tr.be-table-row:hover .be-table-delete-row {
   color: var(--noteloom-text);
 }
 
+/* --- comments: avatar, header, composer, thread card, click/hover popover, right-side panel --- */
+
+.be-comment-avatar {
+  flex: none;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 50%;
+  color: #fff;
+  font-weight: 700;
+  line-height: 1;
+}
+
+/* Shared by CommentPopover and FloatingToolbar's standalone composer (see
+   CommentPopoverHeader.jsx) -- title on the left, an explicit close button
+   on the right so dismissing doesn't rely solely on Escape/outside-click. */
+.be-comment-popover-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+  margin-bottom: 10px;
+  padding-bottom: 10px;
+  border-bottom: 1px solid var(--noteloom-border);
+}
+
+.be-comment-popover-title {
+  font-weight: 700;
+  font-size: 0.9rem;
+}
+
+.be-comment-popover-close {
+  flex: none;
+  border: none;
+  background: transparent;
+  color: var(--noteloom-text-muted);
+  width: 22px;
+  height: 22px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: var(--noteloom-radius-sm);
+  cursor: pointer;
+}
+
+.be-comment-popover-close:hover {
+  background: var(--noteloom-bg-hover);
+  color: var(--noteloom-text);
+}
+
+/* Overrides the dark `.be-floating-toolbar` chrome it also carries (see
+   FloatingToolbar.jsx's own comment on why that base class stays) -- a
+   comment composer reads better as a light card than white text on the
+   toolbar's own near-black background. */
+.be-floating-toolbar.be-floating-toolbar-comment-standalone {
+  display: block;
+  background: var(--noteloom-bg);
+  border: 1px solid var(--noteloom-border);
+  padding: 10px 12px 12px;
+  width: 300px;
+}
+
+.be-comment-composer {
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+  margin-top: 10px;
+}
+
+.be-comment-composer-input-row {
+  display: flex;
+  align-items: flex-start;
+  gap: 8px;
+}
+
+.be-comment-composer-textarea {
+  flex: 1;
+  min-width: 0;
+  box-sizing: border-box;
+  resize: none;
+  /* ~2 lines to start, grows with content (see CommentComposer's own
+     resizeToContent) up to ~5 lines, then scrolls. */
+  min-height: 2.8em;
+  max-height: 7.2em;
+  overflow-y: auto;
+  padding: 8px 10px;
+  font: inherit;
+  font-size: 0.85rem;
+  line-height: 1.4;
+  color: var(--noteloom-text);
+  background: var(--noteloom-bg-subtle);
+  border: 1px solid var(--noteloom-border);
+  border-radius: var(--noteloom-radius-md);
+}
+
+.be-comment-composer-textarea:focus {
+  outline: none;
+  border-color: var(--noteloom-accent);
+}
+
+.be-comment-composer-actions {
+  display: flex;
+  justify-content: flex-end;
+  gap: 8px;
+}
+
+.be-comment-composer-cancel,
+.be-comment-composer-submit {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  border: none;
+  border-radius: var(--noteloom-radius-md);
+  padding: 6px 12px;
+  font-size: 0.8rem;
+  font-weight: 600;
+  cursor: pointer;
+}
+
+.be-comment-composer-cancel {
+  background: var(--noteloom-bg-hover);
+  color: var(--noteloom-text-muted);
+}
+
+.be-comment-composer-submit {
+  background: var(--noteloom-accent);
+  color: #fff;
+}
+
+.be-comment-composer-submit:disabled {
+  opacity: 0.4;
+  cursor: not-allowed;
+}
+
+.be-comment-thread {
+  font-size: 0.85rem;
+}
+
+.be-comment-thread + .be-comment-thread {
+  margin-top: 16px;
+  padding-top: 16px;
+  border-top: 1px solid var(--noteloom-border);
+}
+
+.be-comment-thread-resolved {
+  opacity: 0.6;
+}
+
+/* Echoes a hover from the highlighted text back onto this card -- see useHoveredComment. */
+.be-comment-thread-hovered {
+  background: var(--noteloom-bg-hover);
+  border-radius: var(--noteloom-radius-md);
+  margin: -6px;
+  padding: 6px;
+}
+
+.be-comment-message {
+  display: flex;
+  align-items: flex-start;
+  gap: 10px;
+}
+
+.be-comment-message + .be-comment-message {
+  margin-top: 10px;
+}
+
+.be-comment-message-body {
+  flex: 1;
+  min-width: 0;
+}
+
+.be-comment-message-header {
+  display: flex;
+  align-items: baseline;
+  gap: 6px;
+}
+
+.be-comment-message-author {
+  font-weight: 600;
+  font-size: 0.78rem;
+}
+
+.be-comment-message-time {
+  font-size: 0.72rem;
+  color: var(--noteloom-text-muted);
+}
+
+.be-comment-message-text {
+  margin: 3px 0 0;
+  line-height: 1.45;
+  white-space: pre-wrap;
+  word-break: break-word;
+}
+
+/* Replies (every message after the thread's first) get a connecting
+   vertical line + indent, chat-thread style -- our data model has no
+   deeper nesting than "root message + flat replies", so one indent level
+   is all this needs. */
+.be-comment-thread-replies {
+  margin: 10px 0 0 13px;
+  padding-left: 14px;
+  border-left: 2px solid var(--noteloom-border);
+}
+
+.be-comment-thread-actions {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  margin-top: 10px;
+  opacity: 0;
+  transition: opacity 0.1s ease;
+}
+
+.be-comment-thread:hover .be-comment-thread-actions,
+.be-comment-thread:focus-within .be-comment-thread-actions {
+  opacity: 1;
+}
+
+.be-comment-thread-actions button {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  border: none;
+  background: transparent;
+  color: var(--noteloom-text-muted);
+  font-size: 0.78rem;
+  padding: 4px 8px;
+  border-radius: var(--noteloom-radius-sm);
+  cursor: pointer;
+}
+
+.be-comment-thread-actions button:hover {
+  background: var(--noteloom-bg-hover);
+  color: var(--noteloom-text);
+}
+
+.be-comment-thread-delete {
+  margin-left: auto;
+}
+
+/* --- comments: click/hover popover over existing highlighted text --- */
+
+.be-comment-popover {
+  z-index: 1000;
+  width: 300px;
+  max-width: calc(100vw - 24px);
+  background: var(--noteloom-bg);
+  border: 1px solid var(--noteloom-border);
+  border-radius: var(--noteloom-radius-lg);
+  padding: 12px 14px 14px;
+  box-shadow: var(--noteloom-shadow);
+}
+
+/* --- comments: opt-in right-side panel (NoteloomEditor showCommentsPanel) --- */
+
+/* Deliberately no border/shadow/box background here, or on
+   .be-comments-panel-item below -- comments float directly on the page
+   like margin notes, not a boxed widget, matching how most other editors'
+   own comment sidebars read. */
+/* No overflow/scrolling of its own on purpose -- each card's position
+   already tracks the PAGE's scroll (see CommentsPanel's recompute()), so
+   the panel scrolling independently would fight that: a wheel gesture over
+   it needs to fall through and scroll the page, not the panel's own box,
+   or cards visually detach from the text they're anchored to. Cards whose
+   anchor has scrolled off-screen just go negative/beyond the viewport and
+   aren't painted -- no clipping box needed for that. */
+.be-comments-panel {
+  position: fixed;
+  top: 80px;
+  right: 24px;
+  width: 320px;
+  overflow: visible;
+  background: transparent;
+  padding: 0 12px;
+  font-size: 0.85rem;
+  z-index: 500;
+  pointer-events: none;
+}
+
+.be-comments-panel-item,
+.be-comments-panel-empty {
+  pointer-events: auto;
+}
+
+.be-comments-panel-empty {
+  color: var(--noteloom-text-muted);
+  font-size: 0.82rem;
+  margin: 0;
+}
+
+/* Each .be-comments-panel-item is absolutely positioned (top set inline by
+   CommentsPanel, aligned with its thread's own anchored text, margin-comment
+   style) inside this relatively-positioned container -- height is also set
+   inline, sized to fit the lowest card. */
+.be-comments-panel-list {
+  position: relative;
+}
+
+.be-comments-panel-item {
+  position: absolute;
+  left: 0;
+  right: 0;
+  padding: 8px 12px;
+  border-radius: var(--noteloom-radius-md);
+  transition: top 0.15s ease, background-color 0.1s ease;
+}
+
+.be-comments-panel-item:hover {
+  background: var(--noteloom-bg-hover);
+}
+
+@media (max-width: 900px) {
+  .be-comments-panel {
+    display: none;
+  }
+}
+
 /* --- voice typing: caret-anchored listening/processing indicator --- */
 
 .be-voice-indicator {
@@ -2458,6 +2850,8 @@ tr.be-table-row:hover .be-table-delete-row {
   #be-at-menu,
   .be-floating-toolbar,
   .be-link-hover-card,
+  .be-comment-popover,
+  .be-comments-panel,
   .be-voice-indicator,
   .be-table-header-menu-trigger,
   .be-table-header-menu,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "noteloom",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Zero-runtime-dependency, React-first block/rich-text editor — nestable content blocks, inline widgets, slash commands, undo/redo, clipboard, real-time collaborative editing (a custom CRDT over WebRTC), offline-first persistence (IndexedDB + PWA-ready), and live presence, with an optional default theme (noteloom/style.css).",
   "keywords": [
     "react",
@@ -57,11 +57,15 @@
     "dev:custom-block": "vite --config examples/02-custom-block/vite.config.js",
     "dev:custom-field-type": "vite --config examples/03-custom-field-type/vite.config.js",
     "dev:styling": "vite --config examples/04-styling/vite.config.js",
+    "dev:templates": "vite --config examples/05-templates/vite.config.js",
+    "dev:comments": "vite --config examples/06-comments/vite.config.js",
+    "dev:version-history": "vite --config examples/07-version-history/vite.config.js",
     "dev:collab": "vite --config examples/collab/vite.config.js",
     "dev:lan-collab": "vite --config examples/lan-collab/vite.config.js",
     "dev:offline-persist": "vite --config examples/offline-persist/vite.config.js",
     "build": "vite build && node -e \"require('fs').copyFileSync('src/style.css','dist/style.css');require('fs').copyFileSync('src/index.d.ts','dist/index.d.ts')\"",
     "test": "vitest run",
+    "test:e2e": "playwright test",
     "typecheck": "tsc",
     "prepublishOnly": "npm test && npm run typecheck && npm run build"
   },
@@ -70,6 +74,7 @@
     "react-dom": "^18.2.0 || ^19.0.0"
   },
   "devDependencies": {
+    "@playwright/test": "^1.62.0",
     "@testing-library/jest-dom": "^6.4.0",
     "@testing-library/react": "^16.0.0",
     "@types/react": "^18.3.0",