@echovisionlab/geul-common 0.2.0 → 0.2.2

package/README.md

@@ -26,6 +26,27 @@ pnpm package:smoke
 local changes, `typecheck:local-contracts` and `test:local-contracts` resolve it
 from the sibling `geul-event-contracts` checkout.
 
+## Block Room inline content
+
+Use `reconcileBlockRoomInlineContent` to set rich-text inline runs, including
+their marks. It keeps the existing collaborative `Y.Text` handles and projects
+character-level Y.Text attributes over the legacy per-run `styles` maps.
+Deploy readers of character-level inline attributes before enabling writers.
+The Web and Collab consumers use Block-room protocol version 2 to reject an
+older editor before admission; the persisted canonical protobuf schema stays
+unchanged.
+
+`setAIDocumentField` routes whole inline `content` updates through this same
+reconciler. `setBlockRoomAtomicValue` only writes catalog-declared scalar
+fields; there is no generic payload-field setter for inline styles.
+
+`replaceBlockRoomCollaborativeText` replaces the entire value of one
+collaborative text leaf. It is intended for scalar text fields such as Page
+section captions. On an inline text leaf, replacing the whole value also
+removes that leaf's character-level Y.Text formatting while leaving any legacy
+`styles` map in place. Use the inline reconciler when replacing inline text
+that must retain or change marks.
+
 ## Release
 
 Release Please creates releases from `main`. npm publication uses GitHub

package/package.json

@@ -2,7 +2,7 @@
   "name": "@echovisionlab/geul-common",
   "description": "Shared TypeScript contracts and helpers for Geul editors, collaboration, localized content, media blocks, pages, posts, and runtime events.",
   "author": "state303 <state303@dsub.io>",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "private": false,
   "type": "module",
   "repository": {

package/src/collaboration/block-room-codec/ai-document-field-mutations.ts

@@ -15,6 +15,11 @@ import type {
 import * as Y from "yjs";
 import { fromYValue, isCollaborativeTextPath, toYValue } from "./internal.ts";
 import { blockRoomBaseNodes } from "./materialization.ts";
+import { fromYInlineContent } from "./inline-content-projection.ts";
+import {
+  isBlockRoomInlineContentRef,
+  reconcileBlockRoomInlineContent,
+} from "./inline-content-mutations.ts";
 import {
   blockRoomLocaleValueRef,
   deleteBlockRoomLocalePresenceForBlocks,
@@ -166,6 +171,7 @@ function ensureYParent(node: Y.Map<unknown>, path: string): void {
 }
 
 function replaceYValue(
+  yDocument: Y.Doc,
   node: Y.Map<unknown>,
   ref: BlockRoomPayloadRef,
   value: JsonValue,
@@ -185,6 +191,15 @@ function replaceYValue(
     return;
   }
   if (current instanceof Y.Array && Array.isArray(value)) {
+    if (isBlockRoomInlineContentRef(ref)) {
+      reconcileBlockRoomInlineContent(
+        yDocument,
+        ref,
+        fromYInlineContent(current),
+        value,
+      );
+      return;
+    }
     if (current.length > 0) current.delete(0, current.length);
     if (value.length > 0) {
       current.insert(
@@ -301,6 +316,7 @@ function reconcileSourceTableLocale(yDocument: Y.Doc, blockId: string): void {
     };
   });
   replaceYValue(
+    yDocument,
     localeNode,
     { id: blockId, family: "rich_text", locale: true, path: "content" },
     { rows } as JsonValue,
@@ -346,6 +362,7 @@ function reconcileSourceImmersiveLocale(
     },
   );
   replaceYValue(
+    yDocument,
     localeNode,
     {
       id: blockId,
@@ -500,6 +517,7 @@ export function setAIDocumentField(
     operationFail("target_locale_scalar_required");
   }
   replaceYValue(
+    yDocument,
     node,
     ref,
     target.field === "table" ? sourceTableValue(next) : next,
@@ -541,7 +559,7 @@ export function attachAIDocumentFile(
   const target = blockTarget(targetValue);
   const { ref, descriptor } = fieldRef(yDocument, target, targetValue, true);
   if (descriptor?.type !== "file_attachment") operationFail("file:field");
-  replaceYValue(roomNode(yDocument, ref), ref, {
+  replaceYValue(yDocument, roomNode(yDocument, ref), ref, {
     activeFileId: requiredHandle(file, "file:handle"),
   });
 }