docblocks-core 0.1.2 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # docblocks-core
 
+## 0.2.0
+
+### Minor Changes
+
+- 0791efb: The `embed` block gains the persisted view attrs: the optional `zoom`
+  (the scale factor, positive) and `panX` / `panY` (the pan offsets, px).
+  Absent or `null` stand the identity view (the attrs' null idiom — the
+  values are never removed, `null` = the view cleared). The reader stands
+  the unknown attrs over the older data (absent = the identity); the
+  validator stands the finite-number / positive-zoom rules over the
+  strict's path.
+- 48ef4fb: The `embed` block's height stands the stretchable stand: the
+  `--docblocks-embed-height` token (300 px) is the default — the minimum,
+  and the block's bottom edge stands the resize handle (the hover reveal's
+  grip bar, the `cursor-row-resize`'s stand, the keyboard's arrows over
+  the 16 px's step — the slider's aria). The drag stretches the wrapper's
+  height over the gesture (the live's stand), and the rest's commit stands
+  the block's new `height` attr (px; absent or `null` = the token's
+  default — the null idiom's stand, so the reload restores the stretched
+  stand and the panes share it over the wire). The stretch only stands
+  over the minimum (the drag over it clamps, the clear stands the `null`'s
+  write); the read-only's stand gates the handle off.
+
+## 0.1.3
+
+### Patch Changes
+
+- 5971d30: `PresenceState` now passes through the awareness payload's sharing
+  contract fields — the consumer user identity (`userId` / `name`), the
+  opaque ciphertext selection entries (`selections`), and the publication
+  counter (`seq`). The ws-provider mapper validates them defensively; a
+  legacy frame keeps its pre-sharing shape.
+
 ## 0.1.2
 
 ### Patch Changes

package/dist/index.d.mts

@@ -283,6 +283,21 @@ interface EmbedAttrs {
   src: string;
   /** Accessible title; falls back to the kind in the renderer. */
   title?: string;
+  /**
+   * The persisted zoom (the scale factor; 1 = 100%). Absent or `null` = the
+   * identity (the null idiom — attrs are never removed).
+   */
+  zoom?: number | null;
+  /** The persisted horizontal pan offset (px); absent or `null` = 0. */
+  panX?: number | null;
+  /** The persisted vertical pan offset (px); absent or `null` = 0. */
+  panY?: number | null;
+  /**
+   * The persisted height (px; the block's stretched stand). Absent or
+   * `null` = the default (the `--docblocks-embed-height` token's stand —
+   * the minimum; the resize only stretches over it).
+   */
+  height?: number | null;
   /** Nesting depth in the page sequence (default 0). */
   indent?: PageIndent;
 }
@@ -1287,6 +1302,27 @@ interface PresenceState {
   selection: PresenceSelection | null;
   /** Unix milliseconds. Staleness handling (TTL) is a consumer concern. */
   updatedAt: number;
+  /**
+   * Consumer-provided stable user identity (optional; absent on legacy
+   * peers). `peerId` is the anonymous transport-level identifier —
+   * `userId` is the only addressable identity.
+   */
+  userId?: string;
+  /** Consumer-provided roster display label (optional). */
+  name?: string;
+  /**
+   * Opaque ciphertext selection entries (optional): one per share
+   * target, no target id inside the entry — the recipient tries each
+   * entry with its own decryptor. Absent when the peer shares with
+   * everyone (plaintext `selection`) or not at all.
+   */
+  selections?: string[];
+  /**
+   * Monotonic per-publisher selection publication counter (optional):
+   * the recipient discards a decrypted selection whose `seq` is older
+   * than the last accepted one for the peer (the async decrypt race).
+   */
+  seq?: number;
 }
 /**
  * Transport for syncing one document with peers.

package/dist/index.mjs

@@ -710,7 +710,17 @@ const BLOCK_REGISTRY = {
 				nonEmpty: true,
 				required: true
 			},
-			title: { kind: "string" }
+			title: { kind: "string" },
+			zoom: {
+				kind: "nullable-number",
+				positive: true
+			},
+			panX: { kind: "nullable-number" },
+			panY: { kind: "nullable-number" },
+			height: {
+				kind: "nullable-number",
+				positive: true
+			}
 		}
 	},
 	"sync-embed": {
@@ -6255,6 +6265,18 @@ function parseSelection(value) {
 	if (isStringArray(sel.blocks)) return { blocks: [...sel.blocks] };
 	return null;
 }
+/** The sharing-contract presence extras (identity, ciphertext entries, the
+*  publication counter): defensive validation, absent for legacy peers. */
+function parsePresenceExtras(value) {
+	if (typeof value !== "object" || value === null) return {};
+	const state = value;
+	const extras = {};
+	if (typeof state.userId === "string") extras.userId = state.userId;
+	if (typeof state.name === "string") extras.name = state.name;
+	if (isStringArray(state.selections)) extras.selections = [...state.selections];
+	if (typeof state.seq === "number") extras.seq = state.seq;
+	return extras;
+}
 /** The default socket factory: the global WebSocket, normalized to WsLike. */
 const defaultWebSocketImpl = (url) => {
 	const ws = new WebSocket(url);
@@ -6591,7 +6613,8 @@ var WsSyncProvider = class {
 			peers.push({
 				peerId: String(clientID),
 				selection: parseSelection(state.selection),
-				updatedAt: typeof state.updatedAt === "number" ? state.updatedAt : 0
+				updatedAt: typeof state.updatedAt === "number" ? state.updatedAt : 0,
+				...parsePresenceExtras(state)
 			});
 		});
 		return peers;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docblocks-core",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Headless CRDT document engine: schema v1, Doc (commands/transactions/undo), sync providers. Yjs-based, zero UI dependencies.",
   "type": "module",
   "license": "MIT",