@ikijs/editor 0.16.0 → 0.16.1

package/dist/index.d.mts

@@ -73,11 +73,12 @@ declare class SetPartTransform extends FieldCommand<number | undefined> {
 }
 /**
  * Capture the warp deformer's grid as one keyform at the driving parameter
- * `value`, upserting `offsets` into `warps[0].keyforms`. The 4-tuple-style
+ * `value`, upserting `offsets` into the deformer's single grid warp. The 4-tuple-style
  * mutable `offsets` array is cloned on construction so a later caller mutation
  * cannot corrupt apply/redo (mirrors {@link SetPartColor}).
  *
- * `apply` validates BEFORE mutating: the deformer must have a grid warp, the
+ * `apply` validates BEFORE mutating: the deformer must have exactly one grid
+ * warp (several are refused — which driver to write into is ambiguous), the
  * offsets length must equal `grid.points.length`, and `value` must lie within
  * the driving parameter's declared `[min,max]` (fail fast, before
  * `parseIkiModel` would reject it). Prior keyforms are deep-copied once on the

package/dist/index.d.ts

@@ -73,11 +73,12 @@ declare class SetPartTransform extends FieldCommand<number | undefined> {
 }
 /**
  * Capture the warp deformer's grid as one keyform at the driving parameter
- * `value`, upserting `offsets` into `warps[0].keyforms`. The 4-tuple-style
+ * `value`, upserting `offsets` into the deformer's single grid warp. The 4-tuple-style
  * mutable `offsets` array is cloned on construction so a later caller mutation
  * cannot corrupt apply/redo (mirrors {@link SetPartColor}).
  *
- * `apply` validates BEFORE mutating: the deformer must have a grid warp, the
+ * `apply` validates BEFORE mutating: the deformer must have exactly one grid
+ * warp (several are refused — which driver to write into is ambiguous), the
  * offsets length must equal `grid.points.length`, and `value` must lie within
  * the driving parameter's declared `[min,max]` (fail fast, before
  * `parseIkiModel` would reject it). Prior keyforms are deep-copied once on the

package/dist/index.js

@@ -721,6 +721,12 @@ var CaptureGridKeyform = class {
   prevKeyforms;
   apply(doc) {
     const deformer = doc.findWarpDeformer(this.deformerId);
+    const count = deformer.warps?.length ?? 0;
+    if (count > 1) {
+      throw new Error(
+        `deformers."${this.deformerId}".warps: ${count} grid warps \u2014 capture targets a deformer with exactly one grid warp (which entry to write into is ambiguous)`
+      );
+    }
     const warp = deformer.warps?.[0];
     if (!warp) {
       throw new Error(