@vormio/plugin-sdk 0.0.9-rc.1 → 0.0.9

package/README.md

@@ -222,6 +222,7 @@ When a format looks an object up by name in another file, report the object itse
 
 - A key that other files refer to is a contract within your plugin: derive it from the format's own lookup rule (for Spine, the region name), so that it stays the same when the target file is exported again. Never use a position in a list.
 - The host connects the two reports only when the same build of your plugin analyzed both files (same plugin ID and package). Your analyzers for both formats must be in one plugin.
+- A build is identified by the package digest: a SHA-256 over every file's path and content, the `digest` that `vormio-plugin pack` prints. A development folder gets the digest of its files, the same as the package made from them, so any change to any file there, a viewer or thumbnail file included, is a new build. After a new build the host analyzes all your files again; while one end of a reference has been analyzed by the new build and the other not yet, the reference is unknown, with that reason, and it resolves again once both are done.
 - Do not read the target file to check that the subresource exists. The host decides at query time, from the target's current report, and the status follows when the target is analyzed again:
 
 | The target file                                                                   | Written reference           | Inferred reference       |
@@ -246,6 +247,7 @@ viewer(showAtlas, {
 
 - The key is from your own analyzer's report: the host asks only when the viewer and the shown file's analysis come from the same build of your plugin.
 - `focus` is called only after the viewer reported the file ready. A request about a file the viewer has moved away from is dropped. The same key can come again when the user asks again; show it again.
+- Every input the viewer is given has a new `url`, also when it is a new version of the same file, and the old address stops working. `viewer()` drops a request whose `url` is not the input currently shown, so a request about an older version never lands on new content.
 - Find it if you can, for example by selecting, framing or highlighting it; ignore keys you cannot find. The host does not wait for an answer.
 - Pages that do not use `viewer()` subscribe with `window.vormio.onFocus(({ url, key }) => …)` and compare `url` with the input they show.
 

package/package.json

@@ -1,8 +1,13 @@
 {
   "name": "@vormio/plugin-sdk",
-  "version": "0.0.9-rc.1",
+  "version": "0.0.9",
   "description": "Manifest schema, runtime helpers and packaging for Vormio plugins.",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Vormio/Vormio-Core.git",
+    "directory": "packages/plugin-sdk"
+  },
   "keywords": [
     "vormio",
     "plugin",