noteloom 0.1.7 → 0.3.0

package/dist/style.css

@@ -1,5 +1,5 @@
 /*
- * noteloom's default theme — minimal, clean, Notion/Linear-adjacent.
+ * noteloom's default theme — minimal, clean, modern SaaS-adjacent.
  *
  * Ships as plain CSS custom properties on :root (not scoped to a wrapper
  * element) deliberately: several of this package's own pieces — Select's
@@ -101,9 +101,35 @@
 }
 
 .be-editable {
+  /* Block-level and full-width so the whole line (including the blank
+     trailing space after short text, and an empty line's full height) is
+     part of the actual contentEditable hit-test box. Left inline/sized to
+     content, a click on that blank area lands on the non-editable wrapper
+     div instead of this element: the browser's native "nothing focused
+     yet" resolution still finds it on a first click, but re-clicking the
+     same dead-zone point while this element already holds the selection
+     collapses/clears it instead, since there's nothing here to re-anchor
+     the caret onto. */
+  display: block;
+  width: 100%;
+  min-height: 1em;
   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 {
@@ -797,7 +823,7 @@
 .be-canvas-toolbar-btn {
   border: none;
   background: transparent;
-  width: 26px;
+  width: 28px;
   height: 24px;
   display: flex;
   align-items: center;
@@ -1691,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 {
@@ -2183,8 +2270,8 @@ tr.be-table-row:hover .be-table-delete-row {
 }
 
 /* A mention chip always uses this one fixed color, not each option's own
-   tag color — matches Notion/Slack/GitHub's "@mentions are one consistent
-   color" convention rather than a per-person palette. */
+   tag color — "@mentions are one consistent color" is the common
+   convention rather than a per-person palette. */
 .be-select-tag-mention {
   background: var(--noteloom-accent-soft);
   color: var(--noteloom-accent);
@@ -2363,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 {
@@ -2446,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,7 +1,7 @@
 {
   "name": "noteloom",
-  "version": "0.1.7",
-  "description": "Zero-runtime-dependency, React-first block/rich-text editor — Notion-style blocks, inline widgets, slash commands, undo/redo, and clipboard, with an optional default theme (noteloom/style.css).",
+  "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",
     "editor",
@@ -9,8 +9,13 @@
     "block-editor",
     "wysiwyg",
     "contenteditable",
-    "notion",
-    "slash-commands"
+    "slash-commands",
+    "collaborative-editing",
+    "crdt",
+    "webrtc",
+    "offline-first",
+    "pwa",
+    "real-time"
   ],
   "license": "MIT",
   "author": "Nikhil Vishwakarma",
@@ -28,9 +33,11 @@
   ],
   "main": "./dist/noteloom.cjs",
   "module": "./dist/noteloom.es.js",
+  "types": "./dist/index.d.ts",
   "style": "./dist/style.css",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/noteloom.es.js",
       "require": "./dist/noteloom.cjs",
       "default": "./dist/noteloom.es.js"
@@ -46,22 +53,40 @@
   },
   "scripts": {
     "dev": "vite --config examples/basic/vite.config.js",
-    "build": "vite build && node -e \"require('fs').copyFileSync('src/style.css','dist/style.css')\"",
+    "dev:quickstart": "vite --config examples/01-quickstart/vite.config.js",
+    "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",
-    "prepublishOnly": "npm test && npm run build"
+    "test:e2e": "playwright test",
+    "typecheck": "tsc",
+    "prepublishOnly": "npm test && npm run typecheck && npm run build"
   },
   "peerDependencies": {
     "react": "^18.2.0 || ^19.0.0",
     "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",
+    "@types/react-dom": "^18.3.0",
     "@vitejs/plugin-react": "^4.3.0",
+    "fake-indexeddb": "^6.2.5",
     "jsdom": "^25.0.0",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
+    "typescript": "^5.6.0",
     "vite": "^5.4.0",
+    "vite-plugin-pwa": "^1.3.0",
     "vitest": "^2.1.0"
   }
 }