@docx-editor.dev/editor-api 2.1.2 → 2.2.0

package/dist/{server-C96AzKaT.d.ts → server-C3dcanDU.d.ts}

@@ -1571,6 +1571,11 @@ declare class ObjectPath {
      * Both refusals are `InvalidObjectPath` on purpose: from a consumer's side "this object was
      * released" and "this object is still a promise" are the same mistake — using an object the
      * runtime cannot address yet or any more — and the `target` says which object it was.
+     *
+     * THE CODE IS ONE THING AND THE MESSAGE IS ANOTHER. The two states have different fixes — a
+     * promise needs a `sync()`, a released object needs to have been tracked — so the sentence in
+     * `errors.ts` names both. It described only the released half for a while, which sent a
+     * consumer holding a perfectly good promised object off to `trackedObjects.add(...)`.
      */
     address(): ObjectAddress;
     /** The handle to address this object with. Refused for anything that is not handle-shaped. */
@@ -1715,7 +1720,14 @@ type DocxEditorErrorCode =
 'PropertyNotLoaded'
 /** A `ClientResult` value was read before the sync that fills it. */
  | 'ValueNotLoaded'
-/** The object is no longer addressable: its run ended and it was not tracked. */
+/**
+ * The object cannot be addressed, in either of the two ways that happens.
+ *
+ * NOT YET: an item accessor answers a proxy the read that names it has not answered for, and it
+ * becomes usable at the next `sync()`. NOT ANY MORE: its run ended and nothing tracked it, which
+ * is terminal. One code because from a consumer's side both are "this object cannot be used
+ * here"; the message says which one, because the fix for one is not the fix for the other.
+ */
  | 'InvalidObjectPath'
 /** The object still belongs to a run that has not finished, so it cannot be handed over. */
  | 'ObjectInUse'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docx-editor.dev/editor-api",
-  "version": "2.1.2",
+  "version": "2.2.0",
   "description": "Document automation for DOCX: a batching object model that drives a document from a server or from an editor already open in a page",
   "sideEffects": false,
   "main": "./dist/index.js",
@@ -73,6 +73,6 @@
     "access": "public"
   },
   "dependencies": {
-    "@docx-editor.dev/core": "^2.1.2"
+    "@docx-editor.dev/core": "^2.2.0"
   }
 }