@portabletext/plugin-sdk-value 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2016 - 2025 Sanity.io
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,58 @@
+# SDK Value Plugin
+
+> 🔗 Connects a Portable Text Editor with a Sanity document using the SDK
+
+The SDK Value plugin provides seamless two-way synchronization between a Portable Text Editor instance and a specific field in a Sanity document. This enables real-time collaboration and ensures that changes made through the editor are immediately reflected in the document, and vice versa.
+
+## Features
+
+- **Two-way synchronization**: Changes in the editor update the document, and document changes update the editor
+- **Real-time updates**: Automatically handles patches from external sources (other users, mutations, etc.)
+- **Optimistic updates**: Provides smooth user experience with immediate local updates
+
+## Usage
+
+Import the `SDKValuePlugin` React component and place it inside the `EditorProvider`. The plugin requires document handle properties and a path to specify which field to synchronize:
+
+```tsx
+import {
+  defineSchema,
+  EditorProvider,
+  PortableTextEditable,
+} from '@portabletext/editor'
+import {SDKValuePlugin} from '@portabletext/plugin-sdk-value'
+
+function MyEditor() {
+  return (
+    <EditorProvider initialConfig={{schemaDefinition: defineSchema({})}}>
+      <PortableTextEditable />
+      <SDKValuePlugin
+        documentId="my-document-id"
+        documentType="myDocumentType"
+        path="content"
+      />
+    </EditorProvider>
+  )
+}
+```
+
+## Props
+
+The `SDKValuePlugin` component accepts a [Document Handle](https://www.sanity.io/docs/app-sdk/document-handles) plus an additional `path` parameter:
+
+| Prop           | Type                | Description                                                        |
+| -------------- | ------------------- | ------------------------------------------------------------------ |
+| `documentId`   | `string`            | The document ID                                                    |
+| `documentType` | `string`            | The document type                                                  |
+| `path`         | `string`            | [JSONMatch][json-match] path expression to the Portable Text field |
+| `dataset`      | `string` (optional) | Dataset name (if different from configured default)                |
+| `projectId`    | `string` (optional) | Project ID (if different from configured default)                  |
+
+[json-match]: https://www.sanity.io/docs/content-lake/json-match
+
+## Requirements
+
+This plugin requires:
+
+- `@sanity/sdk-react` for document state management
+- The document must exist in the Sanity dataset

package/dist/index.cjs

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: !0 });
+var compilerRuntime = require("react/compiler-runtime"), editor = require("@portabletext/editor"), diffPatch = require("@sanity/diff-patch"), jsonMatch = require("@sanity/json-match"), sdkReact = require("@sanity/sdk-react"), react = require("react");
+const ARRAYIFY_ERROR_MESSAGE = "Unexpected path format from diffValue output. Please report this issue.";
+function* getSegments(node) {
+  node.base && (yield* getSegments(node.base)), node.segment.type !== "This" && (yield node.segment);
+}
+function isKeyPath(node) {
+  return node.type !== "Path" || node.base || node.recursive || node.segment.type !== "Identifier" ? !1 : node.segment.name === "_key";
+}
+function arrayifyPath(pathExpr) {
+  const node = jsonMatch.parsePath(pathExpr);
+  if (!node) return [];
+  if (node.type !== "Path") throw new Error(ARRAYIFY_ERROR_MESSAGE);
+  return Array.from(getSegments(node)).map((segment) => {
+    if (segment.type === "Identifier") return segment.name;
+    if (segment.type !== "Subscript") throw new Error(ARRAYIFY_ERROR_MESSAGE);
+    if (segment.elements.length !== 1) throw new Error(ARRAYIFY_ERROR_MESSAGE);
+    const [element] = segment.elements;
+    if (element.type === "Number") return element.value;
+    if (element.type !== "Comparison") throw new Error(ARRAYIFY_ERROR_MESSAGE);
+    if (element.operator !== "==") throw new Error(ARRAYIFY_ERROR_MESSAGE);
+    const keyPathNode = [element.left, element.right].find(isKeyPath);
+    if (!keyPathNode) throw new Error(ARRAYIFY_ERROR_MESSAGE);
+    const other = element.left === keyPathNode ? element.right : element.left;
+    if (other.type !== "String") throw new Error(ARRAYIFY_ERROR_MESSAGE);
+    return {
+      _key: other.value
+    };
+  });
+}
+function convertPatches(patches) {
+  return patches.flatMap((p) => Object.entries(p).flatMap(([type, values]) => {
+    const origin = "remote";
+    switch (type) {
+      case "set":
+      case "setIfMissing":
+      case "diffMatchPatch":
+      case "inc":
+      case "dec":
+        return Object.entries(values).map(([pathExpr, value]) => ({
+          type,
+          value,
+          origin,
+          path: arrayifyPath(pathExpr)
+        }));
+      case "unset":
+        return Array.isArray(values) ? values.map(arrayifyPath).map((path) => ({
+          type,
+          origin,
+          path
+        })) : [];
+      case "insert": {
+        const {
+          items,
+          ...rest
+        } = values, position = Object.keys(rest).at(0);
+        if (!position) return [];
+        const pathExpr = rest[position];
+        return [{
+          type,
+          origin,
+          position,
+          path: arrayifyPath(pathExpr),
+          items
+        }];
+      }
+      default:
+        return [];
+    }
+  }));
+}
+function SDKValuePlugin(props) {
+  const $ = compilerRuntime.c(6), setSdkValue = sdkReact.useEditDocument(props), instance = sdkReact.useSanityInstance(props), editor$1 = editor.useEditor();
+  let t0, t1;
+  return $[0] !== editor$1 || $[1] !== instance || $[2] !== props || $[3] !== setSdkValue ? (t0 = () => {
+    const getEditorValue = () => editor$1.getSnapshot().context.value, {
+      getCurrent: getSdkValue,
+      subscribe: onSdkValueChange
+    } = sdkReact.getDocumentState(instance, props), editorSubscription = editor$1.on("patch", () => setSdkValue(getEditorValue())), unsubscribeToEditorChanges = () => editorSubscription.unsubscribe(), unsubscribeToSdkChanges = onSdkValueChange(() => {
+      const snapshot = getEditorValue(), patches = convertPatches(diffPatch.diffValue(snapshot, getSdkValue()));
+      patches.length && editor$1.send({
+        type: "patches",
+        patches,
+        snapshot
+      });
+    });
+    return editor$1.send({
+      type: "update value",
+      value: getSdkValue() ?? []
+    }), () => {
+      unsubscribeToEditorChanges(), unsubscribeToSdkChanges();
+    };
+  }, t1 = [setSdkValue, editor$1, instance, props], $[0] = editor$1, $[1] = instance, $[2] = props, $[3] = setSdkValue, $[4] = t0, $[5] = t1) : (t0 = $[4], t1 = $[5]), react.useEffect(t0, t1), null;
+}
+exports.SDKValuePlugin = SDKValuePlugin;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/plugin.sdk-value.tsx"],"sourcesContent":["import {\n  useEditor,\n  type PortableTextBlock,\n  type Patch as PtePatch,\n} from '@portabletext/editor'\nimport type {\n  JSONValue,\n  Path,\n  PathSegment,\n  InsertPatch as PteInsertPatch,\n} from '@portabletext/patches'\nimport {diffValue, type SanityPatchOperations} from '@sanity/diff-patch'\nimport {\n  parsePath,\n  type ExprNode,\n  type PathNode,\n  type SegmentNode,\n  type ThisNode,\n} from '@sanity/json-match'\nimport {\n  getDocumentState,\n  useEditDocument,\n  useSanityInstance,\n  type DocumentHandle,\n} from '@sanity/sdk-react'\nimport {useEffect} from 'react'\n\ninterface SDKValuePluginProps extends DocumentHandle {\n  path: string\n}\n\ntype InsertPatch = Required<Pick<SanityPatchOperations, 'insert'>>\n\nconst ARRAYIFY_ERROR_MESSAGE =\n  'Unexpected path format from diffValue output. Please report this issue.'\n\nfunction* getSegments(\n  node: PathNode,\n): Generator<Exclude<SegmentNode, ThisNode>> {\n  if (node.base) yield* getSegments(node.base)\n  if (node.segment.type !== 'This') yield node.segment\n}\n\nfunction isKeyPath(node: ExprNode): node is PathNode {\n  if (node.type !== 'Path') return false\n  if (node.base) return false\n  if (node.recursive) return false\n  if (node.segment.type !== 'Identifier') return false\n  return node.segment.name === '_key'\n}\n\nfunction arrayifyPath(pathExpr: string): Path {\n  const node = parsePath(pathExpr)\n  if (!node) return []\n  if (node.type !== 'Path') throw new Error(ARRAYIFY_ERROR_MESSAGE)\n\n  return Array.from(getSegments(node)).map((segment): PathSegment => {\n    if (segment.type === 'Identifier') return segment.name\n    if (segment.type !== 'Subscript') throw new Error(ARRAYIFY_ERROR_MESSAGE)\n    if (segment.elements.length !== 1) throw new Error(ARRAYIFY_ERROR_MESSAGE)\n\n    const [element] = segment.elements\n    if (element.type === 'Number') return element.value\n\n    if (element.type !== 'Comparison') throw new Error(ARRAYIFY_ERROR_MESSAGE)\n    if (element.operator !== '==') throw new Error(ARRAYIFY_ERROR_MESSAGE)\n    const keyPathNode = [element.left, element.right].find(isKeyPath)\n    if (!keyPathNode) throw new Error(ARRAYIFY_ERROR_MESSAGE)\n    const other = element.left === keyPathNode ? element.right : element.left\n    if (other.type !== 'String') throw new Error(ARRAYIFY_ERROR_MESSAGE)\n    return {_key: other.value}\n  })\n}\n\nfunction convertPatches(patches: SanityPatchOperations[]): PtePatch[] {\n  return patches.flatMap((p) => {\n    return Object.entries(p).flatMap(([type, values]): PtePatch[] => {\n      const origin = 'remote'\n\n      switch (type) {\n        case 'set':\n        case 'setIfMissing':\n        case 'diffMatchPatch':\n        case 'inc':\n        case 'dec': {\n          return Object.entries(values).map(\n            ([pathExpr, value]) =>\n              ({type, value, origin, path: arrayifyPath(pathExpr)}) as PtePatch,\n          )\n        }\n        case 'unset': {\n          if (!Array.isArray(values)) return []\n          return values.map(arrayifyPath).map((path) => ({type, origin, path}))\n        }\n        case 'insert': {\n          const {items, ...rest} = values as InsertPatch['insert']\n          type InsertPosition = PteInsertPatch['position']\n          const position = Object.keys(rest).at(0) as InsertPosition | undefined\n\n          if (!position) return []\n          const pathExpr = (rest as {[K in InsertPosition]: string})[position]\n          const insertPatch: PteInsertPatch = {\n            type,\n            origin,\n            position,\n            path: arrayifyPath(pathExpr),\n            items: items as JSONValue[],\n          }\n\n          return [insertPatch]\n        }\n\n        default: {\n          return []\n        }\n      }\n    })\n  })\n}\n/**\n * @public\n */\nexport function SDKValuePlugin(props: SDKValuePluginProps) {\n  // NOTE: the real `useEditDocument` suspends until the document is loaded into the SDK store\n  const setSdkValue = useEditDocument(props)\n  const instance = useSanityInstance(props)\n  const editor = useEditor()\n\n  useEffect(() => {\n    const getEditorValue = () => editor.getSnapshot().context.value\n    const {getCurrent: getSdkValue, subscribe: onSdkValueChange} =\n      getDocumentState<PortableTextBlock[]>(instance, props)\n\n    const editorSubscription = editor.on('patch', () =>\n      setSdkValue(getEditorValue()),\n    )\n    const unsubscribeToEditorChanges = () => editorSubscription.unsubscribe()\n    const unsubscribeToSdkChanges = onSdkValueChange(() => {\n      const snapshot = getEditorValue()\n      const patches = convertPatches(diffValue(snapshot, getSdkValue()))\n\n      if (patches.length) {\n        editor.send({type: 'patches', patches, snapshot})\n      }\n    })\n\n    // update initial value\n    editor.send({type: 'update value', value: getSdkValue() ?? []})\n\n    return () => {\n      unsubscribeToEditorChanges()\n      unsubscribeToSdkChanges()\n    }\n  }, [setSdkValue, editor, instance, props])\n\n  return null\n}\n"],"names":["ARRAYIFY_ERROR_MESSAGE","getSegments","node","base","segment","type","isKeyPath","recursive","name","arrayifyPath","pathExpr","parsePath","Error","Array","from","map","elements","length","element","value","operator","keyPathNode","left","right","find","other","_key","convertPatches","patches","flatMap","p","Object","entries","values","origin","path","isArray","items","rest","position","keys","at","SDKValuePlugin","props","$","_c","setSdkValue","useEditDocument","instance","useSanityInstance","editor","useEditor","t0","t1","getEditorValue","getSnapshot","context","getCurrent","getSdkValue","subscribe","onSdkValueChange","getDocumentState","editorSubscription","on","unsubscribeToEditorChanges","unsubscribe","unsubscribeToSdkChanges","snapshot","diffValue","send","useEffect"],"mappings":";;;AAiCA,MAAMA,yBACJ;AAEF,UAAUC,YACRC,MAC2C;AACvCA,OAAKC,SAAM,OAAOF,YAAYC,KAAKC,IAAI,IACvCD,KAAKE,QAAQC,SAAS,WAAQ,MAAMH,KAAKE;AAC/C;AAEA,SAASE,UAAUJ,MAAkC;AAInD,SAHIA,KAAKG,SAAS,UACdH,KAAKC,QACLD,KAAKK,aACLL,KAAKE,QAAQC,SAAS,eAAqB,KACxCH,KAAKE,QAAQI,SAAS;AAC/B;AAEA,SAASC,aAAaC,UAAwB;AACtCR,QAAAA,OAAOS,oBAAUD,QAAQ;AAC3B,MAAA,CAACR,KAAM,QAAO,CAAE;AACpB,MAAIA,KAAKG,SAAS,OAAc,OAAA,IAAIO,MAAMZ,sBAAsB;AAEhE,SAAOa,MAAMC,KAAKb,YAAYC,IAAI,CAAC,EAAEa,IAAKX,CAAyB,YAAA;AACjE,QAAIA,QAAQC,SAAS,aAAc,QAAOD,QAAQI;AAClD,QAAIJ,QAAQC,SAAS,YAAmB,OAAA,IAAIO,MAAMZ,sBAAsB;AACxE,QAAII,QAAQY,SAASC,WAAW,EAAS,OAAA,IAAIL,MAAMZ,sBAAsB;AAEnE,UAAA,CAACkB,OAAO,IAAId,QAAQY;AAC1B,QAAIE,QAAQb,SAAS,SAAU,QAAOa,QAAQC;AAE9C,QAAID,QAAQb,SAAS,aAAoB,OAAA,IAAIO,MAAMZ,sBAAsB;AACzE,QAAIkB,QAAQE,aAAa,KAAY,OAAA,IAAIR,MAAMZ,sBAAsB;AAC/DqB,UAAAA,cAAc,CAACH,QAAQI,MAAMJ,QAAQK,KAAK,EAAEC,KAAKlB,SAAS;AAChE,QAAI,CAACe,YAAmB,OAAA,IAAIT,MAAMZ,sBAAsB;AACxD,UAAMyB,QAAQP,QAAQI,SAASD,cAAcH,QAAQK,QAAQL,QAAQI;AACrE,QAAIG,MAAMpB,SAAS,SAAgB,OAAA,IAAIO,MAAMZ,sBAAsB;AAC5D,WAAA;AAAA,MAAC0B,MAAMD,MAAMN;AAAAA,IAAK;AAAA,EAAA,CAC1B;AACH;AAEA,SAASQ,eAAeC,SAA8C;AACpE,SAAOA,QAAQC,QAASC,CACfC,MAAAA,OAAOC,QAAQF,CAAC,EAAED,QAAQ,CAAC,CAACxB,MAAM4B,MAAM,MAAkB;AAC/D,UAAMC,SAAS;AAEf,YAAQ7B,MAAI;AAAA,MACV,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AACI0B,eAAAA,OAAOC,QAAQC,MAAM,EAAElB,IAC5B,CAAC,CAACL,UAAUS,KAAK,OACd;AAAA,UAACd;AAAAA,UAAMc;AAAAA,UAAOe;AAAAA,UAAQC,MAAM1B,aAAaC,QAAQ;AAAA,QAAA,EACtD;AAAA,MAEF,KAAK;AACEG,eAAAA,MAAMuB,QAAQH,MAAM,IAClBA,OAAOlB,IAAIN,YAAY,EAAEM,IAAKoB,CAAU,UAAA;AAAA,UAAC9B;AAAAA,UAAM6B;AAAAA,UAAQC;AAAAA,QAAI,EAAE,IADjC,CAAE;AAAA,MAGvC,KAAK,UAAU;AACP,cAAA;AAAA,UAACE;AAAAA,UAAO,GAAGC;AAAAA,QAAAA,IAAQL,QAEnBM,WAAWR,OAAOS,KAAKF,IAAI,EAAEG,GAAG,CAAC;AAEnC,YAAA,CAACF,SAAU,QAAO,CAAE;AAClB7B,cAAAA,WAAY4B,KAAyCC,QAAQ;AASnE,eAAO,CAR6B;AAAA,UAClClC;AAAAA,UACA6B;AAAAA,UACAK;AAAAA,UACAJ,MAAM1B,aAAaC,QAAQ;AAAA,UAC3B2B;AAAAA,QAAAA,CAGiB;AAAA,MAAA;AAAA,MAGrB;AACE,eAAO,CAAE;AAAA,IAAA;AAAA,EAEb,CACD,CACF;AACH;AAIO,SAAAK,eAAAC,OAAA;AAAA,QAAAC,IAAAC,gBAAAA,EAAA,CAAA,GAELC,cAAoBC,SAAAA,gBAAgBJ,KAAK,GACzCK,WAAiBC,SAAAA,kBAAkBN,KAAK,GACxCO,WAAeC,OAAAA,UAAU;AAAC,MAAAC,IAAAC;AAAA,SAAAT,EAAA,CAAA,MAAAM,YAAAN,EAAAI,CAAAA,MAAAA,YAAAJ,EAAAD,CAAAA,MAAAA,SAAAC,SAAAE,eAEhBM,KAAAA,MAAA;AACR,UAAAE,iBAAAA,MAA6BJ,SAAMK,YAAa,EAACC,QAAArC,OACjD;AAAA,MAAAsC,YAAAC;AAAAA,MAAAC,WAAAC;AAAAA,IAAAA,IACEC,0BAAsCb,UAAUL,KAAK,GAEvDmB,qBAA2BZ,SAAMa,GAAI,SACnCjB,MAAAA,YAAYQ,gBAAgB,CAC9B,GACAU,6BAAAA,MAAyCF,mBAAkBG,eAC3DC,0BAAgCN,iBAAgB,MAAA;AAC9CO,YAAAA,WAAiBb,kBACjB1B,UAAgBD,eAAeyC,oBAAUD,UAAUT,YAAY,CAAC,CAAC;AAE7D9B,cAAOX,UACTiC,SAAMmB,KAAA;AAAA,QAAAhE,MAAa;AAAA,QAASuB;AAAAA,QAAAuC;AAAAA,MAAAA,CAAoB;AAAA,IAAA,CAEnD;AAGDjB,WAAAA,SAAMmB,KAAA;AAAA,MAAAhE,MAAa;AAAA,MAAcc,OAASuC,YAAY,KAAC,CAAA;AAAA,IAAO,CAAA,GAAC,MAAA;AAG7DM,iCAAAA,GACAE,wBAAwB;AAAA,IAAC;AAAA,EAAA,GAE1Bb,MAACP,aAAaI,UAAQF,UAAUL,KAAK,GAACC,OAAAM,UAAAN,OAAAI,UAAAJ,OAAAD,OAAAC,OAAAE,aAAAF,OAAAQ,IAAAR,OAAAS,OAAAD,KAAAR,EAAA,CAAA,GAAAS,KAAAT,EAAA,CAAA,IAzBzC0B,gBAAUlB,IAyBPC,EAAsC,GAAC;AAAA;;"}

package/dist/index.d.cts

@@ -0,0 +1,12 @@
+import {DocumentHandle} from '@sanity/sdk-react'
+
+/**
+ * @public
+ */
+export declare function SDKValuePlugin(props: SDKValuePluginProps): null
+
+declare interface SDKValuePluginProps extends DocumentHandle {
+  path: string
+}
+
+export {}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import {DocumentHandle} from '@sanity/sdk-react'
+
+/**
+ * @public
+ */
+export declare function SDKValuePlugin(props: SDKValuePluginProps): null
+
+declare interface SDKValuePluginProps extends DocumentHandle {
+  path: string
+}
+
+export {}

package/dist/index.js

@@ -0,0 +1,102 @@
+import { c } from "react/compiler-runtime";
+import { useEditor } from "@portabletext/editor";
+import { diffValue } from "@sanity/diff-patch";
+import { parsePath } from "@sanity/json-match";
+import { useEditDocument, useSanityInstance, getDocumentState } from "@sanity/sdk-react";
+import { useEffect } from "react";
+const ARRAYIFY_ERROR_MESSAGE = "Unexpected path format from diffValue output. Please report this issue.";
+function* getSegments(node) {
+  node.base && (yield* getSegments(node.base)), node.segment.type !== "This" && (yield node.segment);
+}
+function isKeyPath(node) {
+  return node.type !== "Path" || node.base || node.recursive || node.segment.type !== "Identifier" ? !1 : node.segment.name === "_key";
+}
+function arrayifyPath(pathExpr) {
+  const node = parsePath(pathExpr);
+  if (!node) return [];
+  if (node.type !== "Path") throw new Error(ARRAYIFY_ERROR_MESSAGE);
+  return Array.from(getSegments(node)).map((segment) => {
+    if (segment.type === "Identifier") return segment.name;
+    if (segment.type !== "Subscript") throw new Error(ARRAYIFY_ERROR_MESSAGE);
+    if (segment.elements.length !== 1) throw new Error(ARRAYIFY_ERROR_MESSAGE);
+    const [element] = segment.elements;
+    if (element.type === "Number") return element.value;
+    if (element.type !== "Comparison") throw new Error(ARRAYIFY_ERROR_MESSAGE);
+    if (element.operator !== "==") throw new Error(ARRAYIFY_ERROR_MESSAGE);
+    const keyPathNode = [element.left, element.right].find(isKeyPath);
+    if (!keyPathNode) throw new Error(ARRAYIFY_ERROR_MESSAGE);
+    const other = element.left === keyPathNode ? element.right : element.left;
+    if (other.type !== "String") throw new Error(ARRAYIFY_ERROR_MESSAGE);
+    return {
+      _key: other.value
+    };
+  });
+}
+function convertPatches(patches) {
+  return patches.flatMap((p) => Object.entries(p).flatMap(([type, values]) => {
+    const origin = "remote";
+    switch (type) {
+      case "set":
+      case "setIfMissing":
+      case "diffMatchPatch":
+      case "inc":
+      case "dec":
+        return Object.entries(values).map(([pathExpr, value]) => ({
+          type,
+          value,
+          origin,
+          path: arrayifyPath(pathExpr)
+        }));
+      case "unset":
+        return Array.isArray(values) ? values.map(arrayifyPath).map((path) => ({
+          type,
+          origin,
+          path
+        })) : [];
+      case "insert": {
+        const {
+          items,
+          ...rest
+        } = values, position = Object.keys(rest).at(0);
+        if (!position) return [];
+        const pathExpr = rest[position];
+        return [{
+          type,
+          origin,
+          position,
+          path: arrayifyPath(pathExpr),
+          items
+        }];
+      }
+      default:
+        return [];
+    }
+  }));
+}
+function SDKValuePlugin(props) {
+  const $ = c(6), setSdkValue = useEditDocument(props), instance = useSanityInstance(props), editor = useEditor();
+  let t0, t1;
+  return $[0] !== editor || $[1] !== instance || $[2] !== props || $[3] !== setSdkValue ? (t0 = () => {
+    const getEditorValue = () => editor.getSnapshot().context.value, {
+      getCurrent: getSdkValue,
+      subscribe: onSdkValueChange
+    } = getDocumentState(instance, props), editorSubscription = editor.on("patch", () => setSdkValue(getEditorValue())), unsubscribeToEditorChanges = () => editorSubscription.unsubscribe(), unsubscribeToSdkChanges = onSdkValueChange(() => {
+      const snapshot = getEditorValue(), patches = convertPatches(diffValue(snapshot, getSdkValue()));
+      patches.length && editor.send({
+        type: "patches",
+        patches,
+        snapshot
+      });
+    });
+    return editor.send({
+      type: "update value",
+      value: getSdkValue() ?? []
+    }), () => {
+      unsubscribeToEditorChanges(), unsubscribeToSdkChanges();
+    };
+  }, t1 = [setSdkValue, editor, instance, props], $[0] = editor, $[1] = instance, $[2] = props, $[3] = setSdkValue, $[4] = t0, $[5] = t1) : (t0 = $[4], t1 = $[5]), useEffect(t0, t1), null;
+}
+export {
+  SDKValuePlugin
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/plugin.sdk-value.tsx"],"sourcesContent":["import {\n  useEditor,\n  type PortableTextBlock,\n  type Patch as PtePatch,\n} from '@portabletext/editor'\nimport type {\n  JSONValue,\n  Path,\n  PathSegment,\n  InsertPatch as PteInsertPatch,\n} from '@portabletext/patches'\nimport {diffValue, type SanityPatchOperations} from '@sanity/diff-patch'\nimport {\n  parsePath,\n  type ExprNode,\n  type PathNode,\n  type SegmentNode,\n  type ThisNode,\n} from '@sanity/json-match'\nimport {\n  getDocumentState,\n  useEditDocument,\n  useSanityInstance,\n  type DocumentHandle,\n} from '@sanity/sdk-react'\nimport {useEffect} from 'react'\n\ninterface SDKValuePluginProps extends DocumentHandle {\n  path: string\n}\n\ntype InsertPatch = Required<Pick<SanityPatchOperations, 'insert'>>\n\nconst ARRAYIFY_ERROR_MESSAGE =\n  'Unexpected path format from diffValue output. Please report this issue.'\n\nfunction* getSegments(\n  node: PathNode,\n): Generator<Exclude<SegmentNode, ThisNode>> {\n  if (node.base) yield* getSegments(node.base)\n  if (node.segment.type !== 'This') yield node.segment\n}\n\nfunction isKeyPath(node: ExprNode): node is PathNode {\n  if (node.type !== 'Path') return false\n  if (node.base) return false\n  if (node.recursive) return false\n  if (node.segment.type !== 'Identifier') return false\n  return node.segment.name === '_key'\n}\n\nfunction arrayifyPath(pathExpr: string): Path {\n  const node = parsePath(pathExpr)\n  if (!node) return []\n  if (node.type !== 'Path') throw new Error(ARRAYIFY_ERROR_MESSAGE)\n\n  return Array.from(getSegments(node)).map((segment): PathSegment => {\n    if (segment.type === 'Identifier') return segment.name\n    if (segment.type !== 'Subscript') throw new Error(ARRAYIFY_ERROR_MESSAGE)\n    if (segment.elements.length !== 1) throw new Error(ARRAYIFY_ERROR_MESSAGE)\n\n    const [element] = segment.elements\n    if (element.type === 'Number') return element.value\n\n    if (element.type !== 'Comparison') throw new Error(ARRAYIFY_ERROR_MESSAGE)\n    if (element.operator !== '==') throw new Error(ARRAYIFY_ERROR_MESSAGE)\n    const keyPathNode = [element.left, element.right].find(isKeyPath)\n    if (!keyPathNode) throw new Error(ARRAYIFY_ERROR_MESSAGE)\n    const other = element.left === keyPathNode ? element.right : element.left\n    if (other.type !== 'String') throw new Error(ARRAYIFY_ERROR_MESSAGE)\n    return {_key: other.value}\n  })\n}\n\nfunction convertPatches(patches: SanityPatchOperations[]): PtePatch[] {\n  return patches.flatMap((p) => {\n    return Object.entries(p).flatMap(([type, values]): PtePatch[] => {\n      const origin = 'remote'\n\n      switch (type) {\n        case 'set':\n        case 'setIfMissing':\n        case 'diffMatchPatch':\n        case 'inc':\n        case 'dec': {\n          return Object.entries(values).map(\n            ([pathExpr, value]) =>\n              ({type, value, origin, path: arrayifyPath(pathExpr)}) as PtePatch,\n          )\n        }\n        case 'unset': {\n          if (!Array.isArray(values)) return []\n          return values.map(arrayifyPath).map((path) => ({type, origin, path}))\n        }\n        case 'insert': {\n          const {items, ...rest} = values as InsertPatch['insert']\n          type InsertPosition = PteInsertPatch['position']\n          const position = Object.keys(rest).at(0) as InsertPosition | undefined\n\n          if (!position) return []\n          const pathExpr = (rest as {[K in InsertPosition]: string})[position]\n          const insertPatch: PteInsertPatch = {\n            type,\n            origin,\n            position,\n            path: arrayifyPath(pathExpr),\n            items: items as JSONValue[],\n          }\n\n          return [insertPatch]\n        }\n\n        default: {\n          return []\n        }\n      }\n    })\n  })\n}\n/**\n * @public\n */\nexport function SDKValuePlugin(props: SDKValuePluginProps) {\n  // NOTE: the real `useEditDocument` suspends until the document is loaded into the SDK store\n  const setSdkValue = useEditDocument(props)\n  const instance = useSanityInstance(props)\n  const editor = useEditor()\n\n  useEffect(() => {\n    const getEditorValue = () => editor.getSnapshot().context.value\n    const {getCurrent: getSdkValue, subscribe: onSdkValueChange} =\n      getDocumentState<PortableTextBlock[]>(instance, props)\n\n    const editorSubscription = editor.on('patch', () =>\n      setSdkValue(getEditorValue()),\n    )\n    const unsubscribeToEditorChanges = () => editorSubscription.unsubscribe()\n    const unsubscribeToSdkChanges = onSdkValueChange(() => {\n      const snapshot = getEditorValue()\n      const patches = convertPatches(diffValue(snapshot, getSdkValue()))\n\n      if (patches.length) {\n        editor.send({type: 'patches', patches, snapshot})\n      }\n    })\n\n    // update initial value\n    editor.send({type: 'update value', value: getSdkValue() ?? []})\n\n    return () => {\n      unsubscribeToEditorChanges()\n      unsubscribeToSdkChanges()\n    }\n  }, [setSdkValue, editor, instance, props])\n\n  return null\n}\n"],"names":["ARRAYIFY_ERROR_MESSAGE","getSegments","node","base","segment","type","isKeyPath","recursive","name","arrayifyPath","pathExpr","parsePath","Error","Array","from","map","elements","length","element","value","operator","keyPathNode","left","right","find","other","_key","convertPatches","patches","flatMap","p","Object","entries","values","origin","path","isArray","items","rest","position","keys","at","SDKValuePlugin","props","$","_c","setSdkValue","useEditDocument","instance","useSanityInstance","editor","useEditor","t0","t1","getEditorValue","getSnapshot","context","getCurrent","getSdkValue","subscribe","onSdkValueChange","getDocumentState","editorSubscription","on","unsubscribeToEditorChanges","unsubscribe","unsubscribeToSdkChanges","snapshot","diffValue","send","useEffect"],"mappings":"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"}

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "@portabletext/plugin-sdk-value",
+  "version": "1.0.0",
+  "description": "Synchronizes the Portable Text Editor value with the Sanity SDK, allowing for two-way editing.",
+  "keywords": [
+    "portabletext",
+    "plugin",
+    "sdk",
+    "sync",
+    "value",
+    "@sanity/sdk",
+    "@sanity/sdk-react"
+  ],
+  "homepage": "https://portabletext.org",
+  "bugs": {
+    "url": "https://github.com/portabletext/plugins/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/portabletext/plugins.git",
+    "directory": "plugins/sdk-value"
+  },
+  "license": "MIT",
+  "author": "Sanity.io <hello@sanity.io>",
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "src",
+    "dist"
+  ],
+  "devDependencies": {
+    "@portabletext/editor": "^1.55.12",
+    "@portabletext/patches": "^1.1.0",
+    "@sanity/schema": "^3.96.0",
+    "@sanity/sdk-react": "^2.1.0",
+    "@sanity/types": "^3.96.0",
+    "@testing-library/react": "^16.3.0",
+    "@testing-library/user-event": "^14.6.1",
+    "@types/react": "^19.1.2",
+    "@vitejs/plugin-react": "^4.4.1",
+    "babel-plugin-react-compiler": "19.0.0-beta-e993439-20250328",
+    "playwright": "^1.52.0",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "react-error-boundary": "^6.0.0"
+  },
+  "peerDependencies": {
+    "@portabletext/editor": "^1.55.12",
+    "@sanity/sdk-react": "^2.1.0",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0"
+  },
+  "dependencies": {
+    "@sanity/diff-patch": "^6.0.0",
+    "@sanity/json-match": "^1.0.5",
+    "react-compiler-runtime": "19.1.0-rc.1"
+  },
+  "scripts": {
+    "build": "pkg-utils build --strict --check --clean",
+    "check:lint": "biome lint .",
+    "check:react-compiler": "eslint --cache --no-inline-config --no-eslintrc --ignore-pattern '**/__tests__/**' --ext .cjs,.mjs,.js,.jsx,.ts,.tsx --parser @typescript-eslint/parser --plugin react-compiler --plugin react-hooks --rule 'react-compiler/react-compiler: [warn]' --rule 'react-hooks/rules-of-hooks: [error]' --rule 'react-hooks/exhaustive-deps: [error]' src",
+    "check:types": "tsc",
+    "check:types:watch": "tsc --watch",
+    "clean": "del .turbo && del dist && del node_modules",
+    "dev": "pkg-utils watch",
+    "lint:fix": "biome lint --write .",
+    "test": "vitest --run"
+  }
+}

package/src/index.ts

@@ -0,0 +1 @@
+export * from './plugin.sdk-value'

package/src/plugin.sdk-value.test.tsx

@@ -0,0 +1,183 @@
+import {
+  defineSchema,
+  EditorProvider,
+  PortableTextEditable,
+  useEditor,
+  type Editor,
+  type PortableTextBlock,
+} from '@portabletext/editor'
+import {
+  createDocumentHandle,
+  getDocumentState,
+  ResourceProvider,
+  useEditDocument,
+  type ResourceProviderProps,
+  type SanityConfig,
+  type SanityInstance,
+  type StateSource,
+} from '@sanity/sdk-react'
+import {render, waitFor} from '@testing-library/react'
+import userEvent, {type UserEvent} from '@testing-library/user-event'
+import {useEffect} from 'react'
+import {ErrorBoundary} from 'react-error-boundary'
+import {
+  afterEach,
+  beforeEach,
+  describe,
+  expect,
+  it,
+  vi,
+  type Mock,
+} from 'vitest'
+import {SDKValuePlugin} from './plugin.sdk-value'
+
+vi.mock('@sanity/sdk-react', async () => {
+  const {createContext, createRef, Suspense, useContext} = await import('react')
+  const Context = createContext<SanityConfig | null>(null)
+  const eventTarget = new EventTarget()
+  const valueRef = createRef<PortableTextBlock[]>()
+
+  return {
+    createDocumentHandle: (value: unknown) => value,
+    useEditDocument: () => {
+      if (!valueRef.current) {
+        // suspend at least once
+        throw new Promise((resolve) => {
+          valueRef.current = []
+          setTimeout(resolve, 0)
+        })
+      }
+
+      return (value: PortableTextBlock[]) => {
+        valueRef.current = value
+        eventTarget.dispatchEvent(new CustomEvent('change'))
+      }
+    },
+    getDocumentState: (): StateSource<PortableTextBlock[] | null> => {
+      return {
+        getCurrent: () => valueRef.current,
+        subscribe: (fn) => {
+          const listener = () => fn?.()
+          eventTarget.addEventListener('change', listener)
+          return () => eventTarget.removeEventListener('change', listener)
+        },
+        get observable(): StateSource<
+          PortableTextBlock[] | null
+        >['observable'] {
+          throw new Error('Not implemented')
+        },
+      }
+    },
+    useSanityInstance: () => useContext(Context)!,
+    ResourceProvider: ({
+      children,
+      fallback,
+      ...config
+    }: ResourceProviderProps) => (
+      <Suspense fallback={fallback}>
+        <Context.Provider value={config}>{children}</Context.Provider>
+      </Suspense>
+    ),
+  }
+})
+
+const schemaDefinition = defineSchema({})
+
+describe(SDKValuePlugin.name, () => {
+  let user: UserEvent
+  let setSdkValue: (value: PortableTextBlock[] | null | undefined) => void
+  let getSdkValue: () => PortableTextBlock[] | null | undefined
+  let getEditorValue: () => PortableTextBlock[] | null | undefined
+  let portableTextEditable: HTMLElement
+  let unmount: () => void
+  let errorHandler: Mock
+
+  beforeEach(async () => {
+    user = userEvent.setup()
+    errorHandler = vi.fn()
+
+    const testId = 'portable-text-editable'
+    const {resolve: resolveEditor, promise: editorPromise} =
+      Promise.withResolvers<Editor>()
+
+    const doc = createDocumentHandle({
+      documentId: 'example-document-id',
+      documentType: 'example-document-type',
+    })
+    const path = 'example-portable-text-field'
+
+    function CaptureEditorPlugin() {
+      const editor = useEditor()
+
+      useEffect(() => {
+        resolveEditor(editor)
+      }, [editor])
+
+      return null
+    }
+
+    const result = render(
+      <ErrorBoundary fallback={null} onError={errorHandler}>
+        <ResourceProvider
+          projectId="example-project"
+          dataset="example-dataset"
+          fallback={<>Loading…</>}
+        >
+          <EditorProvider initialConfig={{schemaDefinition}}>
+            <SDKValuePlugin {...doc} path={path} />
+            <CaptureEditorPlugin />
+            <PortableTextEditable data-testid={testId} />
+          </EditorProvider>
+        </ResourceProvider>
+      </ErrorBoundary>,
+    )
+    portableTextEditable = await waitFor(() => result.getByTestId(testId))
+    unmount = result.unmount
+
+    const editor = await editorPromise
+    setSdkValue = useEditDocument<PortableTextBlock[] | null | undefined>({
+      ...doc,
+      path,
+    })
+
+    getSdkValue = getDocumentState(null as unknown as SanityInstance, {
+      ...doc,
+      path,
+    }).getCurrent
+
+    getEditorValue = () => editor.getSnapshot().context.value
+  })
+
+  afterEach(async () => {
+    // wait one frame before unmounting in the event of errors
+    await new Promise((resolve) => setTimeout(resolve, 0))
+    expect(errorHandler).not.toHaveBeenCalled()
+    unmount?.()
+  })
+
+  it('syncs editor changes to the SDK', async () => {
+    await user.click(portableTextEditable)
+    await user.type(portableTextEditable, 'Hello world!')
+
+    expect(getSdkValue()).toEqual(getEditorValue())
+    expect(getSdkValue()).toMatchObject([{children: [{text: 'Hello world!'}]}])
+  })
+
+  it('syncs SDK changes to the editor', () => {
+    const testValue: PortableTextBlock[] = [
+      {
+        _type: 'block',
+        _key: 'test-key',
+        children: [
+          {_type: 'span', _key: 'span-key', text: 'SDK content', marks: []},
+        ],
+        markDefs: [],
+        style: 'normal',
+      },
+    ]
+
+    setSdkValue(testValue)
+    expect(getEditorValue()).toEqual(getSdkValue())
+    expect(getEditorValue()).toEqual(testValue)
+  })
+})

package/src/plugin.sdk-value.tsx

@@ -0,0 +1,157 @@
+import {
+  useEditor,
+  type PortableTextBlock,
+  type Patch as PtePatch,
+} from '@portabletext/editor'
+import type {
+  JSONValue,
+  Path,
+  PathSegment,
+  InsertPatch as PteInsertPatch,
+} from '@portabletext/patches'
+import {diffValue, type SanityPatchOperations} from '@sanity/diff-patch'
+import {
+  parsePath,
+  type ExprNode,
+  type PathNode,
+  type SegmentNode,
+  type ThisNode,
+} from '@sanity/json-match'
+import {
+  getDocumentState,
+  useEditDocument,
+  useSanityInstance,
+  type DocumentHandle,
+} from '@sanity/sdk-react'
+import {useEffect} from 'react'
+
+interface SDKValuePluginProps extends DocumentHandle {
+  path: string
+}
+
+type InsertPatch = Required<Pick<SanityPatchOperations, 'insert'>>
+
+const ARRAYIFY_ERROR_MESSAGE =
+  'Unexpected path format from diffValue output. Please report this issue.'
+
+function* getSegments(
+  node: PathNode,
+): Generator<Exclude<SegmentNode, ThisNode>> {
+  if (node.base) yield* getSegments(node.base)
+  if (node.segment.type !== 'This') yield node.segment
+}
+
+function isKeyPath(node: ExprNode): node is PathNode {
+  if (node.type !== 'Path') return false
+  if (node.base) return false
+  if (node.recursive) return false
+  if (node.segment.type !== 'Identifier') return false
+  return node.segment.name === '_key'
+}
+
+function arrayifyPath(pathExpr: string): Path {
+  const node = parsePath(pathExpr)
+  if (!node) return []
+  if (node.type !== 'Path') throw new Error(ARRAYIFY_ERROR_MESSAGE)
+
+  return Array.from(getSegments(node)).map((segment): PathSegment => {
+    if (segment.type === 'Identifier') return segment.name
+    if (segment.type !== 'Subscript') throw new Error(ARRAYIFY_ERROR_MESSAGE)
+    if (segment.elements.length !== 1) throw new Error(ARRAYIFY_ERROR_MESSAGE)
+
+    const [element] = segment.elements
+    if (element.type === 'Number') return element.value
+
+    if (element.type !== 'Comparison') throw new Error(ARRAYIFY_ERROR_MESSAGE)
+    if (element.operator !== '==') throw new Error(ARRAYIFY_ERROR_MESSAGE)
+    const keyPathNode = [element.left, element.right].find(isKeyPath)
+    if (!keyPathNode) throw new Error(ARRAYIFY_ERROR_MESSAGE)
+    const other = element.left === keyPathNode ? element.right : element.left
+    if (other.type !== 'String') throw new Error(ARRAYIFY_ERROR_MESSAGE)
+    return {_key: other.value}
+  })
+}
+
+function convertPatches(patches: SanityPatchOperations[]): PtePatch[] {
+  return patches.flatMap((p) => {
+    return Object.entries(p).flatMap(([type, values]): PtePatch[] => {
+      const origin = 'remote'
+
+      switch (type) {
+        case 'set':
+        case 'setIfMissing':
+        case 'diffMatchPatch':
+        case 'inc':
+        case 'dec': {
+          return Object.entries(values).map(
+            ([pathExpr, value]) =>
+              ({type, value, origin, path: arrayifyPath(pathExpr)}) as PtePatch,
+          )
+        }
+        case 'unset': {
+          if (!Array.isArray(values)) return []
+          return values.map(arrayifyPath).map((path) => ({type, origin, path}))
+        }
+        case 'insert': {
+          const {items, ...rest} = values as InsertPatch['insert']
+          type InsertPosition = PteInsertPatch['position']
+          const position = Object.keys(rest).at(0) as InsertPosition | undefined
+
+          if (!position) return []
+          const pathExpr = (rest as {[K in InsertPosition]: string})[position]
+          const insertPatch: PteInsertPatch = {
+            type,
+            origin,
+            position,
+            path: arrayifyPath(pathExpr),
+            items: items as JSONValue[],
+          }
+
+          return [insertPatch]
+        }
+
+        default: {
+          return []
+        }
+      }
+    })
+  })
+}
+/**
+ * @public
+ */
+export function SDKValuePlugin(props: SDKValuePluginProps) {
+  // NOTE: the real `useEditDocument` suspends until the document is loaded into the SDK store
+  const setSdkValue = useEditDocument(props)
+  const instance = useSanityInstance(props)
+  const editor = useEditor()
+
+  useEffect(() => {
+    const getEditorValue = () => editor.getSnapshot().context.value
+    const {getCurrent: getSdkValue, subscribe: onSdkValueChange} =
+      getDocumentState<PortableTextBlock[]>(instance, props)
+
+    const editorSubscription = editor.on('patch', () =>
+      setSdkValue(getEditorValue()),
+    )
+    const unsubscribeToEditorChanges = () => editorSubscription.unsubscribe()
+    const unsubscribeToSdkChanges = onSdkValueChange(() => {
+      const snapshot = getEditorValue()
+      const patches = convertPatches(diffValue(snapshot, getSdkValue()))
+
+      if (patches.length) {
+        editor.send({type: 'patches', patches, snapshot})
+      }
+    })
+
+    // update initial value
+    editor.send({type: 'update value', value: getSdkValue() ?? []})
+
+    return () => {
+      unsubscribeToEditorChanges()
+      unsubscribeToSdkChanges()
+    }
+  }, [setSdkValue, editor, instance, props])
+
+  return null
+}