@ai-matrx/rich-editor 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.3.2
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/rich-editor/v0.3.1..npm/rich-editor/v0.3.2 -- apps/shared/rich-editor`).
+No source changes intended and no consumer action required.
+
+## 0.3.1
+### A block goes above only from the very start of its paragraph (G15, 2026-10-07)
+
+- `blockSide` / `nearestSide` / `blockSideOfSelection` (`"nearest"`): a caret at offset 0 of a non-empty block → BEFORE it; anywhere else → AFTER. The 0.3.0 "first half → before" rule counted characters, so a right-click 89% along the first visual line of a wrapped paragraph put the block above it.
+
+Consumer action: none; hosts already pass `"nearest"`.
+
 ## 0.3.0
 ### A block lands on the side of the click; a trailing space stays typed (G11B, 2026-10-07)
 
@@ -125,3 +138,4 @@ approval, host value, block insert, shortcuts), `in-place/{in-place-session,care
 
 - matrx-frontend: import `@ai-matrx/rich-editor/core/<module>` instead of `@/components/rich-editor/core/<module>`.
 
+

package/dist/core/block-insert.d.ts

@@ -22,10 +22,10 @@ import { type BlockPlacement } from "./text-insertion.js";
 /** The top-level boundary a block goes to, relative to [from, to]. */
 export declare function blockInsertPosition(doc: PMNode, from: number, to: number, where: "before" | "after"): number;
 /**
- * The side of its block a selection is nearer to (`blockSide`): a collapsed
- * caret at the start or in the first half of a textblock → "before"; anything
- * else — the second half, the end, an empty block, a selected chip, ⌘A,
- * a position between blocks — → "after".
+ * The side of its block a selection belongs on (`blockSide`): a collapsed
+ * caret at the very start of a textblock → "before"; anything else — the
+ * middle, the end, an empty block, a selected chip, ⌘A, a position between
+ * blocks — → "after".
  */
 export declare function blockSideOfSelection(doc: PMNode, from: number, to: number): "before" | "after";
 /**

package/dist/core/text-insertion.d.ts

@@ -14,16 +14,17 @@ export declare function insertTextByRef(textareaRef: HTMLTextAreaElement | null,
 export declare function blockBoundary(text: string, from: number, to: number, where?: BlockPlacement): number;
 /**
  * Where a block goes relative to the caret's block: `before` it, `after` it, or
- * `nearest` — the side the click was closer to.
+ * `nearest` — before it from the very start of the block, after it otherwise.
  */
 export type BlockPlacement = "before" | "after" | "nearest";
 /**
- * 🚨 A BLOCK LANDS ON THE SIDE OF THE CLICK (G11B review, 2026-10-07: every
- * reference and button went AFTER its paragraph, even from a right-click at the
- * start of a line). A matrx fence is block-level, so it can never sit
- * mid-sentence — but a caret at the START of its block, or in its first half,
- * puts the block BEFORE that block; anywhere else (the middle, the second half,
- * the end, an empty block) puts it AFTER. `offset` is the caret's place inside
+ * 🚨 A BLOCK GOES ABOVE ONLY FROM THE VERY START OF ITS BLOCK. A matrx fence is
+ * block-level, so it never sits mid-sentence: a caret at offset 0 of a
+ * non-empty block (a right-click left of its first character lands there too)
+ * puts the block BEFORE it; anywhere else (the middle, the end, an empty block)
+ * puts it AFTER. The old "first half → before" rule measured characters, so a
+ * right-click at 89% along the first visual line of a wrapped paragraph put the
+ * block ABOVE it (G15 review, 2026-10-07). `offset` is the caret's place inside
  * its block, `length` the block's size. ONE rule for the visual editor, the
  * source view and every plain-text field.
  */

package/dist/core/text-insertion.js

@@ -51,7 +51,7 @@ function blockBoundary(text, from, to, where = "after") {
 }
 function blockSide(offset, length) {
   if (length <= 0) return "after";
-  return offset * 2 < length ? "before" : "after";
+  return offset <= 0 ? "before" : "after";
 }
 function nearestSide(text, from, to) {
   if (from !== to) return "after";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/rich-editor",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "The AI Matrx editor: Visual (Tiptap), Source (CodeMirror), Preview, the markdown formatting command layer, and edit-in-place — over @ai-matrx/rich-content. Consumers that only render never install it.",
   "type": "module",
   "license": "MIT",
@@ -93,9 +93,9 @@
     "@ai-matrx/agents": "latest",
     "@ai-matrx/alchemy": "latest",
     "@ai-matrx/content-ir": "latest",
-    "@ai-matrx/design-system": "latest",
     "@ai-matrx/kit": "latest",
     "@ai-matrx/print": "latest",
+    "@ai-matrx/design-system": "latest",
     "@ai-matrx/rich-content": "latest"
   },
   "peerDependencies": {